How do I install a server-based license?

Schrödinger Server-Based License File Installation Guide

To install the server-based licenses you've been emailed (or have downloaded), the license file must be added to your Schrodinger installation. This must be done by someone with write access to your installation. You must start a license server daemon on the machine to which the licenses are tied, or update the server daemon if one is already running. Note that updating the server must be done by the person who originally started the license server daemon. Please choose the instructions appropriate to your Schrodinger release and computing platform below:

• Schrodinger Suite 2012, Linux

  Schrodinger Suite 2012, Linux

  Installing the license file

  Download the "licmerge.py" script from here:

  Click here to download licmerge.py

  Place the "licmerge.py" file in a temporary directory. Place a copy of the license file from your download or email in the same directory. After making sure the SCHRODINGER environment variable is set to the top level Schrodinger installation directory, issue the command:

  $SCHRODINGER/run licmerge.py -merge [name_of_new_license_file]

  This will merge the new licenses to your existing license file in the Schrodinger directory. If you would like to know which license file will be merged into, issue the command:

  $SCHRODINGER/run licmerge.py -find

  For more detailed instructions on running the licmerge.py script, issue the command:

  $SCHRODINGER/run licmerge.py -h

  Starting/updating the license server and verifying the licenses

  Note: For command-line instructions, see the "Schrodinger Suite 2011 and earlier, Linux" section.

  1. In a terminal window, set the SCHRODINGER environment variable to point to the top level Schrodinger installation directory.
  2. If you have not already done so, start up Maestro. NOTE: Unless you are using a machine-locked license, this will fail with a licensing error; starting Maestro allows some required directories to be written for subsequent steps.
  3. Start the Diagnostics user interface.
     $SCHRODINGER/diagnostics
  4. If the "Stop License Server" button is enabled, click it to temporarily stop the license server daemon.
  5. Click the "Start License Server" to start the license server daemon. If you are installing server-based licenses but this button is not enabled, you might be running the Diagnostics GUI on a machine other than the license server.
  6. Verify the license server daemon is running and reporting the correct licenses in the "Server Status" tab.
     • If yes, you should be able to start Maestro.
     • If no, click on the Tech Support button at the bottom of the Diagnostics panel and send us the resulting tarball file.

• Schrodinger Suite 2012, Windows

  Schrodinger Suite 2012, Windows

  Installing the license file

  Download the "licmerge.py" script from here:

  Click here to download licmerge.py

  Place the "licmerge.py" file in a temporary folder. Place a copy of the license file from your download or email in the same folder. Open the Schrodinger Command Prompt window:

  Start > All Programs > Schrodinger-2012 > Schrodinger Command Prompt

  Change directories into the temporary folder that contains the "licmerge.py" script by entering the following command:

  chdir [full_path_to_temporary_folder]

  Then, enter:

  run licmerge.py -merge [name_of_new_license_file]

  This will merge the new licenses to your existing license file in the Schrodinger folder. If you would like to know which license file will be merged into, issue the command:

  run licmerge.py -find

  For more detailed instructions on running the "licmerge.py" script, issue the command:

  run licmerge.py -h

  Starting/updating the license server and verifying the licenses

  Note: For command-line instructions, see the "Schrodinger Suite 2011 and earlier, Windows" section.

  1. If you have not already done so, start up Maestro. NOTE: Unless you are using a machine-locked license, this will fail with a licensing error; starting Maestro allows some required directories to be written for subsequent steps.
  2. Open the Diagnostics panel via:
     Start > All Programs > Schrodinger-2012 > Diagnostics
  3. If the "Stop License Server" button is enabled, click it to temporarily stop the license server daemon.
  4. If the "Start License Server" button is enabled, click it to start the license server daemon. If you are installing server-based licenses but this button is not enabled, you might be running the Diagnostics GUI on a machine other than the license server.
  5. Verify the license server daemon is running and reporting the correct licenses in the "Server Status" tab.
     • If yes, you should be able to start Maestro.
     • If no, click on the Tech Support button at the bottom of the Diagnostics panel and send us the resulting tarball file.

• Schrodinger Suite 2012, Mac

  Schrodinger Suite 2012, Mac

  Installing the license file

  Download the "licmerge.py" script from here:

  Click here to download licmerge.py

  Place the "licmerge.py" file in a temporary directory. Place a copy of the license file from your download or email in the same directory. After making sure the SCHRODINGER environment variable is set to the top level Schrodinger installation directory, issue the command:

  $SCHRODINGER/run licmerge.py -merge [name_of_new_license_file]

  This will merge the new licenses to your existing license file in the Schrodinger directory. If you would like to know which license file will be merged into, issue the command:

  $SCHRODINGER/run licmerge.py -find

  For more detailed instructions on running the licmerge.py script, issue the command:

  $SCHRODINGER/run licmerge.py -h

  Starting/updating the license server and verifying the licenses

  Note: For command-line instructions, see the "Schrodinger Suite 2011 and earlier, Linux" section.

  1. If you have not already done so, start up Maestro. NOTE: Unless you are using a machine-locked license, this will fail with a licensing error; starting Maestro allows some required directories to be written for subsequent steps.
  2. Open the Diagnostics panel from the "SchrodingerSuite2012" folder of your Applications folder.
  3. If the "Stop License Server" button is enabled, click it to temporarily stop the license server daemon.
  4. Click the "Start License Server" to start the license server daemon. If you are installing server-based licenses but this button is not enabled, you might be running the Diagnostics GUI on a machine other than the license server.
  5. Verify the license server daemon is running and reporting the correct licenses in the "Server Status" tab.
     • If yes, you should be able to start Maestro.
     • If no, click on the Tech Support button at the bottom of the Diagnostics panel and send us the resulting tarball file.

• Schrodinger Suite 2011 and earlier, Linux

  Schrodinger Suite 2011 and earlier, Linux

  Installing the license file

  Download the "licmerge.py" script from here:

  Click here to download licmerge.py

  Place the "licmerge.py" file in a temporary directory. Place a copy of the license file from your download or email in the same directory. After making sure the SCHRODINGER environment variable is set to the top level Schrodinger installation directory, issue the command:

  $SCHRODINGER/run licmerge.py -merge [name_of_new_license_file]

  This will merge the new licenses to your existing license file in the Schrodinger directory. If you would like to know which license file will be merged into, issue the command:

  $SCHRODINGER/run licmerge.py -find

  For more detailed instructions on running the licmerge.py script, issue the command:

  $SCHRODINGER/run licmerge.py -h

  Starting/updating the license server and verifying the licenses

  1. In a terminal window, set the SCHRODINGER environment variable to point to the top level Schrodinger installation directory.
  2. Stop the license server daemon with the following command (and wait five seconds):
     $SCHRODINGER/licadmin STOP
  3. Start the license server daemon with the following command:
     $SCHRODINGER/licadmin START -c $SCHRODINGER/license -l lmgrd.`hostname`.log
  4. Verify the license server daemon has started:
     $SCHRODINGER/licadmin STAT
  5. If the license server daemon started, your installation is complete! If it did not start, issue the command:
     $SCHRODINGER/licadmin INFO

• Schrodinger Suite 2011 and earlier, Windows

  Schrodinger Suite 2011 and earlier, Windows

  Installing the license file

  Download the "licmerge.py" script from here:

  Click here to download licmerge.py

  Place the "licmerge.py" file in a temporary folder. Place a copy of the license file from your download or email in the same folder. Open the Schrodinger Command Prompt window:

  Start > All Programs > Schrodinger-20XX > Schrodinger Command Prompt

  Change directories into the temporary folder that contains the "licmerge.py" script by entering the following command:

  chdir [full_path_to_temporary_folder]

  Then, enter:

  run licmerge.py -merge [name_of_new_license_file]

  This will merge the new licenses to your existing license file in the Schrodinger folder. If you would like to know which license file will be merged into, issue the command:

  run licmerge.py -find

  For more detailed instructions on running the "licmerge.py" script, issue the command:

  run licmerge.py -h

  Starting/updating the license server and verifying the licenses

  Send the machine information from the latest installation to help@schrodinger.com. Note that by default it will be in a file on your desktop named "schrodinger_machinfo.txt". After receiving the full machine information, we will send you some "*.bat" files that will allow you to stop, start, test, or reread your license file by double-clicking on an icon.

Related Articles:

#1747: How do I install a non-server-based (node-locked) license?

Back to Search Results