Knowledge Base

Article ID: 1747 - Last Modified: October 18, 2012

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

Schrödinger Non-Server-Based (Node-locked) License File Installation Guide

To install the non-server-based (e.g., node-locked) 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. Please choose the instructions appropriate to your Schrodinger release and computing platform below:

  • 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
    Verifying the licenses
    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: If your node-locked license is installed properly Maestro will begin the startup process; starting Maestro allows some required directories to be written for subsequent steps.
    3. Start the Diagnostics user interface:
      $SCHRODINGER/diagnostics
    4. Verify that the correct licenses are reported in the "License Test" 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

    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
    Verifying the licenses
    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. Verify that the correct licenses are reported in the "License Test" 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

    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
    Verifying the licenses
    1. If you have not already done so, start up Maestro. NOTE: If your node-locked license is installed properly Maestro will begin the startup process; 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. Verify that the correct licenses are reported in the "License Test" 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

    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. Verify that the correct licenses are reported:
      $SCHRODINGER/licadmin DIAG
    3. If there is a problem, issue the command:
      $SCHRODINGER/licadmin INFO

      and send the resulting tar.gz output file to help@schrodinger.com along with your full contact information and the name of the license purchaser, if possible.

  • 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:

#1746: How do I install a server-based license?

Back to Search Results

Was this information helpful?

What can we do to improve this information?


If you need additional help, please email us at help@schrodinger.com.
Knowledge Base Search

Type the words or phrases on which you would like to search, or click here to view a list of all
Knowledge Base articles