Run Management

An alternative way of running a simulation from the GUI (as described in Chapter 9) is to launch it from a command line. Opus contains a set of scripts that simplify the process of creating a base year cache, starting, and restarting a set of simulation runs.

These scripts are a set of command line applications, or tools, in the opus_core/tools directory. They use a database as the central repository (by default sqlite) for coordination and context infomation for run managment, by default called services. If you don't have this database, create it (you need to do this from within the opus_core/tools directory):

python create_services_database.py

This creates the database named services on the localhost database server using the user name and password specified in the MYSQLUSERNAME and MYSQLPASSWORD environment variables. To use a different host for the database server, include the --hostname option. To use a different database name, include the --database option:

python create_services_database.py --hostname myhost.mydomain --database
myservices

All scripts described below print a help message when called with the -h or --help option.