Summary:
This release introduces orjarinstall.py, a Python script designed to simplify the deployment of OpenROAD server applications from a single, portable archive. This tool automates the process of extracting and placing various application components—such as shared libraries, configuration files, and application images—into their correct directories within your OpenROAD environment.
Usage
Deploy an OpenROAD application by running the script with the path to your .zip archive.
python orjarinstall.py orjarfileorjarfile: The path to the.ziparchive containing the server application and other resources. An example archive,orserver-add-l2pserver.zip, is attached to this release as a sampleorjarfile.
Supported Archive Directories
The orjarinstall.py script automatically processes the following subdirectories found within your application archive:
libu3gl: Shared libraries/DLLsnetutil: Netutil command scriptsorjsonconfig: JSON configuration files for server applicationsorserveradm_removeapp: JSON files for theorserveradm.pyRemoveApp commandorserveradm_addapp: JSON files for theorserveradm.pyAddApp commandresource: Additional resource directories for deploymentw4glapps: OpenROAD Server application images
Preconditions
Before running the script, ensure the following are configured in your environment:
II_SYSTEM: The environment variableII_SYSTEMmust be set.COMPUTERNAME: This must be set if you don't provide a"serverlocation"when using theAddAppcommand.orjarinstall_cfg.json: This optional JSON configuration file should exist in$II_SYSTEM/ingres/files. It can be used to customize the deployment directories for various components. If this file doesn't exist, the script uses default locations.
The JSON configuration file can contain the following members:
libu3gldir: Directory for shared libraries/DLLs.orjsonconfigdir: Directory for JSON config files.resourcedir: Directory for resource files.w4glappsdir: Directory for 4GL image files.