WebMO Help - Upgrading WebMO

General Comments

Upgrading vs. Installing: These instructions are to be used for upgrading an existing WebMO instance. To install a copy of WebMO for the first time, refer instead to the WebMO installation instructions for Linux, OS X, or Windows.

Remote Servers: If you are upgrading WebMO Pro/Enterprise and have configured any remote servers, these remote servers must also be upgraded:

Currently Running Jobs: WebMO must not be running any jobs during the upgrade process, since the scripts running those jobs will be overwritten with newer scripts. If the WebMO instance is being actively used, also follow the following procedures:

Prior to the upgrade:

And after the upgrade:

Linux / Unix

  1. Locate your WebMO license number and globals.int file. Login to WebMO as admin and click Version Manager. Note:
    • the WebMO license number
    • the full path of the WebMO globals.int file
    These are necessary to download the WebMO update and to install the update, respectively.
  2. Download the most recent version of WebMO. If you have misplaced your WebMO password, enter the license number from the previous step with a password of "?" on the download page, and your password will be automatically emailed to you.
  3. Upload the WebMO distribution from your PC to your web server.
  4. Backup your current WebMO installation. For example,
    $ tar cvf webmo_backup.tar {cgiBase} {htmlBase} {userBase} where {cgiBase}, {htmlBase}, and {userBase} are specified in the globals.int configuration file.
  5. Login to your web server account, and extract the WebMO distribution.
    $ tar xzf WebMO..x.xxx.tar.gz
  6. If the WebMO instance is being actively used, login to WebMO as admin, disable the WebMO Queue using System Manager, either wait for currently running jobs to complete or kill any running jobs using Job Manager, and logout.
  7. Run the upgrade script.
    $ cd WebMO.install
    $ perl upgrade.pl
  8. Follow the prompts in the upgrade script. Specify the absolute location of your globals.int file. After the distribution files are copied, the command line portion of WebMO upgrade is complete.
  9. If you are upgrading WebMO Pro/Enterprise and have configured any remote servers, login to WebMO as admin, click the Remote Server Manager, choose the edit servers tab, and click the Upgrade icon for each server.
  10. If the WebMO Queue was disabled, login to WebMO as admin, enable the WebMO Queue using System Manager, and logout.
  11. Login to WebMO as a user and run a test job.
  12. If you wish to install additional computational chemistry programs on your mac, see the separate support pages for installing binaries. Then enable, configure, and test these packages as described.
  13. Questions or feedback? Please visit the WebMO Support Forum or send email to support@webmo.net.

Mac OS X

  1. Locate your WebMO license number and globals.int file. Login to WebMO as admin and click Version Manager. Note:
    • the WebMO license number
    • the full path of the WebMO globals.int file
    These are necessary to download the WebMO update and to install the update, respectively.
  2. Download the most recent version of "WebMO for Linux/Mac" to your mac. (The WebMO.*.tar.gz distribution will automatically be expanded into a WebMO.*.tar file.) If you have misplaced your WebMO password, enter the license number from the previous step with a password of "?" on the download page, and your password will be automatically emailed to you.
  3. Untar the WebMO distribution. Start a Terminal session.
    $ cd {download directory}
    $ tar xf WebMO..x.xxx.tar
  4. Run the upgrade script.
    $ cd WebMO.install
    $ perl upgrade.pl
  5. Follow the prompts in the upgrade script. Specify the absolute location of your globals.int file. After the distribution files are copied, the command line portion of WebMO upgrade is complete.
  6. Login to WebMO as a user and run a test job.
  7. If you wish to install additional computational chemistry programs on your mac, see the separate support pages for installing binaries. Then enable, configure, and test these packages as described.
  8. Questions or feedback? Please visit the WebMO Support Forum or send email to support@webmo.net.

Windows

  1. Locate your WebMO license number and globals.int file. Login to WebMO as admin and click Version Manager. Note:
    • the WebMO license number
    • the full path of the WebMO globals.int file
    These are necessary to download the WebMO update and to install the update, respectively.
  2. Download the most recent version of "WebMO for Windows". If you have misplaced your WebMO password, enter the license number from the previous step with a password of "?" on the download page, and your password will be automatically emailed to you.
  3. Extract the WebMO distribution. Right-click on the downloaded file and select "Extract all..."
  4. Run the upgrade script. Navigate into to the extracted distribution and then into the WebMO.install directory. Double-click upgrade.pl
  5. Login to WebMO as a user and run a test job.
  6. If you wish to install additional computational chemistry programs on your mac, see the separate support pages for installing binaries. Then enable, configure, and test these packages as described.
  7. Questions or feedback? Please visit the WebMO Support Forum or send email to support@webmo.net.