InterPlay 2.3.0 Installation Guide Start installation Locate and run the setup file in the root folder of the installation package. GUI mode: UNIX/Linux: setup.sh Windows: setup64.exe Console mode: UNIX/Linux: setup.sh -m console Windows: setup64.exe -m console For more information about the installer, refer to Installer Refer to the Worksheet for a list of all possible fields displayed during installation. Installation parameters Installation folder An Axway product is installed in its own installation folder. Do not install several products in the same folder, except for Composer and the Enablers. This product does not support installation in a path containing spaces. Installation type For a quick installation, select the Standard option in the Installation Type screen. License agreement There are some differences for reviewing the end-user license agreement (EULA) in GUI and console modes. In GUI mode Read the EULA and click I agree if you accept its terms and conditions. This also lets you continue to the next page. You can also print the license agreement by clicking the print link. You must have a web browser installed for this otherwise the page will not open. Click Quit to stop the installation at any time. In console mode In console mode: A print link for the EULA is not available. If you want to read or print the EULA file, it is available in HTML or .txt format at the root folder of the installation package. Select installation architecture There are two types of installation architectures: single and cluster. You do not have the option to install cluster architecture unless you select advanced installation mode. Select the architecture type: Single: installs products on a single server (default) Cluster: recommended for failover and high availability, creates a shared directory common to all products If you select cluster architecture, an additional step displays. Specify if the installation is the First node in the cluster, or an Additional node in the cluster. Select the architecture type and click Next. Specify installation logical name On Windows an installation name is required. This is the logical name for the installation which also helps you identify where the product is located. For example: Start > Programs > Axway Software > Axway [TEST] > Product name. In this example, TEST is the installation name. The installation name also identifies the service name when you install a product as a Windows service. Specify installation directories Each Axway product is installed in its own installation folder. If you previously installed Axway products, do not install InterPlay in the same folder, except for Composer and the Enablers. Install the product in an empty directory. If you install in a directory with files, the entire directory is deleted when you uninstall. Shared Directory In case you install in a cluster architecture, you need to specify both the: Installation directory - location where the product binaries will be installed Shared directory - location where the product configuration and data will be stored Select products Select the products to install. To set the installation options for a product, click the arrow to the right of the product name and select the installation option from the drop-down list: Install Install the selected product Install all Install the selected product and all of its modules Not selected Does not install the selected product Select the bit architecture If you install InterPlay on a 64-bit platform with a 32-bit compatibility layer installed, you need to specify the bit architecture you want your product to be installed with. For each product in the list you need to choose between a 32-bit or 64-bit architecture. The default is 64 bits which you can change. For some products however, this may not be modifiable due to the Installer not being able to identify either option as true. Ready to install After configuring your product, review the installation configuration and click Install to begin installing. When the progress bar displays Installation complete, the installation is finished and displays one of the following: The install action completed successfully The install action completed with errors The install action completed with warnings Installation summary For each product, review the installation summary. The Installer displays one of the following messages: For a successful installation:Installation folderInstalled modulesUpdates applied in chain with the installation For a failed installation:Error while executing task: [task name][reason]Installation aborted by the user (if this was the case) Log file location For a failed installation, check the Installer log file. Installation log file The installation log file is located at <install directory>\install.log for error messages. This file holds the information about all actions performed on the installation in time (installation, update, configure, uninstall) and are always appended to the file. For support purposes it is extremely important that you do not tamper with this file. If it becomes too big, you can split it and archive it. If you have to contact Axway for support, consider providing all archived logs to them. The format of the log message is: Date - Date when message was logged Classifier - Type of message (DEBUG, INFO, WARN, ERROR, FATAL) Message_body - Description of error By default, Installer logs only the INFO, WARN, ERROR and FATAL messages. In case of issues you want to report to Axway Support, it is crucial that you provide the detailed log containing the DEBUG messages. To enable this type, launch the operation again with the “-d” option: setup.sh -d If you suspect the installation failed because of values you entered, check the file <install directory>\synInstall\install.properties. After the installation process is finished, go to Axway support website at https://support.axway.com for the latest service packs for your product. See the readme file for dependencies between service packs. InterPlay installation parameters Prepare the installation by filling out your product worksheet, see Worksheet. Related Links
Start installation Locate and run the setup file in the root folder of the installation package. GUI mode: UNIX/Linux: setup.sh Windows: setup64.exe Console mode: UNIX/Linux: setup.sh -m console Windows: setup64.exe -m console For more information about the installer, refer to Installer Refer to the Worksheet for a list of all possible fields displayed during installation. Installation parameters Installation folder An Axway product is installed in its own installation folder. Do not install several products in the same folder, except for Composer and the Enablers. This product does not support installation in a path containing spaces. Installation type For a quick installation, select the Standard option in the Installation Type screen. License agreement There are some differences for reviewing the end-user license agreement (EULA) in GUI and console modes. In GUI mode Read the EULA and click I agree if you accept its terms and conditions. This also lets you continue to the next page. You can also print the license agreement by clicking the print link. You must have a web browser installed for this otherwise the page will not open. Click Quit to stop the installation at any time. In console mode In console mode: A print link for the EULA is not available. If you want to read or print the EULA file, it is available in HTML or .txt format at the root folder of the installation package. Select installation architecture There are two types of installation architectures: single and cluster. You do not have the option to install cluster architecture unless you select advanced installation mode. Select the architecture type: Single: installs products on a single server (default) Cluster: recommended for failover and high availability, creates a shared directory common to all products If you select cluster architecture, an additional step displays. Specify if the installation is the First node in the cluster, or an Additional node in the cluster. Select the architecture type and click Next. Specify installation logical name On Windows an installation name is required. This is the logical name for the installation which also helps you identify where the product is located. For example: Start > Programs > Axway Software > Axway [TEST] > Product name. In this example, TEST is the installation name. The installation name also identifies the service name when you install a product as a Windows service. Specify installation directories Each Axway product is installed in its own installation folder. If you previously installed Axway products, do not install InterPlay in the same folder, except for Composer and the Enablers. Install the product in an empty directory. If you install in a directory with files, the entire directory is deleted when you uninstall. Shared Directory In case you install in a cluster architecture, you need to specify both the: Installation directory - location where the product binaries will be installed Shared directory - location where the product configuration and data will be stored Select products Select the products to install. To set the installation options for a product, click the arrow to the right of the product name and select the installation option from the drop-down list: Install Install the selected product Install all Install the selected product and all of its modules Not selected Does not install the selected product Select the bit architecture If you install InterPlay on a 64-bit platform with a 32-bit compatibility layer installed, you need to specify the bit architecture you want your product to be installed with. For each product in the list you need to choose between a 32-bit or 64-bit architecture. The default is 64 bits which you can change. For some products however, this may not be modifiable due to the Installer not being able to identify either option as true. Ready to install After configuring your product, review the installation configuration and click Install to begin installing. When the progress bar displays Installation complete, the installation is finished and displays one of the following: The install action completed successfully The install action completed with errors The install action completed with warnings Installation summary For each product, review the installation summary. The Installer displays one of the following messages: For a successful installation:Installation folderInstalled modulesUpdates applied in chain with the installation For a failed installation:Error while executing task: [task name][reason]Installation aborted by the user (if this was the case) Log file location For a failed installation, check the Installer log file. Installation log file The installation log file is located at <install directory>\install.log for error messages. This file holds the information about all actions performed on the installation in time (installation, update, configure, uninstall) and are always appended to the file. For support purposes it is extremely important that you do not tamper with this file. If it becomes too big, you can split it and archive it. If you have to contact Axway for support, consider providing all archived logs to them. The format of the log message is: Date - Date when message was logged Classifier - Type of message (DEBUG, INFO, WARN, ERROR, FATAL) Message_body - Description of error By default, Installer logs only the INFO, WARN, ERROR and FATAL messages. In case of issues you want to report to Axway Support, it is crucial that you provide the detailed log containing the DEBUG messages. To enable this type, launch the operation again with the “-d” option: setup.sh -d If you suspect the installation failed because of values you entered, check the file <install directory>\synInstall\install.properties. After the installation process is finished, go to Axway support website at https://support.axway.com for the latest service packs for your product. See the readme file for dependencies between service packs. InterPlay installation parameters Prepare the installation by filling out your product worksheet, see Worksheet.