Deploying Siebel Application Using Docker Image on Oracle Cloud Infrastructure with Vanilla Database


Options



Before You Begin

Purpose

This tutorial shows you how to deploy a complete Siebel CRM IP2017/18/19 application with a vanilla database environment containing seed data only using Docker image and an Oracle 12c database to a virtual machine in Oracle Cloud Infrastructure (OCI) Service (Dedicated).

In this tutorial, you will set up Security Lists to enable HTTP access to your Siebel instance using ports 4430 and 8080. You will choose from the Oracle Cloud Marketplace the Siebel CRM Install Jenkins/Docker Instance image to install the Siebel Gateway, AI and Siebel Application Servers and connect to an Oracle database server containing vanilla data.

Note that the information presented here is based on Siebel CRM IP2017/18/19, which is general availability since 2017.

Time to Complete

30 minutes

Background

Oracle Cloud Infrastructure Service enables you to rapidly provision virtual cloud machines (VCNs) on Oracle Cloud Infrastructure with the necessary storage and networking resources. After you’ve created your virtual machine instance, you can navigate and test out Siebel CRM IP2017/18/19 on the virtual machine.

What Do You Need?

A subscription to Oracle Cloud Infrastructure Service (Dedicated) is mandatory and you must be a user with the Compute_Operations and Storage Read Write Group roles.

For more details on creating Oracle Cloud Infrastructure Service instances, see the following:

Process Overview

To create the required Oracle Cloud Infrastructure Service instance to deploy the Siebel CRM application, you will:

  1. Generate an SSH key pair on your local system. (Prerequisite)
  2. Create a Virtual Cloud Network (Prerequisite)
    • Create a Subnet (Prerequisite)
    • Open Ports (Prerequisite)
  3. Launch Jenkins/Docker image from Oracle Marketplace to create your initial Siebel instance into your Tenancy
  4. Deploy Siebel CRM 2017/18/19
    • Generating Jenkins URL
    • Deploying the Siebel Application
    • Generating application domain URL
    • Changing the SADMIN Password
  5. Log into the Siebel application.

Generating an SSH Key Pair

This is the first prerequisite.

When you create your Oracle Cloud Infrastructure Service instance, you must provide an SSH public key that will be used for authentication when you log in to the instance. Generate your SSH key pair. You can save the SSH key pair to either paste or upload to the Oracle Cloud Infrastructure Tenancy before you start to create your instance.

Generating an SSH Key Pair on UNIX or UNIX-Like Systems Using ssh-keygen

  1. Run the ssh-keygen command.
    ssh-keygen -b 2048 -t rsa
  2. The command prompts you to enter the path to the file in which you want to save the key. A default path and file name are suggested in parentheses. For example: /home/user_name/.ssh/id_rsa. To accept the default path and file name, press Enter. Otherwise, enter the required path and file name, and then press Enter.
  3. Note: The key should be created without a passphrase.

  4. The command generates an SSH key pair consisting of a public key and a private key, and saves them in the specified path. The file name of the public key is created automatically by appending .pub to the name of the private key file. For example, if the file name of the SSH private key is id_rsa, then the file name of the public key would be id_rsa.pub.
  5. Make a note of the path where you've saved the SSH key pair.
    When you create instances, you must provide the SSH public key. When you log in to an instance, you must specify the corresponding SSH private key.

Generating an SSH Key Pair on Windows Using the PuTTY Key Generator

  1. Find puttygen.exe in the PuTTY folder on your computer and double-click it. (If you do not have PuTTY.exe on your computer you can find it on web here http://www.putty.org/)
  2. Accept the default key type, SSH-2 RSA, and set the Number of bits in a generated key to 2048, if it is not already set. Then click Generate.

    Generate SSH key pair on Windows, PuTTY Key Generator

    If you do not see the SSH-2 RSA in key type options, go to Key in the menu.

    Generate SSH key pair on Windows, PuTTY Key Generator

  3. Move your mouse around the blank area to generate randomness. The SSH key pair is generated.

    Generate SSH key pair on Windows, generate randomness.

  4. Save your private key.
    1. The key comment is the name of the key. You can keep the generated key comment or create your own.
    2. Note: The key should be created without a passphrase.

    3. To save the private key in the PuTTY PPK format, click Save private key. Enter the same name as you used for the key comment so that you know which public key to use this private key with. The private key is saved in PuTTY's Private Key (PPK) format, which is a proprietary format that works only with the PuTTY toolset. You can use this key whenever you use PuTTY for SSH.

      Generate SSH key pair on Windows, save private key.

  5. Next, save your SSH public key.
    1. To save the public key, in the PuTTY Key Generator, select all of the characters in the Public key for pasting into OpenSSH authorized_keys file field.

      Generate SSH key pair on Windows, save public key.

      Note: Make sure you select all the characters, not just the ones you can see in the narrow window. If there is a scroll bar next to the characters, you aren't seeing all the characters.

    2. Right-click somewhere in the selected text and select Copy from the menu.

      Generate SSH key pair on Windows, copy public key

    3. Open a text editor and paste the characters. Ensure that you paste the text at the first character in the text editor, and don't insert any line breaks.
    4. Save the key using the same root name that you used for the private key. Add a .pub extension. You can give it any extension you want, but .pub is a useful convention to indicate that this is a public key.
    5. Exit PuTTY Key Generator.
  6. Make a note of the public and private key names and where they are saved.
    When you create instances, you must specify the SSH public key. When you log in to an instance, you must provide the path to the corresponding SSH private key.

Creating a VCN

This is the second prerequisite.

  1. Login to Oracle Cloud Infrastructure.
  2. Navigate to Menu, Networking, and then Virtual Cloud Networks.
  3. Select Compartment in which to place your Siebel instance from the Compartment drop down list in the left pane where you want to create your VCN. For example, SiebelDev.
  4. Select a compartment to place your instance in it

  5. Click Create Virtual Cloud Network button.

    Click Create VCN

  6. In the pop up window, fill in the following details:
    • Create in Compartment - siebelDev
    • Name: Give a logical name to your VCN.
    • CIDR Block – 10.0.0.0/16
    • You may retain the other default values.

    Note: Generate your instances only in a sub-compartment of a root compartment. If a sub-compartment is already not available, create a sub-compartment.

    Enter VCN details.

  7. Click Create Virtual Cloud Network in the pop up window.
  8. The VCN is created and listed in the page.

    View VCN

Creating a Sub-Compartment

  1. Log in to OCI, navigate to Identity, and then select Compartments.

    The Compartments page appears.

    Select to change password

  2. To create a sub-compartment, do any of the following:
    • Click Create Compartment to go to Compartments page.
    • Click the root Compartment name to go to Compartment Details page. Click Create Compartment in the Child Compartments section.

    Select to change password

  3. In the Create Compartment window, fill in the following details:
    • Name: Give a logical name to the sub-compartment.
    • Description: Add description of the sub-compartment.
    • Parent Compartment: Select the parent (root) compartment for the sub-compartment.
    • Click Create Compartment.
  4. Select to change password

    The sub-compartment is created for the root compartment.

    Select to change password

Creating a Subnet

Create a Subnet to open two ports within the previously created VCN.

  1. Click on the VCN name you just created to go to the details page.

    View VCN

  2. In the details page, click Create Subnet.

    View VCN

  3. In the Create Subnet pop up window, fill in the following details:
    • Name: Give a logical name to your Subnet.
    • Availability Domain – Select GPSa:PHX-AD-1
    • CIDR Block – 10.0.0.0/24
    • Route Table: Default Route Table for VCN_KS1 (the VCN you created previously)
    • Subnet Access – Public Subnet
    • DHCP Options - Default DHCP Options for VCN_KS1 (the VCN you created previously)
    • Security Lists - Default Security Lists for VCN_KS1 (the VCN you created previously)

    You may leave the other values as filled in by default.

    View VCN

  4. Click Create.

    The Subnet is created.

    View VCN

    On creating Subnet, a Security list is created. You will have to open ports within this Security List.

Opening Ports

Open the following two ports - 4430 and 8080 within the previously created Subnet.

  1. Navigate to Menu, Networking, and then Virtual Cloud Networks.
  2. Select the VCN you previously created.
  3. Select Security Lists from Resources in the left pane.

    View VCN

  4. In the Security Lists page, click the Default Security Lists for VCN_KS1 link.

    View VCN

  5. In your Default Security List, click Edit All Rules button.

    View VCN

    The Edit Security List Rules pop up appears.

  6. To add port 4430, do the following:
    1. Scroll down to the Another Ingress Rule button and click. An Ingress Rule section is added.
    2. In Source CIDR, add 0.0.0.0/0.
    3. In Destination Port Range, add 4430.
  7. To add port 8080, repeat step 6.

    View VCN

  8. Click Save Security List Rules.

    The ports display in the security list page.

    View VCN

Launch Instance of Siebel from Marketplace

  1. Log in to Oracle Cloud Infrastructure.
  2. Navigate to Oracle Cloud Infrastructure Marketplace.
  3. Navigate to Marketplace
  4. Click on Siebel CRM install Jenkins/Docker Instance image.
  5. Go to Jenkins/Docker Instance
  6. In the instance page, click Launch Instance.
  7. Click Launch Instance button

  8. In the Launch Instance screen that appears, do the following:
    • Select Compartment. For example, siebelDev
    • Agree to the Terms of Use.
    • Click Launch Instance.

    Click Launch Instance button

  9. In the Create Compute Instance screen that appears, do the following:
    • Name your Instance – Give a logical name to your instance.
    • Select a domain.

    Create Instance button

  10. Go to Add SSH key section and select one of the following:
    • Choose SSH key file – select and upload the SSH key file.
    • Paste SSH keys – select this and paste the SSH key in the given space.

    Paste SSH key

  11. In the Configure Networking section, select the VCN you created previously. Leave the other default selections.

    Define the Compute Instance

  12. Click Create. The create process starts with the status of the instance as Provisioning.

    Compute Instance is Provisioning

    Then, when the instance is created successfully, the status of the instance is displayed as Running.

    Compute Instance is running.

Deploying the Siebel Application

After you have created the instance, you have to generate two URLs:

  1. Jenkins URL: To deploy Siebel application.
  2. Application domain URL: To create Siebel industry specific application.

Generating Jenkins URL

  1. Copy the Public IP Address from your previously created Instance.
  2. Copy IP Public Address

  3. Add the port 8080 preceded with a colon and paste the URL in a browser window to open the Jenkins application.

    <public IP address>:<port number>

    For example: 129.146.133.76:8080

  4. Log in to the Jenkins application.

    Note: Jenkins is a public domain. It is recommended to change the password. For more information, see here.

Deploying the Siebel Application

  1. After you login to Jenkins, the Pipelines screen opens. Click on SiebelDeploy.

    Copy IP Public Address

  2. In the Pipeline SiebelDeploy screen, click on Open Blue Ocean.

    Copy IP Public Address

  3. In the deployment screen, click on Run.

    Copy IP Public Address

  4. In the Input required dialog box, enter the required input and click Run.

    Copy IP Public Address

    The deployment process starts.

    Copy IP Public Address

    This is another view of deployment process.

    Copy IP Public Address

    When the deployment is successfully completed, the screen displays as following.

    Copy IP Public Address

    Click on Logs to view build details.

    Copy IP Public Address

Generating application domain URL

Create the application URL using the port 4430, that you opened previously, and the industry you selected while deployment.

http:// <public IP address>:<port number>/siebel/app/<industry>/enu

For example, if you selected Automotive, your application URL for Automotive industry will be the following.

https://129.146.170.80:4430/siebel/app/eautomotive/enu

The application URL will be specific to the Industry you select while deployment, for example, the URL will be:

  • For Service - https:// <public IP address>:4430/siebel/app/callcenter/enu
  • For Siebel Management Console (SMC) - https:// <public IP address>:4430/siebel/smc

Changing the SADMIN Password

  1. In Jenkins application, navigate to siebel toolbar and select Configure.

    Select to change password

  2. Drill down to Password section, change the password, and then click Save.

    Select to change password

Logging In to the Siebel Application

After the Siebel CRM Install Jenkins/Docker Instance configuration has completed, you can log in to the Siebel environment details page in a browser using the public IP address that you reserved earlier. See Generating application domain URL. This page contains list of Siebel applications and users.

Want to Learn More?

  • Search for Siebel Bookshelf in My Oracle Support