Prerequisites

Java Prerequisites (Windows)

For all ModelCenter software, users are required to download and install Java separately in order to use the software.

The ModelCenter software installers will ask for either a JDK or a JRE directory. If one has been previously installed, it will automatically show up in the Choose Java directory list. If no JDK or JRE has been previously installed, it can be done mid-install. To refresh the list, simply click the refresh button represented by the circular arrows.

• The Choose Java dialog sets the PHX_JAVA_HOME environment variable only. To set the other Java/JRE variables (PHX_JRE_HOME, JRE_HOME, and JAVA_HOME), you must set them through the Windows interface.
• When ModelCenter looks for a Java reference, it checks the variables in the default order: PHX_JRE_HOME > PHX_JAVA_HOME > JRE_HOME > JAVA_HOME. The first valid configuration is used. Variables pointing to invalid locations are skipped.

Java Prerequisites (Linux)

For all ModelCenter software, users are required to download and install Java separately in order to use the software.

1. Copy the installer to the Linux machine.
2. Put the file in its own directory.
3. Start a terminal (or log in via PuTTY).
4. Change directory to the java file's directory.
5. Unzip the java file.
6. Untar the java file.
7. In a text editor, open the user's .bashrc file.
8. Add the following two lines to the file:

   export JAVA_HOME="/home/staff/<username>/java/jdk-11.0.15" 
   export PATH=$PATH:$JAVA_HOME/bin

   where <username> is replaced with the appropriate information. Replace the Java version with the correct information, as well.

   When ModelCenter looks for a Java reference, it checks the variables in the default order: PHX_JRE_HOME > PHX_JAVA_HOME > JRE_HOME > JAVA_HOME. The first valid configuration is used. Variables pointing to invalid locations are skipped.

9. Save the file.
10. Close the terminal.

Python Prerequisite

For ModelCenter software, Python must be downloaded and installed in order to use Python within ModelCenter.

User-Specified Python support requires the installation of Python packages thrift and six.

The following examples assume Windows OS and that the pip package manager is installed and associated with the version of Python you wish to use.

Typical Installation

1. From a command line, enter:

   pip install thrift

   or

   py -m pip install thrift

2. Enter:

   pip install six

   or

   py -m pip install six

Custom Package Installation Location

1. From a command line, enter:

   pip install --install-option="--prefix=$PREFIX_PATH" thrift

   You can also use --ignore-installed to force all dependencies to be reinstalled using this new prefix.
2. From a command line, enter:

   pip install --install-option="--prefix=$PREFIX_PATH" six

   You can also use --ignore-installed to force all dependencies to be reinstalled using this new prefix.

Configuration

ModelCenter Remote Execution configuration supports setting the fully qualified path to the Python executable, the search path for module files, and the directory for the standard Python library

Set these values with the following steps:

1. Launch ModelCenter Remote Execution.
2. Click the Configure button.
3. Click the Directories link in the sidebar.
4. Scroll to the bottom of the page to the 3 Python fields:
   1. pythonExe
   2. optional: pythonHome (PYTHONHOME reference)
   3. optional: pythonPath (PYTHONPATH reference)
5. Enter the information for each field. (Click the field name to see a description of each.)