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
  • LinuxAIXIf you install the WebSphere Commerce Update Installer as a non-root user, you can install maintenance packages as a non-root user.
  • LinuxAIXIf 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.
    If you accept the limitations, to change ownership, perform the following steps:
    1. Log on as the root user.
    2. If the directory /tmp/niflog/ exists, create a backup and then remove the directory.
    3. Change the ownership of /home/non-root_userdir/.profile to non-root user and the non-root user group. For example, change ownership of /home/wasuser/.profile to wasuser and wasgroup.
  • For IBM i OS operating systemEnsure that your user profile has *SECOFR authority.
  • LinuxAIXFor IBM i OS operating systemSet the following permissions:
    • Set root user umask to 0022.
    • Set non-root user umask to 0027.
  • WindowsLog on to a user that has Windows Administrative user rights.
  • If UPDI is installed, determine the version of UPDI by running the following command:
    • LinuxAIXUPDI_installdir/bin/versionInfo.sh
    • For IBM i OS operating systemUPDI_installdir/bin/versionInfo
    • WindowsUPDI_installdir/bin/versionInfo.bat
    Important: You must always use the most recent version of the update installer.

Procedure

  1. Create a temporary directory. This temporary directory is referred to as UPDI_tempdir.
  2. Obtain the latest version of the WebSphere Commerce Update Installer and place in the UPDI_tempdir directory.
  3. Extract the UPDI package into the UPDI_tempdir directory.
  4. Navigate to the UPDI_tempdir/UpdateInstaller/ directory and launch the installation wizard by issuing one of the following commands:
    • LinuxAIX./install
    • For IBM i OS operating system install.exe
      Note: You must complete this step on your Windows client machine.
    • Windowsinstall.exe
  5. For IBM i OS operating system On the IBM i Logon panel, specify the System Name, User Name, and Password for the target IBM i machine.
  6. 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.

      LinuxAIXFor 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:
      WebSphere Commerce Update Installer.
      
      For other WebSphere Software, the file contains the following message:
      
      IBM Update Installer for WebSphere Software.
      
      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.
  7. Verify that the installation was successful by reviewing the following log file: UPDI_installdir/logs/install/log.txt.

Results

The WebSphere Commerce Update Installer is installed.