Install as an administrator, nonadministrator, or group
- Save credentials when sharing the same instance of Installation Manager
- Identify the current mode
- Notes for installing on Windows platforms
- Notes for installing in group mode
- Installation default settings
- Install commands
- Uninstall commands
Save credentials when sharing the same instance of Installation Manager
Create a keyring that only you can access when saving credentials using the Save Password option for a shared instance of Installation Manager. If you do not specify your own keyring, other users can use your saved credentials. Create a keyring using the -keyring and -password options with IBMIM , imcl or imutilsc saveCredential .
Multiple users can use the same instance of Installation Manager in group mode or administrator mode. Some repositories might require credentials. When you use the Save Password option without specifying a keyring that only you can access, other users can use your credentials to access the repository.
If you do not save your credentials, you are prompted to enter your credentials each time you access the repository.
Identify the current mode
To identify the mode that you are currently running Installation Manager in, click...
-
File | View Log | log_file | Log filters icon
| Information
...and locate entry:
-
Installation Manager mode: mode
To identify the user that is running Installation Manager, locate the entry:
user.name: user, mode
Notes for installing on Windows platforms
Group mode is not available on Windows operating systems.
Use the -accessRights argument to specify whether to install software in administrator or nonadministrator mode:
- To install software as an administrator use the -accessRights admin argument and option
- To install software as a nonadministrator use the -accessRights nonAdmin argument and option.
If you do not use the -accessRights argument in the command, the default value is set based on current user permissions. For example, when Installation Manager is installed with nonadministrator access rights, Installation Manager cannot install packages with administrator access rights. The packages are installed with nonadministrator rights.
For Microsoft Windows XP Professional users who are members of an administrator group, the default is always the -accessRights admin argument and option. For Windows XP Professional users to run in nonAdmin mode, you must pass the -accessRights nonAdmin argument explicitly in the command.
On Windows Vista, Windows 2008, and Windows 7, you must run the following commands in admin mode:
- install.exe
- installc.exe
- uninstall.exe
- uninstallc.exe
You cannot run these commands in nonadministrator or group mode. To run in nonadministrator mode, you must use these commands: userinst.exe, and userinstc.exe. Group mode is not available on Windows.
In some cases, installing IBM software products on Windows Vista, Windows 2008, and Windows 7 requires the use of the Run as administrator option. See Run silent installation commands on Windows Vista, Windows 2008, and Windows 7 for more information.
The install.exe and userinst.exe commands install Installation Manager into different directories. Changes that you make to the administrator installation of Installation Manager do not affect the nonadministrator installation of Installation Manager. And changes that you make to the nonadministrator installation of Installation Manager do not affect the administrator installation of Installation Manager. Each instance of Installation Manager must have its own installation directory and agent data location.
Notes for installing on Linux, UNIX, IBM i and z/OS platforms
You must have execute permission on Installation Manager directories, package directories and parent directories. If you do not have execute permission, Installation Manager cannot access the child directories or files. Without this permission, unexpected behavior or failures can occur when using Installation Manager.
Notes for installing in group mode
Before installing and running Installation Manager in group mode on Linux, UNIX and z/OS computers:
- Review the Group mode road maps .
- Set the primary group for each user to the group that is sharing the instance of the group Installation Manager. If the primary group is not set, the user must run chgrp to change the group associated with the user's installed files.
- Set the default permission settings for each user in the group.
- If you want to change the location of group mode shortcuts from the default value before installing Installation Manager, you must define an environment variable.
- To run Installation Manager in group mode, all users in the group must have read/write privileges to the installation directory and the agent data location. See Agent data location for information about changing the agent data location from the default directory location.
When you install Installation Manager in group mode, the installation location and agent data location both default to the current user's home directory. This directory might not be accessible to all users in the group. Instead of accepting the default values, define an installation location and agent data location that all users have read/write privileges to.
Check your product information center to see if the package you are installing supports group mode. If the package you are trying to install in group mode is not enabled for group mode, you receive an error and cannot continue with the package installation. You can use administrator or nonadministrator mode to install packages when group mode is not enabled.
Group mode is only available in enabled products running on Linux, UNIX, Solaris, AIX, and z/OS platforms. Group mode is not available on Windows and IBM i platforms.
Installation default settings
| Administrator | Nonadministrator | Group | |
|---|---|---|---|
| Windows: Display of Installation Manager in Windows menu and Add or Remove Programs | IBM Installation Manager | My IBM Installation Manager | Not available. |
| Windows: Microsoft registry key | HKEY_LOCAL_MACHINE\Software\IBM\Installation Manager | HKEY_CURRENT_USER\Software\IBM\Installation Manager | Not available. |
| Default installation directory | Windows: C:\Program
Files\IBM\Installation Manager
Linux and UNIX: /opt/IBM/InstallationManager IBM i: /QIBM/ProdData/InstallationManager z/OS: /InstallationManager/bin | Windows 2000
and Windows XP Professional: C:\Documents
and Settings\user\IBM\Installation Manager
Windows Vista, Windows 2008, and Windows 7: C:\Users\users\IBM\Installation Manager Linux and UNIX: /user_home/IBM/InstallationManager IBM i: /user_home/IBM/InstallationManager z/OS: /user_home/InstallationManager/bin | Linux and UNIX: /user_home/IBM/InstallationManager_Group
z/OS: /InstallationManager/bin |
| The eclipse\tools directory is a subdirectory of the installation directory. | headers="d3957e656 d3957e658 d3957e660 ">Windows: installation_directory\eclipse\tools
Linux, UNIX, IBM i and z/OS: installation_directory/eclipse/tools See Locating the tools directory for information about the tools directory in the installer. | ||
| Default registry file location | Linux and UNIX: /etc/.ibm/registry/InstallationManger.dat
IBM i: /QIBM/InstallationManager/.ibm/registry z/OS: /etc/.ibm/registry/InstallationManger.dat | Linux and UNIX: /user_home/etc/.ibm/registry/InstallationManger.dat
IBM i: /user_home/etc/.ibm/registry z/OS: /user_home/etc/.ibm/registry/InstallationManger.dat | Linux and UNIX: /user_home/var/ibm/InstallationManager_Group./etc/.ibm/registry/InstallationManager.dat
z/OS: /InstallationManager/appdata/.etc/.ibm/registry/InstallationManager.dat |
| Default agent data location
Do not change the content, files, or directories in the Agent data location directory or subdirectories. Changes to these contents can prevent Installation Manager from working. | Windows 2000 and Windows XP Professional: C:\Documents and Settings\All
Users\Application Data\IBM\Installation Manager
Windows Vista, Windows 2008, and Windows 7: C:\ProgramData\IBM\Installation Manager Linux and UNIX: /var/ibm/InstallationManager IBM i: /QIBM/InstallationManager/.ibm/registry/InstallationManager.dat z/OS: /InstallationManager/appdata | Windows 2000 and Windows XP Professional: C:\Documents and Settings\user\Application
Data\IBM\Installation Manager
Windows Vista, Windows 2008, and Windows 7: C:\Users\user\AppData\Roaming\IBM\Installation Manager Linux and UNIX: /user_home/var/ibm/InstallationManager IBM i: /user_home/etc/.ibm/registry/InstallationManager.dat z/OS: /user_home/InstallationManager/appdata | Linux and UNIX: /user_home/var/ibm/InstallationManager_Group
z/OS: /InstallationManager/appdata |
| The Eclipse log is located in a subdirectory of the agent data directory. | headers="d3957e656 d3957e658 d3957e660 ">Windows: agent_data_directory\pluginState\.metadata\.log
Linux, UNIX, IBM i and z/OS: /agent_data_directory/pluginState/.metadata/.log | ||
| The uninstall directory is a subdirectory of the agent data directory. | headers="d3957e656 d3957e658 d3957e660 ">Windows: agent_data_directory\uninstall
Linux, UNIX, IBM i and z/OS: /agent_data_directory/uninstall | ||
Install commands
Only one administrator instance of Installation Manager can be installed. For nonadminstrators, install only one instance of Installation Manager for each user.
| Installation Manager installation goal | Windows commands | Linux and UNIX commands | IBM i commands |
|---|---|---|---|
| An administrator installs Installation Manager for all users. | install.exe
or installc.exe to install silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent installation command for versions 1.4.2 and earlier: installc.exe --launcher.ini silent-install.ini | #install
or #installc to install silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent installation command for versions 1.4.2 and earlier: #install --launcher.ini silent-install.ini | #installc to install silently |
| A nonadministrator installs Installation Manager for all users. | Windows 2000
and Windows XP Professional:
You cannot install Installation Manager for all users as a nonadministrator.
Windows Vista, Windows 2008, and Windows 7: install.exe or installc.exe to install silently
| $sudo install
or $sudo installc to install silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent installation command for versions 1.4.2 and earlier: $sudo install --launcher.ini silent-install.ini | #userinstc to install silently |
| Installs Installation Manager for all users in group mode. | Not available. | #groupinst
or #groupinstc -dataLocation appdata_loc to install silently You can customize the install.xml file with additional configuration, such as the directory to install Installation Manager. | Not available. |
| An administrator installs Installation Manager only for the current user. | userinst.exe
or userinstc.exe to install silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent installation command for versions 1.4.2 and earlier: userinstc.exe --launcher.ini user-silent-install.ini | #userinst
or #userinstc to install silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent installation command for versions 1.4.2 and earlier: #userinst --launcher.ini user-silent-install.ini | #userinstc to install silently |
| A nonadministrator installs Installation Manager only for the current user. | userinst.exe
or userinstc.exe to install silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent installation command for versions 1.4.2 and earlier: userinstc.exe --launcher.ini user-silent-install.ini | $userinst
or #userinstc to install silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent installation command for versions 1.4.2 and earlier: #userinst --launcher.ini user-silent-install.ini | #userinstc to install silently |
Windows does not support using the install.exe or userinst.exe commands for silent installation. Use either the installc.exe or userinstc.exe command for silent installation. Group mode is not available on Windows platforms.
Uninstall commands
| Goal for uninstalling Installation Manager | Windows commands | Linux and UNIX commands | IBM i commands |
|---|---|---|---|
| An administrator uninstalls Installation Manager for all users. | uninstall.exe
or uninstallc.exe to uninstall silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent uninstall command for versions 1.4.2 and earlier: uninstallc.exe --launcher.ini silent-uninstall.ini | #uninstall
or #uninstallc to uninstall silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent uninstall command for versions 1.4.2 and earlier: #uninstall --launcher.ini silent-uninstall.ini | #uninstallc to uninstall silently |
| A nonadministrator uninstalls Installation Manager for all users. | Windows XP
Professional and Windows 2000:
You cannot uninstall Installation Manager for all users as a nonadministrator.
Windows Vista, Windows 2008, and Windows 7: uninstall.exe or uninstallc.exe to uninstall silently
| $sudo uninstall
or $sudo uninstallc to uninstall silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent uninstall command for versions 1.4.2 and earlier: $sudo uninstall --launcher.ini silent-uninstall.ini | #uninstallc to uninstall silently |
| Uninstalls Installation Manager for all users in group mode. | Not available. | #uninstall
or #uninstallc to uninstall silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent uninstall command for versions 1.4.2 and earlier: #uninstall --launcher.ini silent-uninstall.ini | Not available. |
| An administrator uninstalls Installation Manager for only the current user. | userinst.exe
or userinstc.exe to uninstall silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent uninstall command for versions 1.4.2 and earlier: userinstc.exe --launcher.ini user-silent-uninstall.ini | #uninstall
or #uninstallc to uninstall silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent uninstall command for versions 1.4.2 and earlier: #uninstall --launcher.ini user-silent-uninstall.ini | #uninstallc to uninstall silently |
| A nonadministrator uninstalls Installation Manager for only the current user. | userinst.exe
or userinstc.exe to uninstall silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent uninstall command for versions 1.4.2 and earlier: userinstc.exe --launcher.ini user-silent-uninstall.ini | $uninstall
or #uninstallc to uninstall silently Starting with version 1.4.3, --launcher.ini .ini file is deprecated. Silent uninstall command for versions 1.4.2 and earlier: #uninstall --launcher.ini user-silent-uninstall.ini | #uninstallc to uninstall silently |
For information about silent installation command arguments, see Installation Manager command-line arguments .
See also