Siebel Installation Guide for Microsoft Windows > Installing Siebel Web Clients and Siebel Tools > Installing the Siebel Web Client >

Installing the Siebel Web Client as a Migration Installation

Use the following procedure to install the Siebel Web Client as a migration installation for the current release, Siebel CRM version 17.0. Migration installation is a type of patch installation. The information applies to both the Siebel Mobile Web Client and the Siebel Developer Web Client.

NOTE:  Use this procedure only when an earlier version of the Siebel Web Client is already installed (Siebel CRM version 8.1.1.x, version 8.2.2.x, version 15.x, or version 16.x). Otherwise, you must follow the steps in Installing the Siebel Web Client as a New Installation instead.

During a migration installation, the original Siebel Web Client installation directory is renamed from OriginalName to OriginalName_pre17.0. For example, if the original installation directory name (OriginalName) was Client_1, then this directory is renamed to Client_1_pre17.0. The new Siebel Web Client installation directory is named OriginalName, such as Client_1. Retain the original installation directory, in case you choose to perform a rollback uninstallation later. For more information, see Rolling Back the Siebel Web Client.

Oracle Database XE is always installed for Siebel Mobile Web Client. You can optionally install the sample database in a migration installation of Siebel Mobile Web Client. Do not install the sample database if you plan to initialize a local database through Siebel Remote. For more information, see Installing and Using Oracle Database XE for the Local or Sample Database.

This topic is part of Installing the Siebel Web Client.

This task is a step in Roadmap for Installing Siebel Business Applications in a Migration Installation Case (Existing Installation).

To install the Siebel Web Client as a migration installation

1. Review About Installing the Siebel Web Client or Siebel Tools. See also Installing and Using Oracle Database XE for the Local or Sample Database.
2. Perform any premigration tasks that might be necessary, as noted in Additional Tasks for Migration Installations.
3. Exit any Siebel software on the client computer where you are installing the current release.

   NOTE:  For a Siebel Mobile Web Client using the Siebel QuickStart feature, you must also exit the QuickStart agent if it is running. To do this, right-click the QuickStart icon in the system tray, and then choose Exit. Siebel QuickStart is no longer supported, as of Siebel Innovation Pack 2016.

4. Perform any additional premigration tasks that might be necessary. For example, you might need to upgrade the 32-bit Oracle Database Client version installed on your computer.
5. In Windows Explorer, navigate to the Siebel image location for the current release, and then to the directory where the installer is located. Navigate to Siebel_Image\Windows\Client\Siebel_Web_Client\Disk1\install.

   In this path, Siebel_Image is the directory for your version-specific Siebel installation image, such as C:\Siebel_Install_Image\17.0.0.0.

6. Before you run the installer to perform the migration installation of the Siebel Web Client, run the following command:

   module.exe -debug -silent -attachhome ORACLE_HOME_NAME=Oracle_Home_Name ORACLE_HOME=Oracle_Home

   For example, you might enter a command like this, depending on the Oracle home name and on the original installation directory:

   module.exe -debug -silent -attachhome ORACLE_HOME_NAME=CLIENT_HOME ORACLE_HOME=c:\Siebel\Client

7. To start the Siebel Web Client installer, double-click setup.bat.

   The Siebel Web Client installer displays the Welcome screen.

8. Click Next.

   The Select Installation Task screen appears.

9. To perform a migration installation of the Siebel Web Client software where an existing prior installation of version 8.1.1.x, version 8.2.2.x, version 15.x, or version 16.x is present, choose Migration Installation, and click Next.

   The Installation Migration Details screen appears.

10. Confirm or select the name and location of your existing installation, and then click Next. Do the following:
    • Confirm the existing installation name, or select it from the drop-down list.
    • Confirm the existing installation location, or select it from the drop-down list.

      For more information about Oracle home and installation path requirements, see File and Directory Naming Conventions.

11. (Siebel Mobile Web Client only) In the Sample DB Selection screen of the Siebel Web Client installer, you can optionally specify that you want to install the sample database. Specify the path to the installed 32-bit Oracle Database Client, whether or not you install the sample database.
12. In the Summary screen, review the information presented.

    This screen displays the location where the Siebel Web Client will be installed. Before you proceed, confirm that you have met all of the installation requirements, such as for disk space. Then do one of the following:

    • To begin installing the Siebel Web Client software, click Install. You can also click Install after saving a response file.
    • To save a response file to use for an unattended installation later, click Save Response File. If you are not also installing at this time, then click Cancel after you save the response file. For information about performing unattended installations, see Installing Siebel Web Clients and Siebel Tools in Unattended Mode.

      The Installation Progress screen appears. The Siebel Web Client software is installed into the directory that you specified in Step 10.

13. When the Next button becomes available, the installation is complete. Click Next.

    The Finish Installation screen appears. This screen indicates whether the installation was successful and shows the location of the installer log file. You can access this file to review the installation results. This screen also shows the new location of the original installation, which the installer moved before it performed the new installation.

14. Review the report that is generated about any conflicts between your customized files and the files that are delivered by the Siebel Web Client installer. As needed, copy any applicable customized files from the original installation to the new migrated installation.

    Conflicts are identified in the file overwrittenfiles_timestamp.log, which is created in the SIEBEL_CLIENT_ROOT\cfgtoollogs\oui directory (in the new Siebel Web Client installation).

15. To close the installer, click Close.

    The Siebel Web Client installation is now finished. Siebel application shortcuts are created in the program folder. For more information about these shortcuts, see Siebel Web Client Shortcuts.

16. After installing the Siebel Web Client software:
    • Verify the Siebel Web Client installation, as described in Verifying Installation for the Siebel Web Client.
    • Install the latest Siebel Patchset release, where available. Then verify the installation again.
    • Perform any additional postinstallation steps, as described in Additional Postinstallation and Configuration Tasks. See also Additional Tasks for Migration Installations.
17. Repeat this procedure on each computer with a Siebel Web Client installation to be migrated.