Guide

Upgrade

If you are part of the Early Adopter Program and wish to update your environment with this first production release of the Discngine LiveDesign Connector for Pipeline Pilot, please consult the changelog first. Indeed, changes that have been made to the components of the Pipeline Pilot collection can lead to a backwards compatibility break on your existing protocols.

This guide is intended for Early Adopters who have already installed an EA version of the LiveDesign Connector for Pipeline Pilot.

The Discngine LiveDesign Connector for Pipeline Pilot package contains:

  • ldconn: the Pipeline Pilot collection developed to interact with LiveDesign into Pipeline Pilot protocol,
  • ldconn.conf: configuration file for the LiveDesign server's nginx service,
  • ldconn_session.conf: configuration file for the LiveDesign server's nginx service.

You will need to have:

  • ssh access to the Schrodinger® LiveDesign server, with rights to edit the nginx conf and restart nginx server,
  • access to BIOVIA® Pipeline Pilot server and rights to install packages on it and restart Apache server.
  1. On the Pipeline Pilot server, open the command line prompt as an administrator from the windows start menu (Right click > execute as administrator) and change the directory to [scitegic_root]\bin (or [scitegic_root]/linux_bin if you are on a Linux server).

  2. Uninstall the Discngine LiveDesign collection executing the following command:

    .\pkgutil.exe -u discngine/ldconn

  3. Remove or backup the folder <scitegic_root>\PPS\apps\discngine\ldconn.

  4. Place the folder ldconn from the package in <scitegic_root>\PPS\apps\discngine\.

  5. Install the Discngine LiveDesign collection executing the following command:

    .\pkgutil.exe -i discngine/ldconn

  6. Restart the Apache server:

    • open the Pipeline Pilot server administration page
    • navigate to Setup > Manage Server in the left pane
    • press the "Restart Apache" button
  7. During previous installation(s), you have already configured the global properties declared for the package and the values are retained during the upgrade. Note that in this latest release the new DefaultProjectName global property is configurable. To access these global properties:

    • open the Pipeline Pilot server administration page
    • navigate to Setup > Global Property in the left pane
    • Here is the list of properties:
Property Description Required Default Value
LiveDesignServerUrl URL of your Live Design server, e.g. https://ldserver.yourcompany.com. Yes
LiveDesignVersion The version of your Live Design server (must be 8.9 or 8.10). Yes 8.10
Delimiter String delimiter used internally. Do not change it unless you have issues. Yes !!_!!
LicenseKey Your Licence key for the Pipeline Pilot Gadget. Yes
VerifySSL Whether you want want to check SSL certificate when using Pipeline Pilot Components. Set to False if you use a self-signed certificate or if you are not using SSL. Yes
DefaultProjectName Name of the LiveDesign project that will be used by components by default. No Global