Installing a Siebel CRM IP 2014 Self-Study Environment on Windows 7 64-bit

It has become a tradition at this humble blog that we provide instructions how to create an easy-access self-study environment consisting of the Siebel Developer/Mobile Web Client, Sample Database and Siebel Tools. The following post is an updated version of previous instructions and has been updated to reflect all necessary steps to download, extract, install and setup Siebel CRM Developer Web Client, Tools and the Sample Database for Siebel 8.1.1.14 (or 8.2.2.14), better known as Innovation Pack 2014.

Process for installing a Siebel CRM IP 2014 self-study environment:

1. Register/log in at Oracle's Software Delivery Cloud (aka E-Delivery)
2. Read and understand the license agreement
3. Use a download manager
4. Verify hard- and software
5. Download the installation archives
6. Extract the installation archives
7. Run the Network Image Creator
8. Prepare the browser
9. Install the Siebel Mobile/Developer Web Client
10. Install the Siebel Sample Database
11. Install Siebel Tools
12. Modify the .cfg files
13. Manage shortcuts
14. Get started with the Siebel Sample Database

(Note: Steps 1 and 3 to 7 can be skipped if you're lucky enough to find the installers on one of your corporate network drives).

Step 1: Register/log in at Oracle's Software Delivery Cloud (aka E-Delivery)

Oracle makes Siebel CRM software available for download on its Software Delivery Cloud. If you want to download software from there, you have to register with your name, company and e-mail address. You will receive a notification after approximately one business day that you can now use the Software Delivery Cloud.

Step 2: Read and understand the license agreement

Oracle provides an unlimited developer license for its software. The license agreement (from the OTN software download page) grants

"... a nonexclusive, nontransferable, limited license to internally use the Programs, subject to the restrictions stated in this Agreement, only for the purpose of developing, testing, prototyping, and demonstrating Your application and only as long as Your application has not been used for any data processing, business, commercial, or production purposes, and not for any other purpose."

Step 3: Use a download manager

Because of the size of the .zip archives you're going to download onto your hard disk, it is highly recommended to use a download management tool such as Free Download Manager (FDM).

FDM is my tool of choice because of a nice feature called "ZIP Preview" which allows you to preselect the content of the zip file before starting the download.

The ZIP Preview is especially useful to uncheck all the unneeded language packs, so that your final download size is much smaller (and faster).

When you decide to install FDM, you will notice that it creates plug-ins for your browser(s). To initiate the download in FDM, you simply click the link within your browser as usual and the download will be forwarded to FDM.

Step 4: Verify hard- and software

If you have access to My Oracle Support, you can access the system requirements and platform documentation via the Certifications tab as indicated here. For a self-study environment as installed in this article, you are fine if you have a recent laptop or desktop with at least 4 GB of RAM and (of course) Windows 7 64 bit. If you use virtual machines, ensure that you place them on high-speed disks and reserve enough RAM for best performance.

In addition, ensure that you have installed modern versions of your favorite browser, keeping in mind that if you intend to run Siebel in High-Interactivity (aka "ActiveX") mode, you must have Microsoft Internet Explorer 8 and not any higher version available. For best performance of Siebel Open UI, you should consider installing Google Chrome or Mozilla Firefox in addition to MS IE.

Personally I prefer virtual machines because of the greater flexibility. Some companies do not allow their employees to install software on corporate laptops, so running a (privately owned) virtual machine is sometimes the only option (sad, but true).

Step 5: Download the installation archives

Now it's time to log in to Oracle's Software Delivery Cloud and search for Siebel CRM for Microsoft Windows (64 bit). As we are going to download and install Siebel Industry Applications 8.1.1.14, we have to click the hyperlink for

Siebel Industry Applications Innovation Pack 2014 Release 8.1.1.14 Media Pack for Microsoft Windows

Then we download the following archives and save them in a single directory. If your download manager allows to control the files to download within an archive, please refer to the list of .jar files below each package. Note that in this article we only cover the English-American (enu) language pack. If you want to download additional language packs, please ensure to include the language-specific files identified by the three-letter language code as part of the name (e.g. deu for German).

Siebel Industry Applications Version 8.1.1.14 Siebel Client (Starter Installation Requirement): 
SBA_8.1.1.14_Base_Windows_Siebel_Web_Client.jar
SBA_8.1.1.14_enu_Windows_Siebel_Web_Client.jar

Siebel Industry Applications Version 8.1.1.14 Siebel Tools (Starter Installation Requirement):
SBA_8.1.1.14_Base_Windows_Siebel_Tools.jar
SBA_8.1.1.14_enu_Windows_Siebel_Tools.jar

Siebel Industry Applications Version 8.1.1.14 Sample Database Files:
SBA_8.1.1.14_Base_Windows_Siebel_Sample_Database.jar
SBA_8.1.1.14_enu_Windows_Siebel_Sample_Database.jar

Siebel Industry Applications Version 8.1.1.14 ImageCreator Files (Starter Installation Requirement):
all files

Step 6: Extract the installation archives

Most probably you are using a Microsoft Windows machine for the files, so it is recommended to use 7-Zip to extract the content of the downloaded zip archives into a single folder.

As a result of the extract, we have a folder full of .jar files and the files for the Network Image Creator.


Step 7: Run the Network Image Creator

The Siebel Network Image Creator (snic) is needed to create the final installer directories and files. To launch it, you have to open a Windows command shell (aka DOS box) and navigate to the directory containing the extracted .jar files. Next, set the JAVA_HOME environment variable to the location of the Java runtime environment (JRE) on your machine using a command similar to the following (of course, if you haven't installed the JRE yet, it is time to do so now):

set JAVA_HOME=C:\Program Files\Java\jre1.7.0_45

Your Java version and install folder might vary.

Next, launch the image creator by issuing the following command:

snic.bat

The wizard will launch and guide you through the network image creation process. Basically the image creator asks for the following:

1. Whether you want to create a new image or add a language pack (select "create a new image").
2. Enter the path where to store the installer images. (enter a suitable path)
3. The OS platform (select "Windows")
4. The products (select "Siebel Tools", "Siebel Web Client" and "Siebel Sample Database")
5. The languages (select at least "ENU")

Wait until the wizard completes the extraction process and verify that the installer packages are now present in the path you provided.

Step 8: Prepare the browser

The following settings are recommended for running the client installer and the High-Interactivity client flawlessly. You might not be able to complete this step because of security restrictions on your laptop or in your corporation. In this case, please contact your IT administrator.

Make IE the default browser

Because the installer for the Siebel Developer Web Client will try to pre-load the ActiveX controls, it launches an HTML page. This will only work as intended when Internet Explorer is the default browser for your system. To set IE as the default browser, open the Windows Control Panel, go to Default Programs, and click Set your default programs.

Next, select Internet Explorer in the list and click Set this program as default.

Note: you can change your default browser back to the one you love more than IE once the installation is finished.

Pop-up Blocker settings:

1. In Internet Explorer, go to Tools - Pop-up Blocker - Pop-up Blocker Settings.
2. Add http://localhost, http://[short machine name] and http://[fully qualified machine name] to the allowed sites list (see screenshot below for an example)

Alternatively, set the blocking level to "Low" or disable the Pop-up Blocker entirely (if applicable).

Security settings:

1. In Internet Explorer, go to Tools - Internet Options - Security.
2. Select the Trusted Sites icon and click the Sites button.
3. Add http://localhost, http://[short machine name] and http://[fully qualified machine name] to the Websites list (see screenshot below for an example)
4. Set the security level for the Trusted Sites zone to "Low".
   Alternatively, click the Custom Level... button and set all ActiveX related entries to "Enable" or "Prompt".
   Update: With IE 8, the setting "Only allow approved domains to use ActiveX without prompt" should be set to disabled as per MOS Document Id 1270206.1 (thanks to Tobias for the hint).

Internet Explorer settings for trusted sites.

Internet Explorer 9 settings

For those on Internet Explorer 9, you should say a big thank you to Richard who posted these additional steps:

1. Add http://localhost, http://[short machine name] and http://[fully qualified machine name] to the list of compatibility mode sites.
2. Go to Tools - Manage Add-ons and set the Java Add On parameter to "Enabled".

Step 9: Install the Siebel Mobile/Developer Web Client

The following procedure describes the installation of the Siebel Mobile Web Client for use with the Siebel Sample Database. Important: Don't use or start any other programs until the installation is finished.

1. Navigate to the 8.1.1.4\Windows\Client\Siebel_Web_Client\Disk1\install folder of the installation image and double-click the setup.bat file.
2. Uncheck the option to receive security updates and confirm.
3. Choose "New Installation" to install a new instance. If you want you can choose "Migrate Installation" if you wish to upgrade an existing client instance to IP 2014.
4. Provide a meaningful destination folder.
5. Select the desired language packs (always include American English).
6. At the client type selection, select "Mobile Web Client". Check the "Activate Open UI" option if you want all .cfg files to contain the EnableOpenUI parameter set to TRUE.
7. During the installation, Internet Explorer is launched to pre-load the Siebel ActiveX controls. When prompted, allow the execution of any ActiveX content. You will be prompted to close the IE window so that the installer can continue.

Step 10: Install the Siebel Sample Database

The installer for the Siebel Sample Database can be found in the Siebel_Sample_Database folder of the installation image. We can follow the procedure below to install the sample database. Again: Don't use or start any other programs until the installation is finished.

1. Double-click the install.exe file in the Siebel_Sample_Database folder.
2. Select a language for the installation dialogs.
3. Keep the defaults in all dialogs except for those described below.
4. Select the custom installation type.
5. Change the installation directory to the client's installation folder (this is important).
6. In the language selection, select only "English (American)". Selecting additional language packs only copies non-english seed data files and does not change the database. You can use these seed data files to produce a sample database specific to a language pack of your choice but you can only import one language.
7. Keep the defaults in the remaining dialogs and wait for the installation to finish.

Step 11: Install Siebel Tools

To install Siebel Tools, follow these steps:

1. Double-click the setup.bat file in the 8.1.1.4\Windows\Client\Siebel_Tools\Disk1\install folder of the installation image.
2. Uncheck the option to receive security updates and confirm.
3. Choose "New Installation" to install a new instance. If you want you can choose "Migrate Installation" if you wish to upgrade an existing Tools instance to IP 2014.
4. Provide a meaningful destination folder.
5. Keep the defaults in the remaining dialogs except for the following:
• In the file system path dialog select the path which points to the SAMPLE\FILES folder in the client installation directory.
6. Wait for the installer to finish before you use or launch any other program.

Step 12a: Modify the tools.cfg file for use with the Siebel Sample Database

The following steps are necessary to be able to connect Siebel Tools to the Siebel Sample Database. Remember we installed the sample database into the client installation directory. What we do is change the ConnectString parameter in the tools.cfg file to point to the sample database file (sse_samp.dbf) in the client directory.

1. Open the uagent.cfg file in the client's BIN\ENU directory with Notepad.
2. Copy the value of the ConnectString parameter in the [Sample] section of the uagent.cfg file to the clipboard.
3. Open the tools.cfg file in the Siebel Tools BIN\ENU directory with Notepad.
4. Overwrite the value of the ConnectString parameter in the [Sample] section of the tools.cfg file with the value you copied in step 2.
5. Save and close all files.

Step 12b: Modify the client .cfg files

Now, we prepare the client configuration files and (optionally) create .cfg files for running the Siebel Client in Open UI mode.

• Navigate to the client install folder and open the BIN\ENU directory.
• Open the client .cfg file of your choice (e.g. uagent.cfg for Siebel Call Center)
• Set the EnableFQDN parameter to FALSE.
• If you want to run HI and Open UI in parallel, it is recommended to create separate .cfg files. For example if you chose to activate Open UI during the client installation, copy an existing file such as uagent.cfg and rename the copy to uagent_hi.cfg or similar.
• In the copied file, find the [InfraUIFramework] section and add the following line:

    EnableOpenUI = FALSE

Repeat these steps for every application you want to use. For example, for Siebel Marketing, you would choose the market.cfg file.

Step 13: Manage Shortcuts

If you don't have MS Internet Explorer set as your system default browser, you must add a string similar to the following to the shortcuts that launch high-interactivity clients.

/b "C:\Program Files (x86)\Internet Explorer\iexplore.exe"

Note that you must point to the 32-bit version of IE to run the HI client. For Open UI, you can use any modern browser (IE 10+, Firefox, Chrome, Safari, etc.) in its 32-bit or 64-bit variant.

Here is an example shortcut to launch Siebel Call Center in Open UI mode in the default browser:

D:\siebel\client\BIN\siebel.exe /c D:\siebel\client\bin\enu\uagent.cfg /d sample /u SADMIN /p SADMIN

Check out this post for additional switches for siebel.exe and siebdev.exe.

Step 14: Get started with the Siebel Sample Database

Congratulations! You can now launch all Siebel CRM applications from the Start Menu, connect to the Sample data source and explore Siebel standard functionality.

Of course, there's the Siebel Administrator account (SADMIN) to start with. The passwords in the sample database are equal to the account name. But there are more meaningful demo user accounts in the sample database.

Make sure you take a look into the Demo Users Reference (in the Siebel bookshelf) so you are one step ahead of the competition ;-).

Siebel Call Center IP 2014

Summary

Quite a stretch but with a bit of effort you will soon be able to call a Siebel CRM IP 2014 self-study environment your own. Now you are ready to explore the latest and greatest features such as Open UI and Siebel Mobile Applications on your own computer.

have a nice install day

@lex