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

Installing Siebel Tools as a Migration Installation


Use the following procedure to install Siebel Tools as a migration installation.

NOTE:  Use this procedure only when Siebel Tools for a prior release of Siebel CRM is already installed. Otherwise, you must follow the steps in Installing Siebel Tools as a New Installation instead.

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

Oracle Database XE is always installed for Siebel Tools. You can optionally install the local database in a migration installation of Siebel Tools. Do not install the local 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 Siebel Tools.

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

To install Siebel Tools 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. For example, your administrator might want you to check in any changes you have made to objects in your existing local database.
  3. Exit any Siebel software on the developer client computer where you are installing Siebel Tools.
  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 Siebel CRM 17.0, and then to the directory where the installer is located. Navigate to Siebel_Image\Windows\Client\Siebel_Tools\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 Siebel Tools, 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=TOOLS_HOME ORACLE_HOME=c:\Siebel\Tools

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

    The Siebel Tools installer displays the Welcome screen.

  8. Click Next.

    The Select Installation Task screen appears.

  9. To perform a migration installation of Siebel Tools where an existing prior release 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. In the Local DB Selection screen of the Siebel Tools installer, you can optionally specify that you want to install the local database. If you checked Install Local DB, then you must also specify an appropriate user name and password. Also specify the path to the installed 32-bit Oracle Database Client, whether or not you install the local database.

    For example, if the Oracle Database Client was installed at a location like C:\app\client\username\product\12.1.0\client_1, then you would specify that location during Siebel Tools installation.

  12. In the Summary screen, review the information presented.

    This screen displays the location where Siebel Tools 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 Tools 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 Tools 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 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 Tools 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_TOOLS_ROOT\cfgtoollogs\oui directory (in the new Siebel Tools installation).

  15. To close the installer, click Close.

    The Siebel Tools installation is now finished. The Siebel Tools shortcut was created in the program folder.

  16. After installing the Siebel Tools software:
  17. Repeat this procedure on each computer with a Siebel Tools installation to be migrated.
Siebel Installation Guide for Microsoft Windows Copyright © 2018, Oracle and/or its affiliates. All rights reserved. Legal Notices.