Upgrade

Prev Next

Package content

The Discngine LiveDesign Connector for Pipeline Pilot package contains:

  • ldconn.zip: the Pipeline Pilot collection developed to interact with LiveDesign into Pipeline Pilot protocols
  • web: the gadget application to be deployed on the LiveDesign server
  • PoweredBy.md: the list of third-party components used and their associated license

This package is available in the download center.

Prerequisite

  • Licenses

    • License key is required to use the Connector, please contact us to get it
  • Server

    • BIOVIA® Pipeline Pilot version 2022, 2023 or 2024 with secured protocol (HTTPS)
    • Schrödinger® LiveDesign version 2022+, 2023+ or 2024+ with secured protocol (HTTPS)
  • Access and permission

    • BIOVIA® Pipeline Pilot: remote access to the Pipeline Pilot server and rights to install packages on it and restart Apache server
    • Schrödinger® LiveDesign: administrator role and SSH access to the LiveDesign server, with rights to edit the nginx configuration and restart nginx server

Upgrading LiveDesign configuration

If you are upgrading to 3.6+, ensure that these instructions have been followed:

Also note that the "Unrestricted" configuration for the "Job Directory Web Access" is no longer required.

If you are upgrading to 3.2+, ensure that you have the correct configuration for the nginx server.
See the Gadget deployment section for more details.

Upgrading Pipeline Pilot package

Gadget permissions

A bug from BIOVIA creates issues with group names including spaces. The group Discngine/LiveDesign Connector/Administrators was kept for backward compatibility reason but it is highly recommended to use only the group Discngine/LiveDesignConnector/Administrators introduced in version 3.4.46 and to move associated users and subgroups into this new group.

  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. Ensure that the gadget is correctly deployed depending on your installation (See the LiveDesign installation section)

  7. Ensure that the security configuration for Pipeline Pilot server is correctly setup (See the Pipeline Pilot server configuration section)

  8. Restart the Apache server:

    • Open the Pipeline Pilot server administration page
    • Navigate to Maintenance > Manage Server in the left pane
    • Press the "Restart Apache" button
  9. 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 release 3.6 the new LiveDesignSessionIdUrl global property has been added and must be filled. 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 the properties:
Property Description Required Default Value
LiveDesignServerUrl URL of your LiveDesign server, e.g. https://ldserver.yourcompany.com. Yes
LiveDesignSessionIdUrl URL for obtaining your current LiveDesign SessionId, used for authentication when executing Pipeline Pilot protocols; depending on your configuration (on premise or cloud deployment), e.g. https://ldserver.yourcompany.com/discngine/ldconn/session/ Yes
LiveDesignVersion The version of your LiveDesign server (values available are listed in the compatibility documentation). Yes 8.11
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 (only used by deprecated components). No Global
DefaultProjectID ID of the LiveDesign project that will be used by components by default. Yes 0
GadgetMenuPath Path of the file that will be used as gadget menu. Yes $(SharedPublicDir)/Discngine/composer/menu.json