Starting Installation Manager

You can use different options to manually start the Installation Manager wizard.

From the installation location of Installation Manager, you can run the IBMIM application file to start Installation Manager in wizard mode manually.

Note:

For Windows, use IBMIM.exe. The launcher.exe is deprecated.

For Linux, UNIX, and the OS X operating system, use the ./IBMIM command. The ./launcher command is deprecated.

Table 1. Default installation locations for application files
Operating system Administrator Nonadministrator Group
Windows XP Professional C:\Program Files\IBM\Installation Manager C:\Documents and Settings\user\IBM\Installation Manager\eclipse Not available.
Windows Vista, Windows 2008, Windows 7, Windows 8, and Windows 2012 C:\Program Files [(x86)]\IBM\Installation Manager\eclipse C:\Users\user\IBM\Installation Manager\eclipse  
Linux and UNIX /opt/IBM/InstallationManager/eclipse /user_home_directory/IBM/InstallationManager/eclipse /user_home_directory/IBM/InstallationManager_Group/eclipse
OS X operating system /Applications/IBM/Installation Manager/eclipse /Users/user/var/ibm/Installation Manager/eclipse /Users/user/var/ibm/Installation Manager Group/eclipse
Note:
  • On the OS X operating system, you might be prompted to enter your credentials to run Installation Manager with administrator privileges.
  • Some platforms do not support the graphical user interface (GUI) for Installation Manager. See the System Requirements technical document.

Using a response file to start Installation Manager

About this task

You can start Installation Manager in wizard mode by using a response file. Your response file can contain commands for only one of the wizards: Install, Update, Modify, Rollback, or Uninstall.

Procedure

  1. Open a command-line utility.
  2. Open the eclipse directory.
    • Windows: install_dir\IBM\Installation Manager\eclipse
    • Linux and UNIX: install_dir/IBM/InstallationManager/eclipse
    • OS X operating system: install_dir/IBM/Installation Manager/eclipse
  3. Run the command to start Installation Manager with the input option and response file. Based on the commands in the response file, Installation Manager starts in one of these wizards: Install, Update, Modify, Rollback, or Uninstall. If the response file does not contain the commands for the wizards, Installation Manager opens to the main screen. Preference and repository settings from the response file take precedence over settings in Installation Manager.

Example

Table 2. Start commands that use a response file by operating system
Operating system Command
Windows IBMIM input response_file
Linux, UNIX, and the OS X operating ./IBMIM input response_file

Starting Installation Manager in another language

From the command line, you can start Installation Manager by specifying a language.

About this task

The following list contains the languages and the language codes that are currently supported by Installation Manager:
  • Arabic (ar)
  • Brazilian Portuguese (pt_BR)
  • Catalan (ca)
  • Croatian (hr)
  • Czech (cs)
  • Danish (da)
  • Dutch (nl)
  • English (en)
  • Finnish (fi)
  • French (fr)
  • German (de)
  • Greek (el)
  • Hebrew ( iw)
  • Hungarian (hu)
  • Indonesian (in)
  • Italian (it)
  • Japanese (ja)
  • Korean (ko)
  • Lithuanian (lt)
  • Norwegian (no)
  • Polish (pl)
  • Portuguese (pt)
  • Russian (ru)
  • Simplified Chinese (zh_CN)
  • Slovak (sk)
  • Slovenian (sl)
  • Spanish (es)
  • Swedish (sv)
  • Thai (th)
  • Traditional Chinese (zh_HK)
  • Traditional Chinese (Taiwan) (zh_TW)
  • Turkish (tr)
Note: Some languages support only partial translations. When a language is partially translated, the non-translated content is presented in English.

Procedure

  1. Open a command-line utility.
  2. Open the eclipse directory.
    • Windows: install_dir\IBM\Installation Manager\eclipse
    • Linux and UNIX: install_dir/IBM/InstallationManager/eclipse
    • OS X operating system: install_dir/IBM/Installation Manager/eclipse
  3. Run the command to start Installation Manager with the -nl option and abbreviated language code. Installation Manager opens in wizard mode in the language that you specified.

Example

Table 3. Start commands by operating system
Operating system Command
Windows IBMIM -nl language_code
Linux, UNIX, and the OS X operating system ./IBMIM -nl language_code

Starting Installation Manager with the -secureStorageFile option

About this task

You can start Installation Manager in wizard mode with the -secureStorageFile and -masterPasswordFile options. The credentials that you use for this instance of Installation Manager are stored in the secure storage file. For information about these options, see Command-line arguments for the imcl command.

Procedure

  1. Open a command-line utility.
  2. Open the eclipse directory.
    • Windows: install_dir\IBM\Installation Manager\eclipse
    • Linux and UNIX: install_dir/IBM/InstallationManager/eclipse
    • OS X operating system: install_dir/IBM/Installation Manager/eclipse
  3. Run the command to start Installation Manager with the -secureStorageFile and -masterPasswordFile options.

Example

Table 4. Start commands that use the -secureStorageFile option
Operating system Command
Windows IBMIM -secureStorageFile storage_file -masterPasswordFile master_password_file
Linux, UNIX, and the OS X operating system ./IBMIM -secureStorageFile storage_file -masterPasswordFile master_password_file

What to do next

When you store credentials for a repository, the credentials are saved to the secure storage file.
Note: Starting in version 1.7, if you do not specify the -secureStorageFile and -masterPasswordFile options, Installation Manager uses the Equinox Secure Storage mechanism from Eclipse by default to store credentials and generate a default storage file that is secured with a predefined password. In older versions, a key ring file was used to store the credentials by default. The key ring file is not supported by version 1.6.2 and later.
Note: After you upgrade to version 1.7 or later, you cannot authenticate with secure storage files that were created in an earlier version. You must re-create those secure storage files.

Starting Installation Manager with the -enterpriseDeploymentTools option

About this task

In version 1.7.2 and later, you can start Installation Manager with the -enterpriseDeploymentTools option. When you use the -enterpriseDeploymentTools option, you can select what deployment tool to start. You can start the tool to generate a response file by recording the installation without installing the packages, or you can generate a response file for the installed packages.

Procedure

  1. Open a command-line utility.
  2. Open the eclipse directory.
    • Windows: install_dir\IBM\Installation Manager\eclipse
    • Linux and UNIX operating systems: install_dir/IBM/InstallationManager/eclipse
    • OS X operating system: install_dir/IBM/Installation Manager/eclipse
  3. Run the command to start Installation Manager with the -enterpriseDeploymentTools option.
  4. In the dialog that opens, select the enterprise deployment tool that you want to start.

Example

Table 5. Start commands that use the -enterpriseDeploymentTools option
Operating system Command
Windows IBMIM -enterpriseDeploymentTools
Linux, UNIX, and the OS X operating system ./IBMIM -enterpriseDeploymentTools

Feedback