Configure and Deploy Dispatcher - EcoSys - - Installation & Upgrade - Hexagon PPM

EcoSys Connect Installation and Configuration

PPMProduct
EcoSys
PPMCategory_custom
Installation & Upgrade
Version_EcoSys
1.1

Follow the steps below to configure and deploy Dispatcher:

  1. Once you complete the ActiveMQ deployment, you will be directed to the Dispatcher part of the installation script. Enter y to install Dispatcher on this machine. Enter n to skip this step.

    This step does not appear for a new installation or if ActiveMQ status has changed. You will be directly moved to the next step.

  2. Answer y to proceed with the installation process.

  3. You will be asked if the ActiveMQ hostname has DNS record. If not, you must provide the IP address for the ActiveMQ host.

    If you are reinstalling or installing dispatcher separately from the ActiveMQ installation process, you will also be prompted to enter ActiveMQ Hostname, _CREDS2_ and _CREDS5_ that you have used during the ActiveMQ process.

    If ActiveMQ is not configured or ActiveMQ is installed on a different server, this step will prompt you to enter the location to ActiveMQ TrustStore file ’amq-client.ts’. If the file does not exist at the location, install script process will be terminated.

    You can find the amq-client file on its respective installed server at - /home/user/Staging/connect-workspace/activemq/swarm/activemq/conf

  4. Enter the Ecosys URL where you want Ecosys Connect UI to be embedded inside:

  5. If you have the value for “server.keyphrase” setting in FMServerSettings.properties file, which is used by the Ecosys, then Answer Y.

  6. Enter the JWKS URL for token verification, provided by OAuth token Provider such as Okta:

  7. Enter the Token Scope:

  8. Enter which database you want to use with EcoSys Connect:

  9. Setup Dispatcher connect to the RDBMS.

    For Microsoft SQL Server:

    1. Read and Accept the license agreement to download the jdbc driver.

    2. Enter the Fully qualified hostname of the Database server (For example, dbConnect.domain.com)

    3. Enter a Specific SQL Server Instance you want to Connect to. If not, enter n.

    4. Default port for SQL Server is 1433. If your SQL Server is listening to non-default port, then Enter n. else Enter y.

    5. Default Ecosys Connect Database Name is ’ecconnect’. Enter N if it is not changed.

    6. If Database hostname has DNS record, then Enter Y. If not, you will be asked to enter IP address for the Database Host.

    7. Default Ecosys Connect Database user is ‘ecuser’, Enter n if it is not changed.

    8. Enter password for Ecosys Connect Database user’s password.

      For Oracle:

    9. Enter version of your Oracle. You can get the version by running the query below:

      ‘SELECT * FROM v$version;

      OR

      SELECT * FROM v$versionWHERE banner LIKE 'Oracle%';’

    10. Read and accept the license agreement to download the jdbc driver.

    11. Enter the fully qualified hostname of the Database server (for example, dbConnect.domain.com)

    12. Default port for Oracle is 1521. If your Oracle is listening to non-default port, then enter n, else enter y.

    13. Default Ecosys Connect Database Name is ’ecconnect’. Enter n, if it is not changed.

    14. If Database hostname has DNS record then Enter Y. If not, You will be asked to enter IP address for the Database Host.

    15. If Default Ecosys Connect Database user is ‘ecuser’, Enter n if it is not changed.

    16. Enter password for Ecosys Connect Database user’s password

      .

  10. Ecosys Connect will use the default port 8080 to listen. If not, enter n and you will be asked to enter the port number.

  11. Enter y, if Ecosys Connect is configured with secure connection HTTPS of Ecosys App. If not, enter n.

    If the answer is y, then you will be asked to provide ProxyURL.

  12. Enter y to change the maximum size for java heap memory that LogAgent will run on.

    The installer script will create necessary docker volumes for dispatcher.

  13. Dispatcher Configuration completion message appears on the screen. Enter y to proceed with deployment.

  14. Confirm successful deployment message.

  15. Enter y to validate the dispatcher installation.