Installation conventions to follow

When you install or update Optima, you must follow some conventions.

The standard paths for Optima are:

Component Name

Installation path of the ZIP file for Windows components

The ZIP file containing the PTV Optima distribution is:

Optima-vv.n.xxxxx.zip

The installation path is:

C:\optima_zip\

Installation path for Windows components

The installation path for PTV Optima Windows components is:

C:\optima\

Installation path of the ZIP file for Linux components

The ZIP file containing the PTV Optima distribution is:

Optima-vv.n.xxxxx.zip

The installation path is:

/opt/optima_zip

Installation path for Linux components

The installation path for PTV Optima Linux-like components is:

/opt/ptv-optima-ComponentName/

Examples:

  • AS: /opt/ptv-optima-as/
  • Hyperpath: /opt/ptv-optima-hyperpath/

$VISSIM_MODEL_PATH

The installation path for PTV Vissim Windows components.

All microsimulation subnetworks are stored in $VISSIM_MODEL_PATH.

The value usually used is:

$VISSIM_MODEL_PATH="C:\optima\vissim_model\"

We strongly recommend to adopt the suggested standard folder structure, depending on your installation scenario (→ Installation scenarios).

  • Installation scenario 1: Optima is installed on a Windows server that hosts all elements.

    Within the C:\optima, create the subfolders:

    • license: It contains the PTV Optima license file, named license.l4j by default with its corresponding license.html file.
    • optima_zip: It contains the most recent Optima Zip archive. During installation and upgrade, it contains the unzipped folders used to operate on the system (with additional temporary files).

    The folder used by PostgreSQL for storing the database is kept in the default location for PostgreSQL Windows installations: C:\Program Files\PostgreSQL\XX\data

  • Installation scenario 2: Optima is installed on different servers

    • On the .NET server:

      If on Windows, within the C:\optima, create the subfolders:

      • license: It contains the PTV Optima license file, named license.l4j by default, with its corresponding license.html file.
      • optima_zip: It contains the most recent Optima Zip archive. During installation and upgrade, it contains the unzipped folders used to operate on the system (with additional temporary files).

    • On the Optima AS:

      If on Linux, within the /opt/ptv-optima-vv.n.xxxx, create the subfolders:

      • license: It contains the PTV Optima license file, named license.l4j by default, with its corresponding license.html file.
      • optima_zip: It contains the most recent Optima Zip archive. During installation and upgrade, it contains the unzipped folders used to operate on the system (with additional temporary files).

    • Database server:

      The folder used by PostgreSQL for storing the database is kept in the default location for PostgreSQL Linux installations:

      /var/lib/pgsql/XX/data

PTV Optima is protected by a file-based licensing system. You need a valid license file to use a PTV Optima installation.

  1. To ask for a new license file, please contact PTV Order Management (ordermanagement@ptvgroup.com).
  2. Attach the Word file PTV_Optima_License_Issue_Template.docx, which can be provided to you by Optima Product Management with all details of the license you need.

Note that any software must point to the license file in its configuration parameters.

  • All .NET software have a configuration parameter
    LicenseFile
    whose default value is C:\optima\license\license.l4j.
  • All Linux software have a configuration parameter
    LicenseFile
    whose default value is /opt/license/license.l4j.

  • While the Optima AS has a configuration parameter specified in:

    • C:\optima\ptv-optima-as\standalone\configuration\optima\optima-configuration.xml (Windows environment)
    • /opt/ptv-optima-as/standalone/configuration/optima/optima-configuration.xml (Linux environment)

    The tag <licenseFile> specifies the installation path of the license:

    <licenseFile>installation path of the license</licenseFile>

    where the installation path license can be:

    • C:\optima\license\license.l4j.
    • /opt/license/license.l4j.

The standard username and the standard password for the Optima DB are the username and password set during the installation process.

On the Optima application server, both the group and the username for the Optima application server must be ptv-optima-as.

Unless otherwise specified, the names for folders, files, services are ALL lowercase.

The standard naming scheme for Optima service names is:

ptv-optima-<component name>

Example: ptv-optima-tre

The standard naming scheme for Optima Micro service names is:

ptv-optimissim-<component name>

Example: ptv-optimissim-vissimworker

To access the DB, you can use pgAdmin, an official GUI for PostgreSQL.

The configuration file for all .NET software components is called CommandLineTDE.csv.

Parameters are different for each .NET component. For details on the parameters, see the descriptions of the configuration of each component: → Methodology and Configuration.