Reconfigure Job Server to use the centralized host entry configuration

To transition your current Job Server to the new centralized host entry configuration: 

NOTE: Instructions are for Linux only. Job Server Hosts must be on Linux machines.

1. Configure the centralized host entry file

2. Specify compute Schrödinger installations

3. Restart the Job Server

 

1. Configure the centralized host entry file

The hosts.yml file serves as the central repository for defining compute host configurations and supersedes the legacy schrodinger.hosts file, thereby establishing a unified and administratively controlled environment for job execution.

Customers who were using Job Server prior to the 2025-3 release should already have a schrodinger.hosts file configured in one or more Schrodinger installation directories. One of these files can be converted to the Job Server <jobserver_dir>/config/hosts.yml file by running the command:

sudo -u jobserver $SCHRODINGER/jsc admin convert-schrodinger-hosts --job-server-dir=<jobserver_dir> --schrod=<schrodinger_installation_with_hosts_file>

This command will create the <jobserver_dir>/config/hosts.yml file.

For more information on the hosts.yml format see Set up the Host Entries on Job Server.

 

2. Specify compute Schrödinger installations

With the centralized scheme, clients no longer pass to Job Server the locations of cluster Schrodinger installations. This means Job Server now must be configured so it can find those cluster Schrodinger installations itself. Follow the steps here to modify the Job Server configuration.

 

3. Restart the Job Server

The Job Server system service needs to be restarted for these changes to take effect.

To restart, run the following command:

sudo systemctl restart jobserverd

Client machines should now be able to submit remote jobs to Job Servers compute entries without relying on the presence of a local schrodinger.hosts file.

 

 

 


 

Not ready to transition? See Revert to decentralized schrodinger.hosts-based host entry configuration