Progress Sonic 8.5 Installation and Upgrade Guide - Product ...

5. Save the file without changing its name.
Running the Container Setup Utility
6. Position the file so that it can be read on its intended host system where a Sonic
Launcher installation is available.
Running the Container Setup Utility
The container setup utility creates the working directory for the container. Parameters of
the setup command locate the setup file, provide the credentials for the administrator to
connect to the domain, and optionally encrypt the container.ini file in the container’s
working directory. The parameters are:
● propertiesFile — The path for the text file that provides the container setup
properties in the domain that will manage the container. Required. If any part of the
path contains a space, delimit the name in quotes; e.g., /c “C:\New Container.setup”
● user — The username to be used to establish a direct connection to the management
broker(s). The user must have administrative permissions for this task. Required if the
management broker is security enabled. Default value is Administrator.
● userPassword — The connection user's password to authenticate the user’s
credentials in the management broker’s authentication domain. Required if the
management broker is security enabled. Default value is Administrator.
● encryptionPwd — An encryption key is derived from this password and used to
encrypt the container.ini file generated by the setup to the container’s working
directory. If you choose encryption, be sure to note the container name and password
in a secured location. Encryption is not required.
◆ To setup a container on Windows:
1. Open a console window in an installation’s Launcher directory.
2. Change to the appropriate version’s directory, such as, 8.5.0.392
3. Change to the container_setup directory
4. Enter setup.bat with the appropriate parameters in the form:
setup.bat /c propertiesFile /u user /p userPassword /e encryptionPwd
The container is setup and, if the option to create a Windows Service was selected, the
Windows Service is setup, named Sonic container_name Service.
◆ To setup a container on UNIX/Linux:
1. Open a console window in an installation’s Launcher directory.
Progress Sonic Installation and Upgrade Guide 8.5 131