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
Option | Definition |
|---|---|
| Installation | |
| 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. |
-h
This option displays the list of command line options.
Command format
./setup.sh -h
Options
None.
-createcontrolfile
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.
Command format
./setup.sh -createcontrolfile
Options
None.
- 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.
Command format
./setup.sh -host_override hostname
./setup.sh -serveronly -host_override IPaddress
Options
None.
-locale locale
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.
Command format
./setup.sh -locale en_US
Options
Language | Option |
|---|---|
English | en_US |
Traditional Chinese | zh_TW |
Simplified Chinese | zh_CN |
Korean | ko_KR |
Japanese | ja_JP |
-override_file location
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:
ftp://ftp.bmc.com/pub/patrol/patches/COMMON_INSTALL_override.dat*
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.
Command format
./setup.sh -override_file /tmp/override.dat
Options
None.
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.
-port portnum
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.
Command format
./setup.sh -port 3184
./setup.sh -serveronly -port 3184
Options
Any number from 1025 to 65534.
-releaseversion version
In a PATROL environment, this option lets you install a new KM into an existing PATROL environment.
Command Format
./setup.sh -releaseversion 3.4
Options
Option | Description |
|---|---|
3.2 | for 3.2.x platforms and components |
3.3 | for 3.3.x platforms and components |
3.4 | for 3.4.x platforms and components |
3.5,7.1 | for 3.5.x and 7.1.x platforms and components. These options should always be specified together. |
7.2 | for 7.2 platforms and components. |
7.4 | or 7.4 platforms and components. This is the default for this version of the installation utility. |
-repository_designator role
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.
Command format
./setup.sh -repository_designator PAT/PAA
Options
Depends on the products that you are installing. See the sysrole.xml file for valid options.
-serveronly
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 Creating and deploying an installable image for UNIX computers.
Command format
./setup.sh -serveronly
./setup.sh -serveronly -port 3184
Options
None.
-timeout seconds
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.
Command format
./setup.sh -timeout 120
Options
Any number from 120 to 500.
-trace
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.
Command format
./setup.sh -trace
Options
None.
Using this option causes the installation utility to record passwords unencrypted in the installation log files.
-v
This option displays a dialog box that shows the version number for the installation utility.
Command format
./setup.sh -v
Options
None.
Comments
Log in or register to comment.