Query license server status and license usage
Querying license servers
- Windows
- Mac
- Linux
All configured license servers
See a report on the feature entitlements and usage on all configured license servers.
Open a Schrödinger Command Prompt or Schrödinger Power Shell and run:
lictool entitlement-status
To query a specific server, add:
‘--licsrv-hostport <server_hostname>:<server_port>’
Example Output
Suppose there is a license server that has:
-
a 10-token library with Epik, LigPrep, and Jaguar (called SUITE_06JAN2026)
-
two dedicated Jaguar licenses
If the library were in use running a 4-processor LigPrep job...
(note that LigPrep requires 1 token per job—see License Dependencies and Tokens—so a 4-processor job requires 4 tokens)
...the default status query would show:
Licserver status: myserver:53000
Licserver version: 74xxx revision=unknown release=2026-1 License dir: /opt/schrodinger/licserver/licenses
License file(s):
/opt/schrodinger/licserver/licenses/server_2026-01-06.lic Active Entitlements usage info:
Users of EPIK_MAIN: (Total of 10 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 6 tokens available) Users of JAGUAR_MAIN: (Total of 14 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 10 tokens available)
Users of LIGPREP_MAIN: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
Users of SUITE_06JAN2026: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available
Explanation
Note the library (SUITE_06JAN2026) entitlement and usage is shown separately from the Epik, Jaguar, and LigPrep feature use.
Users of EPIK_MAIN: (Total of 10 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" EPIK_MAIN and LIGPREP_MAIN are only in the token library, so the “tokens issued” are those in the library which can be used by Epik and/or Jaguar and/or LigPrep jobs
"Total of 0 tokens tokens in use" indicates no Epik jobs are running
"Total of 4 other library tokens in use" refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
"Total of 6 tokens available" refers to the 10 token library (which includes tokens that can be used for Epik and/or Jaguar and/or LigPrep jobs)
Users of JAGUAR_MAIN: (Total of 14 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 10 tokens available)
"Total of 14 tokens issued" - In contrast, JAGUAR_MAIN has tokens available from the 2 dedicated Jaguar licenses (each dedicated license having 2 tokens, so 4 tokens total) and 10 tokens from the library
"Total of 0 tokens in use" - Indicates no Jaguar jobs are running
"Total of 4 other library tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job.
"Total of 10 tokens available" - Because Jaguar has a total of 14 tokens, there are 10 remaining after the 4 library tokens used by LigPrep
Users of LIGPREP_MAIN: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" - As noted above, EPIK_MAIN and LIGPREP_MAIN are only in the token library, so the “tokens issued” are those in the library which can be used by Epik and/or Jaguar and/or LigPrep jobs
"Total of 4 tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
Note - Unlike Epik and Jaguar, there is no mention of "other library tokens in use" because the library is being used only for LigPrep jobs
"Total of 6 tokens available" - Refers to the 10 token library (which includes tokens that can be used for Epik and/or Jaguar and/or LigPrep jobs)
Users of SUITE_06JAN2026: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" - SUITE_06JAN2026 is the name of the library that includes Epik, LigPrep, and Jaguar. That library includes 10 tokens
"Total of 4 tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
Note - There is no mention of "other library tokens in use" since that is relevant only for components of a library, not the library itself
"Total of 6 tokens available" - 4 library tokens are in use by the LigPrep job, but the other 6 tokens are available
Filtering usage by user/machine/job
The ‘lictool entitlement-status’ output can be filtered to show the usage by a specific user (‘--user’ argument), machine (‘--hostname’ argument), or Schrodinger Job ID (‘--jobid’ argument). If there is matching usage, the command will show the individual checkouts by that user/machine/job in addition to the feature summary lines, which will have an additional field indicating the number of “tokens in use by requested selection”.
If the argument ‘--regex-host’ is used in combination with ‘--hostname’, the latter’s value is treated as a regular expression, and usage for any machine name matching that regular expression is reported.
Generating machine-readable output
By default, the ‘lictool entitlement-status’ output is human-readable. To generate machine-readable JSON output, add the ‘--json’ argument to the command.
Showing individual license checkouts
See a report on who is using which licenses, and on what machines.
Open a Schrödinger Command Prompt or Schrödinger Power Shell and run:
run lictool status
This information also is available via status queries if you want to know who is using which licenses.
Example Output
(same as above) Suppose there is a license server that has:
-
a 10-token library with Epik, LigPrep, and Jaguar (called SUITE_06JAN2026)
-
two dedicated Jaguar licenses
If the library were in use running a 4-processor LigPrep job...
(note that LigPrep requires 1 token per job—see License Dependencies and Tokens—so a 4-processor job requires 4 tokens)
...the default status query would show:
Licserver status: myserver:53000
Licserver version: 74xxx revision=unknown release=2026-1 License dir: /opt/schrodinger/licserver/licenses
License file(s):
/opt/schrodinger/licserver/licenses/server_2026-01-06.lic Feature usage info:
Users of EPIK_MAIN: (Total of 10 licenses issued; Total of 4 licenses in use; Total of 6 licenses available)
Users of JAGUAR_MAIN: (Total of 14 licenses issued; Total of 4 licenses in use; Total of 10 licenses available)
Users of LIGPREP_MAIN: (Total of 10 licenses issued; Total of 4 licenses in use; Total of 6 licenses available)
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca597fb-038c-11f1-baad-004e01feaf2f Pid: 220767 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca4fb5f-038c-11f1-abb7-004e01feaf2f Pid: 220768 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca4fb4e-038c-11f1-81f7-004e01feaf2f Pid: 220766 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca50a75-038c-11f1-b3b5-004e01feaf2f Pid: 220765 Count: 1
Explanation
When Schrodinger software checks out tokens from the server, it notes:
-
the user
-
hostname
-
(if applicable) Schrödinger Job ID
Here, under the summary “Users of LIGPREP_MAIN” line, we see the four individual LIGPREP_MAIN:1 token checkouts by the four subjobs of the 4-processor LigPrep job, run by user ‘smith’ on the machine ‘desk-lu406.schrodinger.com’.
Note there are no individual “User:” checkout lines underneath EPIK_MAIN and JAGUAR_MAIN. That is because the “4 licenses in use” for the EPIK_MAIN and JAGUAR_MAIN are due to 4 LIGPREP_MAIN being checked out from the shared token library . No EPIK_MAIN or JAGUAR_MAIN tokens have been checked out by Epik or Jaguar applications
All configured license servers
See a report on the feature entitlements and usage on all configured license servers.
In a terminal, run:
/opt/schrodinger/suites2026-1/run lictool entitlement-status
To query a specific server, add:
‘--licsrv-hostport <server_hostname>:<server_port>’
Example Output
Suppose there is a license server that has:
-
a 10-token library with Epik, LigPrep, and Jaguar (called SUITE_06JAN2026)
-
two dedicated Jaguar licenses
If the library were in use running a 4-processor LigPrep job...
(note that LigPrep requires 1 token per job—see License Dependencies and Tokens—so a 4-processor job requires 4 tokens)
...the default status query would show:
Licserver status: myserver:53000
Licserver version: 74xxx revision=unknown release=2026-1 License dir: /opt/schrodinger/licserver/licenses
License file(s):
/opt/schrodinger/licserver/licenses/server_2026-01-06.lic Active Entitlements usage info:
Users of EPIK_MAIN: (Total of 10 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 6 tokens available) Users of JAGUAR_MAIN: (Total of 14 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 10 tokens available)
Users of LIGPREP_MAIN: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
Users of SUITE_06JAN2026: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available
Explanation
Note the library (SUITE_06JAN2026) entitlement and usage is shown separately from the Epik, Jaguar, and LigPrep feature use.
Users of EPIK_MAIN: (Total of 10 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" EPIK_MAIN and LIGPREP_MAIN are only in the token library, so the “tokens issued” are those in the library which can be used by Epik and/or Jaguar and/or LigPrep jobs
"Total of 0 tokens tokens in use" indicates no Epik jobs are running
"Total of 4 other library tokens in use" refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
"Total of 6 tokens available" refers to the 10 token library (which includes tokens that can be used for Epik and/or Jaguar and/or LigPrep jobs)
Users of JAGUAR_MAIN: (Total of 14 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 10 tokens available)
"Total of 14 tokens issued" - In contrast, JAGUAR_MAIN has tokens available from the 2 dedicated Jaguar licenses (each dedicated license having 2 tokens, so 4 tokens total) and 10 tokens from the library
"Total of 0 tokens in use" - Indicates no Jaguar jobs are running
"Total of 4 other library tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job.
"Total of 10 tokens available" - Because Jaguar has a total of 14 tokens, there are 10 remaining after the 4 library tokens used by LigPrep
Users of LIGPREP_MAIN: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" - As noted above, EPIK_MAIN and LIGPREP_MAIN are only in the token library, so the “tokens issued” are those in the library which can be used by Epik and/or Jaguar and/or LigPrep jobs
"Total of 4 tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
Note - Unlike Epik and Jaguar, there is no mention of "other library tokens in use" because the library is being used only for LigPrep jobs
"Total of 6 tokens available" - Refers to the 10 token library (which includes tokens that can be used for Epik and/or Jaguar and/or LigPrep jobs)
Users of SUITE_06JAN2026: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" - SUITE_06JAN2026 is the name of the library that includes Epik, LigPrep, and Jaguar. That library includes 10 tokens
"Total of 4 tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
Note - There is no mention of "other library tokens in use" since that is relevant only for components of a library, not the library itself
"Total of 6 tokens available" - 4 library tokens are in use by the LigPrep job, but the other 6 tokens are available
Filtering usage by user/machine/job
The ‘lictool entitlement-status’ output can be filtered to show the usage by a specific user (‘--user’ argument), machine (‘--hostname’ argument), or Schrodinger Job ID (‘--jobid’ argument). If there is matching usage, the command will show the individual checkouts by that user/machine/job in addition to the feature summary lines, which will have an additional field indicating the number of “tokens in use by requested selection”.
If the argument ‘--regex-host’ is used in combination with ‘--hostname’, the latter’s value is treated as a regular expression, and usage for any machine name matching that regular expression is reported.
Generating machine-readable output
By default, the ‘lictool entitlement-status’ output is human-readable. To generate machine-readable JSON output, add the ‘--json’ argument to the command.
Showing individual license checkouts
See a report on who is using which licenses, and on what machines.
In a terminal, run:
/opt/schrodinger/suites2026-1/run lictool status
This information also is available via status queries if you want to know who is using which licenses.
Example Output
(same as above) Suppose there is a license server that has:
-
a 10-token library with Epik, LigPrep, and Jaguar (called SUITE_06JAN2026)
-
two dedicated Jaguar licenses
If the library were in use running a 4-processor LigPrep job...
(note that LigPrep requires 1 token per job—see License Dependencies and Tokens—so a 4-processor job requires 4 tokens)
...the default status query would show:
Licserver status: myserver:53000
Licserver version: 74xxx revision=unknown release=2026-1 License dir: /opt/schrodinger/licserver/licenses
License file(s):
/opt/schrodinger/licserver/licenses/server_2026-01-06.lic Feature usage info:
Users of EPIK_MAIN: (Total of 10 licenses issued; Total of 4 licenses in use; Total of 6 licenses available)
Users of JAGUAR_MAIN: (Total of 14 licenses issued; Total of 4 licenses in use; Total of 10 licenses available)
Users of LIGPREP_MAIN: (Total of 10 licenses issued; Total of 4 licenses in use; Total of 6 licenses available)
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca597fb-038c-11f1-baad-004e01feaf2f Pid: 220767 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca4fb5f-038c-11f1-abb7-004e01feaf2f Pid: 220768 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca4fb4e-038c-11f1-81f7-004e01feaf2f Pid: 220766 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca50a75-038c-11f1-b3b5-004e01feaf2f Pid: 220765 Count: 1
Explanation
When Schrodinger software checks out tokens from the server, it notes:
-
the user
-
hostname
-
(if applicable) Schrödinger Job ID
Here, under the summary “Users of LIGPREP_MAIN” line, we see the four individual LIGPREP_MAIN:1 token checkouts by the four subjobs of the 4-processor LigPrep job, run by user ‘smith’ on the machine ‘desk-lu406.schrodinger.com’.
Note there are no individual “User:” checkout lines underneath EPIK_MAIN and JAGUAR_MAIN. That is because the “4 licenses in use” for the EPIK_MAIN and JAGUAR_MAIN are due to 4 LIGPREP_MAIN being checked out from the shared token library . No EPIK_MAIN or JAGUAR_MAIN tokens have been checked out by Epik or Jaguar applications
All configured license servers
See a report on the feature entitlements and usage on all configured license servers.
$SCHRODINGER/run lictool entitlement-status
To query a specific server, add:
‘--licsrv-hostport <server_hostname>:<server_port>’
Example Output
Suppose there is a license server that has:
-
a 10-token library with Epik, LigPrep, and Jaguar (called SUITE_06JAN2026)
-
two dedicated Jaguar licenses
If the library were in use running a 4-processor LigPrep job...
(note that LigPrep requires 1 token per job—see License Dependencies and Tokens—so a 4-processor job requires 4 tokens)
...the default status query would show:
Licserver status: myserver:53000
Licserver version: 74xxx revision=unknown release=2026-1 License dir: /opt/schrodinger/licserver/licenses
License file(s):
/opt/schrodinger/licserver/licenses/server_2026-01-06.lic Active Entitlements usage info:
Users of EPIK_MAIN: (Total of 10 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 6 tokens available) Users of JAGUAR_MAIN: (Total of 14 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 10 tokens available)
Users of LIGPREP_MAIN: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
Users of SUITE_06JAN2026: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available
Explanation
Note the library (SUITE_06JAN2026) entitlement and usage is shown separately from the Epik, Jaguar, and LigPrep feature use.
Users of EPIK_MAIN: (Total of 10 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" EPIK_MAIN and LIGPREP_MAIN are only in the token library, so the “tokens issued” are those in the library which can be used by Epik and/or Jaguar and/or LigPrep jobs
"Total of 0 tokens tokens in use" indicates no Epik jobs are running
"Total of 4 other library tokens in use" refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
"Total of 6 tokens available" refers to the 10 token library (which includes tokens that can be used for Epik and/or Jaguar and/or LigPrep jobs)
Users of JAGUAR_MAIN: (Total of 14 tokens issued; Total of 0 tokens in use; Total of 4 other library tokens in use; Total of 10 tokens available)
"Total of 14 tokens issued" - In contrast, JAGUAR_MAIN has tokens available from the 2 dedicated Jaguar licenses (each dedicated license having 2 tokens, so 4 tokens total) and 10 tokens from the library
"Total of 0 tokens in use" - Indicates no Jaguar jobs are running
"Total of 4 other library tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job.
"Total of 10 tokens available" - Because Jaguar has a total of 14 tokens, there are 10 remaining after the 4 library tokens used by LigPrep
Users of LIGPREP_MAIN: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" - As noted above, EPIK_MAIN and LIGPREP_MAIN are only in the token library, so the “tokens issued” are those in the library which can be used by Epik and/or Jaguar and/or LigPrep jobs
"Total of 4 tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
Note - Unlike Epik and Jaguar, there is no mention of "other library tokens in use" because the library is being used only for LigPrep jobs
"Total of 6 tokens available" - Refers to the 10 token library (which includes tokens that can be used for Epik and/or Jaguar and/or LigPrep jobs)
Users of SUITE_06JAN2026: (Total of 10 tokens issued; Total of 4 tokens in use; Total of 6 tokens available)
"Total of 10 tokens issued" - SUITE_06JAN2026 is the name of the library that includes Epik, LigPrep, and Jaguar. That library includes 10 tokens
"Total of 4 tokens in use" - Refers to the 4 LIGPREP_MAIN tokens in use by the 4-processor LigPrep job
Note - There is no mention of "other library tokens in use" since that is relevant only for components of a library, not the library itself
"Total of 6 tokens available" - 4 library tokens are in use by the LigPrep job, but the other 6 tokens are available
Filtering usage by user/machine/job
The ‘lictool entitlement-status’ output can be filtered to show the usage by a specific user (‘--user’ argument), machine (‘--hostname’ argument), or Schrodinger Job ID (‘--jobid’ argument). If there is matching usage, the command will show the individual checkouts by that user/machine/job in addition to the feature summary lines, which will have an additional field indicating the number of “tokens in use by requested selection”.
If the argument ‘--regex-host’ is used in combination with ‘--hostname’, the latter’s value is treated as a regular expression, and usage for any machine name matching that regular expression is reported.
Generating machine-readable output
By default, the ‘lictool entitlement-status’ output is human-readable. To generate machine-readable JSON output, add the ‘--json’ argument to the command.
Showing individual license checkouts
See a report on who is using which licenses, and on what machines.
$SCHRODINGER/run lictool status
This information also is available via status queries if you want to know who is using which licenses.
Example Output
(same as above) Suppose there is a license server that has:
-
a 10-token library with Epik, LigPrep, and Jaguar (called SUITE_06JAN2026)
-
two dedicated Jaguar licenses
If the library were in use running a 4-processor LigPrep job...
(note that LigPrep requires 1 token per job—see License Dependencies and Tokens—so a 4-processor job requires 4 tokens)
...the default status query would show:
Licserver status: myserver:53000
Licserver version: 74xxx revision=unknown release=2026-1 License dir: /opt/schrodinger/licserver/licenses
License file(s):
/opt/schrodinger/licserver/licenses/server_2026-01-06.lic Feature usage info:
Users of EPIK_MAIN: (Total of 10 licenses issued; Total of 4 licenses in use; Total of 6 licenses available)
Users of JAGUAR_MAIN: (Total of 14 licenses issued; Total of 4 licenses in use; Total of 10 licenses available)
Users of LIGPREP_MAIN: (Total of 10 licenses issued; Total of 4 licenses in use; Total of 6 licenses available)
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca597fb-038c-11f1-baad-004e01feaf2f Pid: 220767 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca4fb5f-038c-11f1-abb7-004e01feaf2f Pid: 220768 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca4fb4e-038c-11f1-81f7-004e01feaf2f Pid: 220766 Count: 1
User: smith Host: desk-lu406.schrodinger.com Version: v74 JobId: 4ca50a75-038c-11f1-b3b5-004e01feaf2f Pid: 220765 Count: 1
Explanation
When Schrodinger software checks out tokens from the server, it notes:
-
the user
-
hostname
-
(if applicable) Schrödinger Job ID
Here, under the summary “Users of LIGPREP_MAIN” line, we see the four individual LIGPREP_MAIN:1 token checkouts by the four subjobs of the 4-processor LigPrep job, run by user ‘smith’ on the machine ‘desk-lu406.schrodinger.com’.
Note there are no individual “User:” checkout lines underneath EPIK_MAIN and JAGUAR_MAIN. That is because the “4 licenses in use” for the EPIK_MAIN and JAGUAR_MAIN are due to 4 LIGPREP_MAIN being checked out from the shared token library . No EPIK_MAIN or JAGUAR_MAIN tokens have been checked out by Epik or Jaguar applications