Running the installation utility on UNIX computers from a command line
The following table describes the command line options that you can use when you launch the installation utility from a command line in UNIX environments and references the page numbers where you can find detailed information for each option.
Command line options for UNIX
Displays the list of command line options.
Lets you create a control file instead of perform a product installation. The control file that you create shows the list of products that would be installed and the product configuration values that the installation utility would use to perform the product installation. Use this option to debug a failed installation, look for potential problems with the installation before actually installing products, vary product configuration values to see the impact on the installation, or change the product configuration values associated with an installable image by creating a new control file to use with the image. Also, you can use this option to create a control file that you can use to perform a silent uninstallation.
Lets you override the default host name that the installation utility uses to connect to the Perl HTTP server. You can enter either a host name or an IP address. This option can be used standalone or with the -serveronly option.
Installs language-specific resource files for the language that you specify.
Lets you install previously released BMC products onto new versions of compatible platforms. With this option, you specify the location of a file that contains new platform definitions that override the platform information stored in a product's installation files. The installation files are used to communicate installation information to the installation utility when the product is installed. You can also use the override file to update the platforms that you can select when you create an installable image.
Lets you specify a port number to use to connect to the Perl HTTP server used by the installation utility to perform product installations.
Use this option to install a new KM into a previous release of PATROL.
Lets you select a system role from the command line so that only those products designated for that system role are displayed in the Select Products and Components to Install page.
Use this option if you do not have a browser on the computer on which you want to install products; lets you start the Perl HTTP server on one computer, then connect to that server using a browser on another computer.
Lets you specify the number of seconds that the installation utility will wait to connect to the Perl HTTP server before timing out.
Records detailed information about activities in the installation utility interface during installation.
Displays the version number for the installation utility.
This option displays the list of command line options.
This option lets you create a control file instead of perform a product installation. You navigate through the installation utility as you would if you were performing a product installation; however, at the end of the process, no products are actually installed. Instead, a control file is created, and the installation utility displays a link to the control file so that you can view it. The installation utility uses control files to perform product installations.
The control file that you create shows a list of the products that will be installed and the product configuration values that the installation utility will use to install the products. Use this option to help you debug a failed installation, look for potential problems with an installation before actually installing products, vary the product configuration values to see the impact on the installation, or change the product configuration values associated with an installable image by creating a new control file to use with the image. The control file is located in the $HOME/BMCINSTALL directory in a subdirectory with the naming convention computername-PID-timestamp. A subdirectory is created for each installation session
You can use this option to create a control file to perform a product uninstallation. For more details, see Uninstalling products on UNIX silently.
- host_override hostname
This option lets you override the default host name that the installation utility uses to connect to the Perl HTTP server. By default, the installation utility connects to localhost for a local product installation. If you launch the installation utility by using the -serveronly command line option, the installation utility uses the primary IP address of the computer where the Perl HTTP server is launched as the default host. This option lets you override this default so that you can specify the host name or IP address that you want the installation utility to use on computers with multiple IP addresses. This option can be used standalone or with the -serveronly option.
./setup.sh -host_override hostname
./setup.sh -serveronly -host_override IPaddress
This option lets you select and install only those products compatible with the locale (language) that you specify. You can specify only one locale. The installation utility will filter the list of products that will be displayed in the Select Products and Components to Install page to display only those products that are either specific to the locale that you specify or that do not have a locale designation.
If you do not specify an option, then the locale from the system on which you are running the installation utility is used. If the system locale is not supported by the installation utility, then the English locale, en_US, is used. This option does not change the language of the text displayed in the installation utility. The installation utility will run in English regardless of the system locale or the -locale option that you enter except as noted. In addition, you will be able to input only English characters.
If you set the -locale option to be the same as the system locale, you will install the appropriate products and language resource files, but the installation utility will run in either English or the system locale language and will accept input in either English or the system locale language.
./setup.sh -locale en_US
This option lets you specify a file (override.dat ) that will override platform definitions in product installation files so that you can:
- install previously released products onto new versions of compatible platforms.
- update the platforms that you can select when you create an installable image of products.
The product installation files contain product-specific installation instructions, such as supported platforms, that communicate to the installation utility how to install the product.
When BMC authorizes support for new platforms, Customer Support will provide a valid override.dat file with new platform definitions that you will be able to download from an ftp site located at the following URL:
After you have downloaded an updated *override.dat file, when you install products, launch the installation utility from a command line and use this option to specify the location where you downloaded the file.
Do not edit the contents of the override.dat file. The installation utility may be unable to read the edited file.
./setup.sh -override_file /tmp/override.dat
Although this functionality is being provided in this version of the installation utility, it cannot be used at this time because a valid override.dat file does not currently exist on the ftp site.
This option lets you specify a port number to use to connect to the Perl HTTP server. Use this option if the default port number to the server is locked and you want to specify another open port, or if you are using the -serveronly command line option and you need to open a port through a firewall. If not specified, the installation utility uses a default of 50001. If the default port number is in use, the installation utility increases the number by one and tries again to connect to the server.
./setup.sh -port 3184
./setup.sh -serveronly -port 3184
Any number from 1025 to 65534.
In a PATROL environment, this option lets you install a new KM into an existing PATROL environment.
./setup.sh -releaseversion 3.4
for 3.2.x platforms and components
for 3.3.x platforms and components
for 3.4.x platforms and components
for 3.5.x and 7.1.x platforms and components. These options should always be specified together.
for 7.2 platforms and components.
or 7.4 platforms and components. This is the default for this version of the installation utility.
This option lets you select a system role from a command line so that only those products specified for a particular system role will be displayed in the Select Products and Components to Install page. Each role has a specific code associated with it. The roles (codes) that you can enter vary from product to product. Valid options can be found in the sysrole.xml file in the /Index directory of the product image that you are installing from. If you specify this option, the Select System Roles page will not be displayed in the installation utility.
./setup.sh -repository_designator PAT/PAA
Depends on the products that you are installing. See the sysrole.xml file for valid options.
This option lets you start the Perl HTTP server on one computer, then connect to that server using a browser on another computer. Use this option if you do not have a browser on the computer where you want to install products. When you launch the installation utility with this command line option, the Perl HTTP server is started, and a message box is displayed that shows a URL. Leave this message box open. On the computer with the browser, start the browser and enter the URL displayed in the message box to connect to the Perl HTTP server.
By default, this option uses port number 50001 to connect to the Perl HTTP server. If that port is busy, the installation utility automatically increases the number by one and tries again to connect. You can specify the port that you want to use by using the -port command line option with this option.
The -serveronly command line option is not secure over a network and using it in an unsecured network environment could result in security violations. If this is an issue for your environment, you may want to consider either performing only local installations or creating an installable product image that can be sent to a remote computer and installed on it locally, rather than installing over an unsecured network. For details on creating an installable image, see
./setup.sh -serveronly -port 3184
This option lets you specify the number of seconds that the installation utility will wait to connect to the Perl HTTP server before timing out.
./setup.sh -timeout 120
Any number from 120 to 500.
This option lets you record detailed information about what is happening in the installation utility interface during a product installation. The installation utility adds this information to the beginning of the standard log file. You can view the standard log file from the installation utility when the installation is complete. This option also saves the control file that the installation utility uses to install products. Normally, the installation utility deletes the control file after the installation is complete. You can use the saved control file and the information generated by this option for debugging. For information where to find installation log files, see Locating log files on UNIX computers.
Using this option causes the installation utility to record passwords unencrypted in the installation log files.
This option displays a dialog box that shows the version number for the installation utility.