Installing the Update Installer interactively
You can install the WebSphere Commerce Update Installer (UPDI) through an interactive method that uses a graphical installation wizard. The following steps describe how to install the WebSphere Commerce Update Installer interactively.
Before you begin
- Log on:
- As a root user
- Or as a non-root user that owns WC_installdir
- If you install the WebSphere Commerce Update Installer as a non-root user, you can install maintenance packages as a non-root user.
- If you want to use a non-root user to install UPDI,
ensure that the non-root user owns the appropriate .profile file and consider
the following installation limitations:
- Packages that are installed by a non-root user cannot be registered through native operating system mechanisms, such as the Red Hat Package Manager (RPM) on Linux. WebSphere software registers in the installation registry file and the vpd.properties file. All installed components are fully functional despite the lack of native registration.
- If you want to upgrade a previous version of UPDI that was installed by the root user, you must use the root user. If you want to use a non-root user, you must install UPDI to a new location.
- Log on as the
root
user. - If the directory /tmp/niflog/ exists, create a backup and then remove the directory.
- Change the ownership of /home/non-root_userdir/.profile
to
non-root
user and thenon-root
user group. For example, change ownership of /home/wasuser/.profile towasuser
andwasgroup
.
- Ensure that your user profile has
*SECOFR
authority. - Set the following permissions:
- Set root user umask to 0022.
- Set non-root user umask to 0027.
- Log on to a user that has Windows Administrative user rights.
- If UPDI is installed, determine the version of UPDI by running the following command:
- UPDI_installdir/bin/versionInfo.sh
- UPDI_installdir/bin/versionInfo
- UPDI_installdir/bin/versionInfo.bat
Important: You must always use the most recent version of the update installer.
Procedure
- Create a temporary directory. This temporary directory is referred to as UPDI_tempdir.
- Obtain the latest version of the WebSphere Commerce Update Installer and place in the UPDI_tempdir directory.
- Extract the UPDI package into the UPDI_tempdir directory.
-
Navigate to the UPDI_tempdir/UpdateInstaller/ directory
and launch the installation wizard by issuing one of the following commands:
- ./install
-
install.exeNote: You must complete this step on your Windows client machine.
- install.exe
- On the IBM i Logon panel, specify the System Name, User Name, and Password for the target IBM i machine.
-
Complete the installation wizard panels. Record the directory where UPDI is installed. This
installation directory is referred to as the
UPDI_installdir.
Note: During the installation of UPDI, you might receive a warning that indicates that there is another version of UPDI on the system. A list of Update Installer locations is displayed. This list includes Update Installers for all WebSphere Software.
- For root users, or users with administrative authority, it is recommended that you uninstall the
other copies of WebSphere Commerce Update Installer and install the most recent version. If the
list contains installers that are not used for WebSphere Commerce, then these installers do not
need to be uninstalled and the warning can be safely ignored.
For non-root users, do not attempt to update the existing UPDI. Install UPDI to a new directory.
- To determine whether the location specified contains an installer for WebSphere Commerce,
check the version.txt file that is found in the detected product path. For
WebSphere Commerce, this file contains the following
message:
For other WebSphere Software, the file contains the following message:WebSphere Commerce Update Installer.
Only the WebSphere Commerce Update Installer can apply maintenance to WebSphere Commerce software. Similarly, you must use the Update Installer for WebSphere Software to apply maintenance to WebSphere Application Server.IBM Update Installer for WebSphere Software.
- For root users, or users with administrative authority, it is recommended that you uninstall the
other copies of WebSphere Commerce Update Installer and install the most recent version. If the
list contains installers that are not used for WebSphere Commerce, then these installers do not
need to be uninstalled and the warning can be safely ignored.
- Verify that the installation was successful by reviewing the following log file: UPDI_installdir/logs/install/log.txt.