Installing an installable image (Windows)

To install a product image locally in a Windows environment,

  1. Open a command prompt.
  2. Change to the directory that contains the image files.
  3. If you selected the option to compress the image, unzip the file by entering the following command:
    cizip.exe -u filename directory
    The option filename is the name of the .zip file that contains the installable image directories and files, and the option directory 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.
  4. Change to the directory where the unzipped files are located.
  5. Launch the installation utility by entering the following command:
    install.exe options
    For options, enter any command line options that you want to specify as listed in the following table.

  6. You can optionally unzip the file and automatically start the installation by entering the following command:
    cizip.exe -u -x filename directory
    The -x option launches the installation utility after the file is unzipped. If you choose this option, you cannot specify any of the command line options listed in the following table. 
     Installable image command line options for Windows 

    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 file name 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 c:\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 c:\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 file name 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 file name 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 listed in 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.

    -no_change_exe

    lets you install the image on a computer running Windows 2000 Terminal Services, Windows NT Terminal Server Edition, or Windows Server 2003 Terminal Services if the change.exe file does not exist on the computer. The installation utility uses the change.exe file to change the installation mode of a computer running these services. If the file is not found, the installation will fail. To use this option, you must launch the installation utility from the Add/Remove Programs utility. For details on using this option, see Command line optionsCommand line options .

    -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 file name 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 output messages to standard output instead of to a log file.

    -skipuserright

    keeps the installation utility from assigning user rights to a default installation account, if such an account is required for a product installation; this option also keeps the installation utility from unassigning user rights during a product uninstallation. If you use this option, you must set the user rights manually. For details on using this option, see Command line optionsCommand line options .

    -shutdownservice min

    lets you increase the number of minutes that the installation utility waits for a service to shutdown before proceeding with an installation. For details on using this option, seeCommand line optionsCommand line options .

The installation utility runs and installs the products associated with the image to the installation directory that you specified 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 until the installation is complete. 

Log files are created and stored in the user's profile directory under Application Data\BMCinstall 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. 

For Windows NT environments, the default directory is: 

C:\Winnt\Profiles\username\Application Data\BMCinstall 

For Windows 2000, Windows XP, and Windows Server 2003 environments, the default directory is: 

C:\Documents and Settings\username\Application Data\BMCinstall 

In previous releases of the installation utility, log files were stored in the same directory as the installable image files.

Product installation directory structure

When you install products or create an installable image, you will need to provide the name of a directory into which the products that you select will be installed. The installation utility provides a default directory that you can use, or you can enter a new directory.

Warning

You cannot enter a root directory as the product installation directory for BMC products, because if you uninstall products from that directory, you may unintentionally uninstall products other than BMC products. If you need to install into a root directory to install a product upgrade, you can create an installable image and specify the root directory as the installation directory for the products in the image; however, if you need to uninstall the products from the root directory, do not use the uninstall-all.ctl file to perform the uninstall.

Warning

Product installation directories are stored in installation utility history files as full path names; therefore, do not rename the product installation directory after you install products, because the installation utility will be unable to find the renamed directory if you uninstall products.

  By default, the installation utility uses c:\Program Files\BMC Software as the product installation directory. When you install products, the installation utility creates a subdirectory in the product installation directory for each product that you install and the following additional subdirectories that store information required by the installation utility:

  • Install\insthist --stores files that contain installation utility history information, such as which products you installed during a particular installation session
  • itools --stores utilities that may be used by the products that you install
  • Uninstall\Install\instbase --stores the Perl binaries and the Perl HTTP server code; Perl is used by installation utility to install products
  • Uninstall\Install\instbin --stores the installation engine binaries and installation tools such as ctltool
  • Uninstall\Install\instcommon --stores the xml files that are used to format and display the standard installation utility pages
  • Uninstall\Install\instdata --stores default text files that control the order of the list of products that you can select to install and the order in which the products are installed, and that list the operating systems that are recognized by the installation utility

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*