Installing an installable image on a UNIX computer
Before you begin
You must have created the installable image and deployed it to the target UNIX computer.
To install a product image locally on a UNIX computer
- Change to the directory that contains the image files.
- If you selected the option to compress the image, unzip the file by entering the following command:
./cizip.sh -u filename directory
The -u option unzips the file, the filename option is the name of the .zip file that contains the installable image directories and files, and the directory option is the path to the directory where the files will be placed after they are extracted from the .zip file. If you specify a directory that does not exist, the directory will be created. If you do not specify a drive with the directory name, the directory will be created in the same directory where the .zip file is located. - Change to the directory where the unzipped files are located.
- Launch the installation utility by entering the following command:
./install.sh options
For options, enter any command line options that you want to specify as listed in the following table. - You can optionally unzip the file and automatically start the installation by entering the following command:
./cizip.sh -u -x filename directory
The -x option launches the installation utility after the file is unzipped. A platform-specific script is stored in the /tmpdirectory and the installation is run from that script. The script is not removed after the installation is complete. If you choose the -x option, you cannot specify any of the command line options listed in the following table.
Installable image command line options for UNIX
Option | Definition |
|---|---|
-v | displays the installation utility version on the command line then returns to the command line prompt |
-h | displays the available command line options |
-path directory | lets you specify the path name to the installable image if you are not in the same directory |
-log location filename | lets you specify the location where you want to store the comprehensive log file and the name of the log file to be stored in that location. You can specify a complete path and filename or just the file name. If you specify just the file name, the log file is stored in the same directory where the installable image files are located. The location and file naming convention that you use for this option will also be used for the product log, user log, and standard output log unless you use the additional command line options to specify the location and file names for these log files. For example, if you name the comprehensive log file testing.log and store the log file in a directory called /install/logfiles, the product log file will be named testing-product.log, the user log file will be named testing-user.log, and the standard output log will be named testing-output.log and these log files will also be stored in the /install/logfiles directory. |
-productlog location filename | lets you specify the location where you want to store the product log file and the name of the product log file to be stored in that location. You can specify a complete path and filename or just the file name. If you specify just the file name, the log file is stored in the same directory where the installable image files are located. |
-userlog location filename | lets you specify the location where you want to store the user log file and the name of the user log file to be stored in that location. You can specify a complete path and filename or just the file name. If you specify just the file name, the log file is stored in the same directory where the installable image files are located. |
-install location filename | installs the products from a control file stored in the location that you specify. If the location is not specified, the installation utility looks for the control file in the directory where the image was created. |
-output location filename | lets you specify the location where you want to store the standard output log file and the name of the log file to be stored in that location. You can specify a complete path and filename or just the file name. If you specify just the file name, the log file is stored in the same directory where the installable image files are located. |
-nooutput | lets you send the output messages to standard output instead of to a log file. |
-no_backup | while upgrading the PATROL Agent, by default the common installer creates a backup. If this option is enabled, then it does not creates backup. |
The installation utility runs and installs the products associated with the image to the installation directory that you specified in the installation utility when you created the image. When the process is complete, one of the following status messages is displayed on the command line:
- The installation completed successfully
- The user log contains the following fatal messages and a list of the messages
- The product log contains the following non-fatal messages and a list of the messages.
No status messages are displayed on the command line until the installation is complete.
Log files are created and stored in the $HOME/BMCINSTALL directory unless you use one of the command line options listed in the following table to redirect them to another location. If you use the -log command line option only, all log files will be stored to the same location and with the same file naming convention that you specify for the -log option. In previous releases of the installation utility, log files were stored in the same directory as the installable image files.