Performing a custom installation using the Installation wizard

You can use the Installation wizard to help guide you through the installation of WebSphere Commerce and its supporting software.

Before you begin

Ensure that the machines on which you are starting the Installation wizard meets all requirements.

Solaris Linux AIX If you want to use launchpad, ensure that you have Mozilla Firefox 10 or earlier installed. Launchpad does not support Mozilla Firefox browsers later than Firefox 10.

About this task

Review the following suggestions before starting the installation wizard:

Do not exit the launchpad while the installation wizard is running.
The installation wizard copies a number of large files from the DVD when it is started. The installation wizard will take a few moments to start. Do not start another instance of the WebSphere Commerce installation wizard while one is already running. If you exit the second occurrence of the wizard, your first installation will fail.
If at any point during the installation, the text in the installation wizard appears to be cut off or missing, resize the wizard so that you can read all of the text on the wizard.

If a Windows Autorun window displays after changing DVDs, close the window.
A Windows Autorun window resembles an Explorer window.
If a Windows Autoplay dialog box displays after changing DVDs, cancel or exit the dialog.
A Window Autoplay dialog box contains text similar to the following text:
```
Windows can perform the same action each time you insert a
disk or connect a device with this kind of file:
```
The following DVDs must be available in the local DVD-ROM drive or as an image on the local hard disk. Specifying a network location, either as a UNC path or a mapped drive, will cause the installation to fail:
- DB2 DVD
- WebSphere Application Server CD
  Note: The WebSphere Application Server CDs shipped with WebSphere Commerce are CIP packages and do not support remote IBM i install. As a result, the remote installer does not recognize the WebSphere Application Server CD. You have two options:
  - Download and obtain WebSphere Application Server CDs or images, then point the WebSphere Commerce installer to them, or
  - Pre-install WebSphere Application Server on the IBM i machine using the WebSphere Application Server CIP CD/images shipped with WebSphere Commerce. This must be done on the IBM i machine itself. It cannot be done remotely.
For all other DVDs, do not specify locations of the DVD or DVD image as Uniform Naming Convention (UNC) paths (for example, \\system1\destination). You can use mapped drive letters.
The path to the WebSphere Commerce DVD must not contain the character "#".

Do not change directories to the mount point. Changing directories to the mount point will lock the DVD drive and prevent you from being able to swap DVDs.
When launching any of the WebSphere Commerce Installation or Migration Wizards, ensure the current directory is not mount_point, otherwise your DVD drive could be locked when you need to change media. This applies to eImages as well.
The WebSphere Commerce DVD is provided in ISO format, ensure that you mount the DVD image correctly:
- Do not use auto-mount – mount the DVD manually. For example,
```
mount /dev/cdrom /mnt
```
- Auto-mount should correctly mount the WebSphere Commerce DVD.
If you are running Red Hat Enterprise Linux, and SELinux is enabled and enforced while you are installing WebSphere Commerce from a DVD , then you must mount the DVD using the following command:
```
mount -o context=system_u:object_r:textrel_shlib_t /dev/cdrom /media/
```
For more information, see Preparing Red Hat Enterprise Linux 5 for installation.
All DVDs provided with WebSphere Commerce use ISO formatted DVDs. Ensure that you mount the DVDs correctly.
When prompted to change DVDs by the WebSphere Commerce installation wizard:
1. Unmount the DVD-ROM drive.
2. Change the DVD in the DVD-ROM to the requested DVD.
3. Mount the DVD-ROM drive.
  Note: The installation wizard panel will display the mount point when a new DVD is required for the installation. Do not alter this panel, for any DVD that is mounted, during the installation.
When specifying the DVD-ROM drive path for mount_point, always use the symbolic path to the DVD-ROM drive such as /dvdrom/dvdrom0. This will vary depending on how many DVD-ROM drives you have and which one you are using.
The path to the WebSphere Commerce DVD must not contain the character "#".

Procedure

Ensure that you are logged onto your system:
- As the root user. Use the command su - root to change to the root user and load the correct environment.
- As a user with Administrative authority.
Ensure that you are logged onto your remote Windows system.
Complete the following steps:
1. Ensure that you have exported your display and that you have access to your X server. Refer to your operating system documentation for more information.
2. Insert the WebSphere Commerce DVD into the DVD-ROM drive.
3. Mount the DVD-ROM drive.
  Note: For Linux on iSeries or Linux on zSeries, switch directories to the directory containing the contents of the WebSphere Commerce DVD. The contents of this DVD and other DVDs should have already been transferred to the Linux system. See Transferring installation files to a Linux system.
4. Go to the location of the local WebSphere Commerce DVD image.
The installation can be started using the WebSphere Commerce launchpad, or a command prompt.
- WebSphere Commerce launchpad
  1. Select one of the following options to start the WebSphere Commerce launchpad:
    - mount_point/setup.sh
      where mount_point is the DVD-ROM mount point or the location of the WebSphere Commerce image. When referring to the mount_point, always use the symbolic path to the location such as /dvdrom/dvdrom0. In the case of the DVD-ROM, this can vary depending on how many DVD-ROM drives you have and which one you are using. If you receive a permission denied message after issuing this command, ensure that the command has execute permissions and run the command again.
      Note: When launching setup.sh, ensure the current directory is not mount_point, otherwise your DVD drive could be locked when you need to change media. This applies to eImages as well. See Working with WebSphere Commerce physical media for more information.
    - Depending on the location of your WebSphere Commerce DVD images, complete one of the following steps:
      - Insert the WebSphere Commerce DVD into the DVD-ROM drive on the remote Windows system. Depending on your Windows system, the launchpad can take 3 minutes or longer to start.
      - If the launchpad does not start automatically after you insert the DVD-ROM:
        
        In Windows Explorer, browse the DVD-ROM drive containing the WebSphere Commerce DVD.
        
        Double-click autorun.exe.
  2. The WebSphere Commerce launchpad starts. Select the language for the launchpad and click OK to continue.
  3. When the launchpad displays, it provides the following options:
    - Prerequisites
    - Documentation
    - Install Product
    - Install Product on IBM i
    - Support Assistant
    - Exit
  4. Click Install Product
  5. Click Install Product on IBM i
- A command prompt
  - From a command prompt, enter:
    - mount_point/setup_aix
    - mount_point/setup_solaris
    - Linux on System x: mount_point/setup_linux
    - Linux on IBM i: ./setup_ppclinux
    - Linux on System p: mount_point/setup_ppclinux
    - Linux on System z: ./setup_zlinux
    where mount_point is the DVD-ROM mount point. For example, /mnt/dvdrom0.
  - From a command prompt, enter: drive:\setup.exe
    where drive is the drive letter of the DVD-ROM containing the WebSphere Commerce DVD.
  - From a Windows command prompt, enter: drive:\iSeriesServer.bat
    where drive is the drive letter of the DVD-ROM containing the WebSphere Commerce DVD.
Select the installation language in the language selection panel, and click OK.
The software will be installed in this language, regardless of the language settings of your system. Do not select a language not supported by the system on which you are performing the installation.
In the IBM i Logon panel, type the System Name, User Profile, and Password into the respective fields. Click Next.
Note: Ensure that you log on to your IBM i system as a user with SECOFR class authority. The user profile requires the CCSID for the desired installation language of WebSphere Commerce. If you did not create a user profile meeting these requirements, see Creating a user profile for instructions.
Review the Welcome page; then click Next.
Review the terms of the license agreement and select one of the following options:
- If you accept the terms of the license agreement, select I accept the terms in the license agreement and click Next.
- If you decline the terms of the license agreement, select I do not accept the terms in the license agreement and click Next. Declining the terms of the license agreement exits the install program.
Enter the home directory of the non-root user and click Next.
Select Custom Installation and select Next.
Select the components you want to install on the node. Select Next to continue.
Descriptions of each component are provided in Custom installation components. Components detected on the system will be unavailable for selection in the wizard.
Note: If you select DB2 to be installed, ensure that you point to the DB2 image that came with WebSphere Commerce.
1. The system checks for an installed edition of WebSphere Application Server Version 7. If the edition currently installed is incorrect, the correct edition will be installed. Click Next to continue.
2. Depending on the components you have selected to install, you are prompted to enter a WebSphere Commerce Configuration Manager user password. Enter values and click Next to continue. The installation path panel opens and displays the default installation paths.
Important: Using the default installation path, for WebSphere Commerce, may result in issues with the installation of fixes. It is recommended that you enter a shorter installation path such as C:\WebSphere\CommerceServer70
To use an existing installation for a component, manually check the Is installed check box and provide the component's installation path.
Note: In a custom installation, IBM HTTP Server is not recognized by the WebSphere Commerce installation wizard even if IBM HTTP Server has been previously installed. If you want to use the existing installation of IBM HTTP Server, you must select IBM HTTP Server.
If you want to create a WebSphere Commerce response file based on your custom install options, select the Create a response file check box and specify a filename and location. Select Next.
Note: By selecting this option you can choose to record the selections that you have made during your GUI installation in a response file. This response file can then be used during silent installations on separate machines.
On the confirmation page, review the components being installed and their location.
When the installation is complete a new panel is shown. Review the information about this panel and click Next.
Note: If you are using an existing installation of IBM HTTP Server, you should select Is installed. You should also make sure that IBM HTTP Server is not running before you continue.
To make any changes, select Back to return to the panel where you want to make changes. To begin installing the components listed on the confirmation page, select Next.
The wizard completion display is shown. Click Next to continue.
The First Steps panel provides the following links:
- Start Configuration Manager
- Documentation
- Support
- Registration
- Information Center
- Exit