Oracle Communications Services Gatekeeper Preparation Guide

Edition 1.0 June 2014

Copyright © 2014, Oracle and/or its affiliates. All rights reserved. Disclaimer This document contains proprietary information and is protected by copyright and other intellectual property laws. You may copy and print this document solely for your own use in an Oracle training course. The document may not be modified or altered in any way. Except where your use constitutes "fair use" under copyright law, you may not use, share, download, upload, copy, print, display, perform, reproduce, publish, license, post, transmit, or distribute this document in whole or in part without the express authorization of Oracle. The information contained in this document is subject to change without notice. This document is not warranted to be error-free. Restricted Rights Notice If this documentation is delivered to the United States Government or anyone using the documentation on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS The U.S. Government’s rights to use, modify, reproduce, release, perform, display, or disclose these training materials are restricted by the terms of the applicable Oracle license agreement and/or the applicable U.S. Government contract. Trademark Notice Oracle and Java are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Table of Contents Preparations for Practices ..............................................................................................................................1-1 Preparations Overview ...................................................................................................................................1-3 Preparation 1: Downloading and Configuring the Virtual Machine .................................................................1-4 Preparation 2: Check and Change the Networking Configuration ..................................................................1-5 Preparation 3: Preparing the Practices ..........................................................................................................1-7 Preparation 4: Configuring Oracle XE ............................................................................................................1-8 Preparation 5: Installing SoapUI (Optional) ....................................................................................................1-10

Preparations for Practices Chapter 1

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 1

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 2

Preparations Overview Overview To be able to install and run Oracle Communications Services Gatekeeper, you need a certified platform. In these preparations you will download and set up a virtual machine that runs Oracle Linux and includes an installation of Oracle Database Express Edition (Oracle XE). This virtual machine will be the platform on which you will install Services Gatekeeper.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 3

Preparation 1: Downloading and Configuring the Virtual Machine Overview In this preparation, you will download, set up, and configure a base virtual machine that you will use for the labs.

Tasks Downloading and Setting Up the Virtual Machine 1. Open a browser and go to http://www.oracle.com/technetwork/apps-tech/sdp-vm2121008.html. 2. Locate and click the Download and Setup Instructions for SDP-VM link and follow the instructions. Note: You need to log in with your Oracle Technology Network account. If you do not have an account, you need to create one. Renaming the Virtual Machine 3. Start Oracle VM VirtualBox Manager. 4. Right-click SDP_VM and select Show in Explorer. A Windows Explorer window appears. 5. Right-click the SDP_VM folder and select Properties. The SDP_VM Properties dialog appears. 6. In the Attributes section, deselect Read-only and click OK. The Confirm Attribute Changes dialog box appears. 7. Click OK. 8. In VirtualBox Manager, right-click SDP_VM and select Settings. The SDP_VM - Settings screen appears. 9. In the Name field, replace SDP_VM with OCSG. 10. Click OK. The virtual machine is now named OCSG.

Summary You now have a working virtual machine.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 4

Preparation 2: Check and Change the Networking Configuration Overview In this preparation, you will make sure that the network settings are correct.

Tasks Checking the Networking Settings in VirtualBox 1. Start Oracle VM VirtualBox Manager. 2. In the list of virtual machines, right-click OCSG and select Settings. The OCSG - Settings screen appears. 3. From the list of settings, select Network. The Network panel appears. 4. From the Attached to list, select NAT. 5. Click Advanced. The advanced settings are expanded. The MAC Address field shows the MAC address assigned to the virtual network interface. This address is used in your virtual machine, and you will reconfigure the networking settings in the following instructions, if necessary. 6. Click OK. The VirtualBox Manager appears again. Checking the Networking Settings in Linux 7. Start the virtual machine and log in as the user oracle, with the password oracle. 8. Open a new terminal window and check the network settings: $ ifconfig You should now see that the network interface is using the MAC address that you saw in step 5. The IP address should be set in the range of your local DHCP server. You might also see that the network interface is named eth1 instead of the normal eth0. In the following instructions you will reset the network interface to eth0, if necessary. Configuring the Network Interface If the network interface is already named eth0, skip this task and go to step 12, under "Changing the Host Name." 9. Open the udev network rule file for edit: $ sudo gedit /etc/udev/rules.d/70-persistent-net.rules 10. Copy the MAC address from eth1 to eth0 and remove the rule for eth1. Example before edit: # PCI device 0x8086:0x100e (e1000) SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="08:00:27:21:72:7a", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0" # PCI device 0x8086:0x100e (e1000)

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 5

SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="08:00:27:a3:41:43", ATTR{type}=="1", KERNEL=="eth*", NAME="eth1" Example after edit: # PCI device 0x8086:0x100e (e1000) SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="08:00:27:a3:41:43", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0" 11. Save the file and close the editor. Changing the Host Name 12. Open the hosts file for edit: $ sudo gedit /etc/hosts 13. Replace oel64 with oscg. 14. Save the file and close the editor. 15. Open the network configuration file for edit: $ sudo gedit /etc/sysconfig/network 16. Set the host name to ocsg, then save and close the file. HOSTNAME=ocsg 17. Restart the virtual machine: $ reboot 18. Log in as the user oracle, with the password oracle. 19. Open a new terminal window and check the network settings: $ ifconfig You should now see that the network interface is named eth0 and that the prompt is set to ocsg. Summary You have now changed the networking settings for the virtual machine.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 6

Preparation 3: Preparing the Practices Overview In this preparation, you will unpack the course practice files and configure the Java version to use.

Tasks Preparing to Install the Practice Files Together with this document is a file named student.tar, which contains all the files that you will use in the practices. 1. Copy the student.tar file to the shared directory on your host computer, which should be C:\VMs\Shared. Starting Your Virtual Machine 2. If your virtual machine is not running, start the virtual machine and log in as the user oracle, with the password oracle. 3. Open a new terminal window and mount the shared directory: $ ./mount_shared.sh Extracting the Practice Files 4. Create a directory to hold the practice files: $ mkdir ocsgCourse 5. Extract the practice files: $ cd ocsgCourse $ tar –xvf /mnt/shared/student.tar Changing the Default Java Version Services Gatekeeper is certified for Java 6, so to avoid unnecessary troubleshooting, configure the practice environment to use Java 6. 6. Change the symbolic links for java, javac, jconsole and jar: $ cd /usr/bin $ sudo rm –f java javac jconsole jar $ sudo ln -s /u01/java/jdk1.6.0_45/bin/java java $ sudo ln -s /u01/java/jdk1.6.0_45/bin/javac javac $ sudo ln -s /u01/java/jdk1.6.0_45/bin/jconsole jconsole $ sudo ln -s /u01/java/jdk1.6.0_45/bin/jar jar

Summary You have now unpacked the files that you will use in the practices and configured the Java version to use.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 7

Preparation 4: Configuring Oracle XE Overview In this preparation, you will configure Oracle XE and create database users that will be used in the practices.

Tasks Starting Your Virtual Machine When you start your virtual machine, it is good practice to also mount the shared directory. 1. If your virtual machine is not running, start the virtual machine and log in as the user oracle, with the password oracle. 2. Open a new terminal window and mount the shared directory: $ ./mount_shared.sh Configuring a New Host Name for Oracle XE Because you changed the host name for the virtual machine, you need to configure the host name for Oracle XE. 3. Run the following command to check the status of the Oracle XE installation: $ sudo /etc/init.d/oracle-xe status 4. Examine the output. You will probably see a number of error messages, looking like this: LSNRCTL for Linux: Version 11.2.0.2.0 - Production on nnn Copyright (c) 1991, 2011, Oracle.

All rights reserved.

Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=IPC)(KEY=EXTPROC_FOR_XE))) TNS-12541: TNS:no listener TNS-12560: TNS:protocol adapter error TNS-00511: No listener Linux Error: 2: No such file or directory Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=oel64)(PORT=1521))) TNS-12545: Connect failed because target host or object does not exist TNS-12560: TNS:protocol adapter error TNS-00515: Connect failed because target host or object does not exist 5.

6. 7. 8.

Open the network configuration files for Oracle XE: $ cd /u01/app/oracle/product/11.2.0/xe/network/admin $ sudo gedit listener.ora tnsnames.ora In both files, change oel64 to ocsg. Save both files and close the editor. Reload the configuration files: $ sudo /etc/init.d/oracle-xe force-reload Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 8

9.

Check the status again: $ sudo /etc/init.d/oracle-xe status This time, there should be no errors.

Configuring the Oracle XE Service Configure the Oracle XE service to automatically start when the virtual machine starts. 10. Check for which run levels the Oracle XE service is automatically started: $ chkconfig --list oracle-xe oracle-xe 0:off 1:off 2:off 3:off 4:off 5:off 6:off 11. Set the service to automatically start: $ sudo chkconfig --level 2345 oracle-xe on 12. Verify that the Oracle XE service is set to automatically start for run levels 2 to 5: $ chkconfig --list oracle-xe oracle-xe 0:off 1:off 2:on 3:on 4:on 5:on 6:off 13. Restart Oracle XE: $ sudo /etc/init.d/oracle-xe restart Creating Database Users 14. Create the database user for the practices by running the db_configure script: $ cd $ cd ocsgCourse/Scripts $ ./db_configure 15. List the database users you just created: $ ./sql_list_ocsg_users.sh ... USERNAME ACCOUNT_STATUS ------------------------OCSG_CLUSTER OPEN OCSG_LAB OPEN OCSG_DEMO OPEN ...

Summary You have now configured Oracle XE and created the database users that will be used in the practices.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 9

Preparation 5: Installing SoapUI (Optional) Overview In this preparation, you will download and install SoapUI. There are a number of optional practices where you will use SoapUI to simulate SOAP and RESTful clients and servers. SoapUI is available in both a free, open source version and a commercial version. You will install the free, open source version. SoapUI is available with or without embedded Java and with or without an installer feature. You will download and install the 64-bit version for Linux, which is available only as a shell file.

Tasks Downloading SoapUI 1. Start a web browser and navigate to http://www.soapui.org/. 2. Download the latest version of the free SoapUI tool for 64-bit Linux. At the time of this writing, the latest version was 5.0.0, and the filename to download was SoapUI-x645.0.0.sh. Note: If you have problems downloading the shell file in one type of browser, try a different browser. 3. Copy the downloaded file to the shared directory on your host computer, which should be C:\VMs\Shared. Starting Your Virtual Machine 4. If your virtual machine is not running, start the virtual machine and log in as the user oracle, with the password oracle. 5. Open a new terminal window and mount the shared directory: $ ./mount_shared.sh Installing SoapUI 6. Change to the shared directory: $ cd /mnt/shared 7. Make the SoapUI installer file executable: $ chmod +x SoapUI-x64-5.0.0.sh 8. Run the installer: $ sudo ./SoapUI-x64-5.0.0.sh The installer starts. 9. Click Next. The License Agreement screen appears. 10. Select I accept the agreement and click Next. The Select Destination Directory screen appears. 11. In the Destination directory field, enter /opt/SoapUI/SoapUI-5.0.0 and click Next. The Select Components screen appears. 12. Deselect HermesJMS and Tutorials, and then click Next. The download LoadUI screen appears. 13. Click Next. Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 10

The Select Directory for Symlinks screen appears. 14. Click Next. The Select Additional Tasks screen appears. 15. Click Next. After installation, the Completing the SoapUI Setup Wizard screen appears. 16. Deselect View the release notes and Run SoapUI 5.0.0, and then click Finish. Creating a Desktop Launcher (optional) Complete this task if you want a shortcut on the desktop for SoapUI. 17. In the Applications menu, select Other, right-click SoapUI-5.0.0, and select Add this launcher to desktop. A new launcher with the SoapUI icon appears on the desktop. 18. Double-click the SoapUI icon. SoapUI opens in a separate window. 19. From the File menu, select Exit without saving.

Summary You have now downloaded and installed SoapUI.

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 11

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

Preparations for Practices Chapter 1 - Page 12