Deploying Oracle WebLogic Server 10.3.x on Oracle Compute Cloud Service Instances

Complete the following preinstallation tasks:

• Download the Oracle WebLogic Server 10.3.x installer.
• Download the Smart Update bsu and the unicast patches from My Oracle Support.
• Download the Java Development Kit (JDK) 6 (1.6.0_45).
• Connect to the Oracle Compute Cloud Service environment by using an SSH.

Downloading the Oracle WebLogic Server 10.3.x Installer

The software is available as a media or FTP request for those customers who own a valid Oracle WebLogic Server product license for any edition.

1. Request access to these releases. See Oracle Support Document 1071023.1 (Requesting Physical Shipment or Download URL for Software Media) on My Oracle Support.
2. Depending on the version that you want to install, request and download any of the following on your local UNIX-based or Linux machine:
   • WebLogic Server 10.3.0 - server103_linux32.bin
   • WebLogic Server 10.3.2 - wls1032_generic.jar
   • WebLogic Server 10.3.3 - wls1033_generic.jar
   • WebLogic Server 10.3.4 - wls1034_generic.jar
   • WebLogic Server 10.3.5 - wls1035_generic.jar
   • WebLogic Server 10.3.6 - wls1036_generic.jar

Downloading the Smart Update bsu and the unicast Patches

The patches are available as compressed files for those customers who have valid My Oracle Support credentials.

To download the Smart Update bsu patch:

1. Open a web browser, go to https://support.oracle.com, and provide your My Oracle Support credentials.
2. Click the Patches & Updates tab on the My Oracle Support home page.
3. In the Patch Name or Number search field, enter 12426828 for the Smart Update bsu patch and click Search.
4. Click the patch number link, and then click the Download button to obtain the patches.

   The file name for the Smart Update patch is p12426828_1035_Generic.zip.

To download the unicast patch:

1. Open a web browser, go to https://support.oracle.com, and provide your My Oracle Support credentials.
2. In the search field on the top right, enter the My Oracle Support document ID 1397268.1 for the unicast patch and click Search. The My Oracle Support page for Doc ID 1397268.1 is displayed.
3. Click the unicast patch link based on the Oracle WebLogic Server installer version that you've downloaded.

   Oracle WebLogic Server Version	unicast Patch Number
   10.3.0	Patch 13909516
   10.3.2	Patch 13262201
   10.3.3	Patch 13639449
   10.3.4	Patch 12822180
   10.3.5	Patch 12822180
   10.3.6	Patch 12822180

4. On the selected unicast patch page, click Download.

   The file names for the unicast patch versions are:

   Oracle WebLogic Server Version	unicast Patch File Name
   10.3.0	p13909516_103_Generic.zip
   10.3.2	p13262201_10320_Generic.zip
   10.3.3	p13639449_1033_Generic.zip
   10.3.4	p12822180_1034_Generic.zip
   10.3.5	p12822180_1035_Generic.zip
   10.3.6	p12822180_1036_Generic.zip

Downloading JDK 6 (1.6.0_45)

1. Open a web browser and log on to the Java SE 6 Downloads page.
2. In the Java SE Development Kit 6u45 section, select Accept License Agreement.
3. Click the jdk-6u45-linux-x64.bin link to download the kit.

Connecting to the Oracle Compute Cloud Service Instance Using SSH

You access the instance from your local machine by using the ssh command in a UNIX command shell or from Windows by using Putty.

1. Sign in to the My Services application at http://cloud.oracle.com/sign_in. On the My Services Dashboard, click Consoles and select Oracle Compute Cloud Service. On the Oracle Compute Cloud Service Console, click the name of the instance and note down the IP address that appears in the instance name section.
2. In a command shell, run the ssh utility:

   $> ssh -i path_to_SSH_private_key opc@IP_address_of_instance

   In the preceding command:

   • path_to_SSH_private_key is the path to the SSH private key file that matches the public key used when your instance was created.
   • IP_address_of_instance is the public IP address of the instance in n.n.n.n format.
   • opc is the user account.

     Note: This step works only in Oracle-provided instances. You may have a different user provisioned in your custom instances.

     For example:

     $> ssh -i keys/id_rsa opc@192.0.2.100

3. If this is the first time that you're connecting to the instance, confirm the RSA key fingerprint of the instance. In response to the prompts in the ssh utility, enter yes, and then enter the passphrase for the SSH key (if you created a passphrase).

After logging in to the Oracle Compute Cloud Service instance where you want to install the Chef server, install the git client:

sudo yum install -y git

If you're installing the git client over a proxy server, then run the following commands:

sudo sh -c "echo proxy=Your_proxy_server_address >> /etc/yum.conf"
sudo yum install -y git

Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package git.x86_64 0:1.7.1-3.el6_4.1 will be installed
--> Processing Dependency: perl-Git = 1.7.1-3.el6_4.1 for package: git-1.7.1-3.el6_4.1.x86_64
--> Processing Dependency: perl(Error) for package: git-1.7.1-3.el6_4.1.x86_64
--> Processing Dependency: perl(Git) for package: git-1.7.1-3.el6_4.1.x86_64
--> Running transaction check
---> Package perl-Error.noarch 1:0.17015-4.el6 will be installed
---> Package perl-Git.noarch 0:1.7.1-3.el6_4.1 will be installed
--> Finished Dependency Resolution
Dependencies Resolved
==============================================================================================================================================================
 Package                            Arch                           Version                                    Repository                                 Size
==============================================================================================================================================================
Installing:
 git                                x86_64                         1.7.1-3.el6_4.1                            public_ol6_latest                         4.6 M
Installing for dependencies:
 perl-Error                         noarch                         1:0.17015-4.el6                            public_ol6_latest                          28 k
 perl-Git                           noarch                         1.7.1-3.el6_4.1                            public_ol6_latest                          27 k
Transaction Summary
==============================================================================================================================================================
Install       3 Package(s)
Total download size: 4.7 M
Installed size: 15 M
Downloading Packages:
(1/3): git-1.7.1-3.el6_4.1.x86_64.rpm                                                                                                  | 4.6 MB     00:05
(2/3): perl-Error-0.17015-4.el6.noarch.rpm                                                                                             |  28 kB     00:00
(3/3): perl-Git-1.7.1-3.el6_4.1.noarch.rpm                                                                                             |  27 kB     00:00
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Total                                                                                                                         794 kB/s | 4.7 MB     00:06
Running rpm_check_debug
Running Transaction Test
Transaction Test Succeeded
Running Transaction
  Installing : 1:perl-Error-0.17015-4.el6.noarch                                                                                                          1/3
  Installing : perl-Git-1.7.1-3.el6_4.1.noarch                                                                                                            2/3
  Installing : git-1.7.1-3.el6_4.1.x86_64                                                                                                                 3/3
  Verifying  : git-1.7.1-3.el6_4.1.x86_64                                                                                                                 1/3
  Verifying  : perl-Git-1.7.1-3.el6_4.1.noarch                                                                                                            2/3
  Verifying  : 1:perl-Error-0.17015-4.el6.noarch                                                                                                          3/3
Installed:
  git.x86_64 0:1.7.1-3.el6_4.1
Dependency Installed:
  perl-Error.noarch 1:0.17015-4.el6                                      perl-Git.noarch 0:1.7.1-3.el6_4.1
Complete!

1. By using your SSH key, log on to the Oracle Compute Cloud Service instance. See "Connecting to the Oracle Compute Cloud Service Environment Using SSH" in Performing Preinstallation Tasks.
2. On a command prompt in the Oracle Compute Cloud Service instance, run the following:

   sudo useradd oracle
   sudo mkdir /u01
   sudo mkdir /u01/installers
   sudo chown -R oracle:oracle /u01
   sudo su - oracle
   chmod 744 /u01/
   sudo su -
   chmod 777 /tmp

3. Download and save the Oracle WebLogic Server 10.3.x installer on your local machine. See Performing Preinstallation Tasks.
4. Download and save the Smart Update bsu patch and the relevant unicast patch in your local machine. See Performing Preinstallation Tasks.
5. On your local machine, copy the installer file and the patches to the Oracle Compute Cloud Service instance:

   scp -i path_to_SSH_private_key path_to_downloaded_WLS10.3.x_installer/installer_file opc@IP_address_of_instance:/u01/installers
   scp -i path_to_SSH_private_key path_to_downloaded_Smart_Update_bsu_patch/patch_zip_file opc@IP_address_of_instance:/u01/installers
   scp -i path_to_SSH_private_key path_to_downloaded_unicast_patch_version/patch_version_zip_file opc@IP_address_of_instance:/u01/installers
   scp -i path_to_SSH_private_key path_to_downloaded_JDK6_file opc@IP_address_of_instance:/u01/installers

   In the preceding command:

   • path_to_SSH_private_key is the path to the SSH private key file that matches the public key used when your instance was created.
   • path_to_downloaded_WLS10.3.x_installer/installer_file is the downloaded Oracle WebLogic Server 10.3 installer file.
   • path_to_downloaded_Smart_Update_bsu_patch/patch_zip_file is the downloaded Smart Update bsu patch.
   • path_to_downloaded_unicast_patch/patch_zip_file is the downloaded unicast patch.
   • path_to_downloaded_JDK6_file is the downloaded JDK6 installer file
   • opc is the user account.
6. Log on to the Oracle Compute Cloud Service instance and run the following:

   ssh -i path_to_SSH_private_key opc@IP_address_of_instance
   chmod -R 777 /u01/installers/
   sudo su - oracle

7. Clone the GitHub repository:

   git clone https://github.com/oracle/compute-cloud-service-demos.git

   The cloned GitHub repository contains scripts, sample cookbooks, roles, and environments that are used to deploy different Oracle WebLogic Servers on Oracle Compute Cloud Service instances. If you downloaded the scripts from Oracle Technology Network, you’ll find these cookbooks, roles, and environments in the src folder of the zip file that you downloaded and extracted to your local directory on the Oracle Compute Cloud Service instance.

8. Check out the Oracle WebLogic Server recipe from the GitHub repository:

   cd ~/compute-cloud-service-demos/
   git checkout chef-weblogic

   The command checks out all files required to deploy Oracle WebLogic Server.

   Alternatively, you can download the scripts that are required to set up Oracle WebLogic Server 10.3.x from the following link:

   http://www.oracle.com/technetwork/topics/cloud/whatsnew/compute-cloud-service-2760092.html

   Create a folder named compute-cloud-service-demos and unpack the scripts to the folder:

   mkdir compute-cloud-service-demos | tar -xvzf chef-weblogic-compute-cloud-service-demos.tgz -C <path to the compute-cloud-service-demos folder>
   cd compute-cloud-service-demos/

9. Open the /etc/profile file in an editor, and then search for the umask entry:
10. If the umask value isn't set to 022, or if the entry is missing, modify or add it, and then save and close the file:

    umask 022

11. Open the /etc/hosts file add an entry for the instance, and then save and close the file:

    127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4 DNS_name_of_the_instance
    ::1         localhost localhost.localdomain localhost6 localhost6.localdomain6

12. Deploy Oracle WebLogic Server:

    ./compute-cloud-service-demos/src/wls/runAll.sh

13. Verify that your Oracle WebLogic Server 10.3.x deployment is complete by accessing the following:

    http://IP_of_the_instance:port/console/

    You can change the Oracle WebLogic Server Administration Server port and Administrator user name and password by updating the domain.properties file and then restarting the servers:

    /u01/mwhome/wlserver_10.3/common/bin/wlst.sh startNM_WLS.py

Complete the following preinstallation tasks:

• Download the Oracle WebLogic Server 10.3.x installer.
• Download the Smart Update bsu and the unicast patches from My Oracle Support.
• Download the JDK 6 (1.6.0_45) installer.
• Connect to the Oracle Compute Cloud Service environments by using an SSH.
• Set up the Chef server.

Downloading the Oracle WebLogic Server 10.3.x Installer

The software is available as a media or FTP request for those customers who own a valid Oracle WebLogic Server product license for any edition.

1. Request access to these releases. See Oracle Support Document 1071023.1 (Requesting Physical Shipment or Download URL for Software Media) on My Oracle Support.
2. Depending on the version that you want to install, request and download any of the following on your local UNIX-based or Linux machine:
   • WebLogic Server 10.3.0 - server103_linux32.bin
   • WebLogic Server 10.3.2 - wls1032_generic.jar
   • WebLogic Server 10.3.3 - wls1033_generic.jar
   • WebLogic Server 10.3.4 - wls1034_generic.jar
   • WebLogic Server 10.3.5 - wls1035_generic.jar
   • WebLogic Server 10.3.6 - wls1036_generic.jar

Downloading the Smart Update bsu and the unicast Patches

The patches are available as compressed files for those customers who have valid My Oracle Support credentials.

To download the Smart Update bsu patch:

1. Open a web browser, go to https://support.oracle.com, and provide your My Oracle Support credentials.
2. Click the Patches & Updates tab on the My Oracle Support home page.
3. In the Patch Name or Number search field, enter 12426828 for the Smart Update bsu patch and click Search.
4. Click the patch number link, and then click the Download button to obtain the patches.

   The file name for the Smart Update patch is p12426828_1035_Generic.zip.

To download the unicast patch:

1. Open a web browser, go to https://support.oracle.com, and provide your My Oracle Support credentials.
2. In the search field on the top right, enter the My Oracle Support document ID 1397268.1 for the unicast patch and click Search. The My Oracle Support page for Doc ID 1397268.1 is displayed.
3. Click the unicast patch link based on the Oracle WebLogic Server installer version that you've downloaded.

   Oracle WebLogic Server Version	unicast Patch Number
   10.3.0	Patch 13909516
   10.3.2	Patch 13262201
   10.3.3	Patch 13639449
   10.3.4	Patch 12822180
   10.3.5	Patch 12822180
   10.3.6	Patch 12822180

4. On the selected unicast patch page, click Download.

   The file names for the unicast patch versions are:

   Oracle WebLogic Server Version	unicast Patch File Name
   10.3.0	p13909516_103_Generic.zip
   10.3.2	p13262201_10320_Generic.zip
   10.3.3	p13639449_1033_Generic.zip
   10.3.4	p12822180_1034_Generic.zip
   10.3.5	p12822180_1035_Generic.zip
   10.3.6	p12822180_1036_Generic.zip

Downloading JDK 6 (1.6.0_45)

1. Open a web browser and log on to the Java SE 6 Downloads page.
2. In the Java SE Development Kit 6u45 section, select Accept License Agreement.
3. Click the jdk-6u45-linux-x64.bin link to download the kit.

Connecting to the Oracle Compute Cloud Service Instance Using SSH

You access the instance from your local machine by using the ssh command in a UNIX command shell or from Windows by using Putty.

1. Sign in to the My Services application at http://cloud.oracle.com/sign_in. On the My Services Dashboard, click Consoles and select Oracle Compute Cloud Service. On the Oracle Compute Cloud Service Console, click the name of the instance and note down the IP address that appears in the instance name section.
2. In a command shell, run the ssh utility:

   $> ssh -i path_to_SSH_private_key opc@IP_address_of_instance

   In the preceding command:

   • path_to_SSH_private_key is the path to the SSH private key file that matches the public key used when your instance was created.
   • IP_address_of_instance is the public IP address of the instance in n.n.n.n format.
   • opc is the user account.

     Note: This step works only in Oracle-provided instances. You may have a different user provisioned in your custom instances.

     For example:

     $> ssh -i keys/id_rsa opc@192.0.2.100

3. If this is the first time that you're connecting to the instance, confirm the RSA key fingerprint of the instance. In response to the prompts in the ssh utility, enter yes, and then enter the passphrase for the SSH key (if you created a passphrase).

Setting Up the Chef Server

If you’re using Chef to deploy Oracle WebLogic Server 10.3.x, then set up the Chef server and clone the GitHub repository. See the tutorial Deploying Chef Server on Oracle Compute Cloud Service Instances.

1. Download the Oracle WebLogic Server 10.3.x installer file, the Smart Update bsu patch, the relevant unicast patch, and the JDK 6 file to your local machine. See Performing Preinstallation Steps.
2. Copy the installer, the patches, and the JDK 6 file to the /var/www/files directory in the Chef server instance:

   scp -i path_to_SSH_private_key path_to_downloaded_WLS10.3.x_installer/installer_file opc@IP_address_of_Chef_Server_instance:/var/www/files
   scp -i path_to_SSH_private_key path_to_downloaded_Smart_Update_bsu_patch/patch_zip_file opc@IP_address_of_Chef_Server_instance:/var/www/files
   scp -i path_to_SSH_private_key path_to_downloaded_unicast_patch/patch_zip_file opc@IP_address_ofChef_Server_instance:/var/www/files
   scp -i path_to_SSH_private_key path_to_downloaded_JDK6_file opc@IP_address_ofChef_Server_instance:/var/www/files

   In the preceding commands:

   • path_to_SSH_private_key is the path to the SSH private key file that matches the public key used when your instance was created.
   • path_to_downloaded_WLS10.3.x_installer/installer_file is the downloaded Oracle WebLogic Server 10.3 installer file.
   • path_to_downloaded_Smart_Update_bsu_patch/patch_zip_file is the downloaded Smart Update bsu patch.
   • path_to_downloaded_unicast_patch/patch_zip_file is the downloaded unicast patch.
   • path_to_downloaded_JDK6_file is the downloaded JDK 6 installer file.
   • opc is the user account.
3. Ensure that the Oracle Compute Cloud Service instances are created. See the tutorial Creating Oracle Compute Cloud Service Instances Using an Orchestration.
4. Use SSH to connect to the Chef server instance. See "Connecting to the Oracle Compute Cloud Service Instance Using SSH" in Performing Preinstallation Steps in this tutorial.
5. Prepare the environment. See the following sections in the tutorial Deploying Chef Server on Oracle Compute Cloud Service Instances:
   • "Installing the git Client" (Install it on your Oracle Compute Cloud Service instance where the Chef server should run.)
   • "Configuring a Passwordless SSH Connection”
   • "Setting Up the Chef Server" (step 2, clone the GitHub repository)
     Alternatively, you can download the scripts that are required to set up the Chef server from the following link:
     http://www.oracle.com/technetwork/topics/cloud/whatsnew/compute-cloud-service-2760092.html
     
   • "Setting Up the Chef Server" (step 5, install the Chef server)
6. Check out the Oracle WebLogic Server recipe from the GitHub repository:

   cd compute-cloud-service-demos/
   git checkout chef-weblogic
   mkdir ../chef-repo/
   cp -rp src/chef-repo/* ../chef-repo/

   The command checks out all cookbooks, roles, and environments that are required to deploy Oracle WebLogic Server 10.3.x.

   Alternatively, you can download the scripts that are required to set up Oracle WebLogic Server 10.3.x from the following link:

   http://www.oracle.com/technetwork/topics/cloud/whatsnew/compute-cloud-service-2760092.html

   Unpack the scripts to the compute-cloud-service-demos folder:

   tar -xvzf chef-weblogic-compute-cloud-service-demos.tgz -C <path to the compute-cloud-service-demos folder>
   cd compute-cloud-service-demos/
   mkdir ../chef-repo/
   cp -rp src/chef-repo/* ../chef-repo/

7. Open the /home/opc/chef-repo/cookbooks/weblogic/attributes/default.rb file in an editor.
8. Edit the value of the default['oracle']['download_loc'] entry as:

   default['oracle']['download_loc']='https://chef-server_DNS.name/files/

   This is the location of your software repository where the installer files are stored.

9. Edit the values of the Oracle WebLogic Server and patch installer entries as:

   default['oracle']['wls_generic_installer'] = WLS_installer_file_name
   default['oracle']['unicast_patch']= <relevant_unicast_patch_for_the_WLS_version>
   default['oracle']['patchlist']= <patch_id>
   

   patch_id is:

   • For Oracle WebLogic Server 10.3.2: M2B1
   • For Oracle WebLogic Server 10.3.3: PCTX
   • For Oracle WebLogic Server 10.3.4: FBWE
   • For Oracle WebLogic Server 10.3.5: BG1A
   • For Oracle WebLogic Server 10.3.6: YJI2
10. Provide these values for the JDK and JVM entries:

    default['oracle']['java_installer'] = '/u01/mwhome/jdk1.6.0_45'
    default['oracle']['java_install_dir'] = '/u01/mwhome/jdk6'
    default['oracle']['local_jvms'] = '/u01/mwhome/jdk1.6.0_45'

11. Modify the database parameters to point to the database instance that you want to connect to:

    default['oracle']['datasource']['name'] = 'demo-ds'
    default['oracle']['datasource']['driver'] = 'oracle.jdbc.xa.client.OracleXADataSource'
    default['oracle']['datasource']['dbhost'] = 'testhost'
    default['oracle']['datasource']['dbport'] = 1521
    default['oracle']['datasource']['dbsid'] = 'orcl'
    default['oracle']['datasource']['dbusername'] = 'scott'
    default['oracle']['datasource']['dbpassword'] = 'tiger'
    default['oracle']['datasource']['target'] = 'democluster'

    Note: If you do not need a database along with Oracle WebLogic Server 10.3.x, then delete the following entry from the /home/opc/roles/weblogic-domain.json file:

    (recipe[weblogic::create-datasource])

12. Upload the checked-out cookbooks, roles, and environment to the Chef server:

    knife cookbook upload -a
    knife upload /roles
    knife upload /environments

13. Verify that you updated the permissions on your Chef client instance and that you bootstrapped the instance. See "Bootstrapping the Chef Clients" and "Updating Node Permissions" in the tutorial Deploying Chef Server on Oracle Compute Cloud Service Instances.
14. Add run-list items to the client. (Run-list is an ordered list of roles or recipes or both that is run in the exact defined order.)

    knife node run_list add target.instance.dns.name role[java-6] 
    knife node run_list add target.instance.dns.name role[weblogic-generic] 
    knife node show target.instance.dns.name -r

    In the previous example, target.instance.dns.name is the domain name system (DNS) name of the Oracle Compute Cloud Service instance (running the Chef client, and that you've bootstrapped) where Oracle Java and Oracle WebLogic Server 10.3.x will be deployed.

    Note: If you want to install Oracle Coherence as part of the Oracle WebLogic Server installation (available from the 10.3.3 version), then specify the role as role[weblogic-coh-generic] instead of role[weblogic-generic].

    knife node run_list add <the DNS name of your Compute Service instance> 'role[java-6]' 
    <the DNS name of your Compute Service instance>   
      run_list:     
        role[java-6]     
     
    knife node run_list add <the DNS name of your Compute Service instance> 'role[weblogic-generic]' 
    <the DNS name of your Compute Service instance>   
      run_list:     
        role[java-6]     
        role[weblogic-generic]   
    
    knife node show <the DNS name of your Compute Service instance> -r 
    <the DNS name of your Compute Service instance>:   
      run_list:     
        role[java-6]     
        role[weblogic-generic]

15. Deploy Oracle Java and Oracle WebLogic Server 10.3.x on the bootstrapped client instance:

    knife ssh -x opc 'role:java-6' 'sudo chef-client'
    knife ssh -x opc 'role:weblogic-generic' 'sudo chef-client'

    After Oracle Java and Oracle WebLogic Server 10.3.x deployment is completed, the following message is displayed:

    Chef Client finished, <x/y> resources updated in <n> seconds

16. Verify your Oracle Java and Oracle WebLogic Server 10.3.x deployment:

    knife status 'role:java-6'
    knife status 'role:weblogic-generic'

    knife status 'role:java-6' 
    5 minutes ago, <the DNS name of your Compute Service instance>, oracle 6.6.
    knife status 'role:weblogic-generic'
    10 minutes ago, <the DNS name of your Compute Service instance>, oracle 6.6.

17. Start the Oracle WebLogic Server 10.3.x Administration Server:

    sudo su - oracle
    cd /u01/mwhome/user_projects/domains/clouddemodomain
    ./startWebLogic.sh

18. From a web browser, access the Oracle WebLogic Server Administration Console:

    http://<ip of the Chef client>:7001/console

    Specify the username and password as weblogic and welcome1 respectively, or you can also specify user credentials in the attributes/default.rb file. Restart the servers for the change to take effect.