Oracle VM Template for Oracle Enterprise Manager Cloud Control 13c Release 2 Media Pack v1 for Linux x86 64 bit ---------------------------------------------------------------- NOTE: This template is intended for testing or demonstration usage only. It is NOT intended to be used in a production Enterprise Manager environment. ---------------------------------------------------------------- This document contains information on the Oracle VM Template for Oracle Enterprise Manager Cloud Control 13c Release 2. This template can be used to provision new guest virtual machines running Oracle Enterprise Manager Cloud Control 13c Oracle Management Service (OMS), Oracle Management Agent(s) and the Management Repository database. You can use one of the following options can be used to create the guest virtual machine: . Using the Oracle VM Template using Oracle Enterprise Manager Cloud Control Console . Using the Oracle VM Template using Oracle VM server terminal Creating a Guest Virtual Machine with the Oracle VM Template Using Oracle Enterprise Manager Cloud Control Console ================================================================ Step 1: Download the Files ---------------------------------------------------------------- 1. Download the template files on a Linux x86-64 machine running an Enterprise Manager Cloud Control 13c Release 2 Management Agent. For example, if the directory you choose on the machine is /scratch, the files will be located as follows (note that all .zip filenames are examples only): /scratch/V123451-01.zip /scratch/V123452-01.zip /scratch/V123453-01.zip /scratch/V123454-01.zip /scratch/V123455-01.zip /scratch/V123456-01.zip /scratch/V123457-01.zip 2. The downloaded files are compressed with the .zip format. Execute the following to uncompress each file using any unzip tool, or download a utility from eDelivery at the following URL: http://updates.oracle.com/unzips/unzips.html # cd /scratch # unzip V123451-01.zip # unzip V123452-01.zip # unzip V123453-01.zip # unzip V123454-01.zip # unzip V123455-01.zip # unzip V123456-01.zip # unzip V123457-01.zip Uncompressing the .zip files will create tar files ending in the .tgz extension. Run the following command to create the "OVM_EM" directory and extract the files there: # cat OVM_EM13*.tgz | tar -xzvf - (Note the "-" at the end of the command.) Step 2: Create a Software Library Component ---------------------------------------------------------------- Note: Before you begin, ensure that the following prerequisites have been met on the Oracle Management Service (OMS) instance: . The Software Library must be configured . The Virtualization Plug-in must be deployed 1. In the Enterprise Manager Cloud Control console, navigate to Provisioning and Patching > Software Library. 2. Select "Virtualization" as the Type, and "Template" as the Subtype. 3. Use the "Create Entity" operation to create a Software Library component. When creating a "Template" component, you will be asked to choose an option to pick the source of the Template binaries. 4. Select "Agent Upload" to upload the binaries from the directory (for example, /scratch) on the Management Agent host to the Software Library storage. Step 3: Create the Guest Virtual Machine ---------------------------------------------------------------- 1. In the Enterprise Manager Cloud Control console, navigate to the Infrastructure Cloud homepage. 2. Use the "Deploy Template" operation on a server pool to create the guest virtual machine 3. Select the Software Library component for the template and deploy. See "Administering and Monitoring the Cloud for IaaS" in the Enterprise Manager Cloud Administration Guide to learn how to deploy guest virtual machines using Oracle VM Templates: http://docs.oracle.com/cd/E24628_01/doc.121/e28814/cloud_iaas_monitor.htm 4. Once the job to deploy the template completes, you should be able to go to the "Launch VNC Console" operation to get VNC access to the machine. Follow the instructions in the "Configuring the Guest Virtual Machine using VNC Console" section below to configure the Guest virtual machine. Creating a Guest Virtual Machine with the Oracle VM Template Using the VM Server Terminal 2.x ================================================================ ---------------------------------------------------------------- NOTE: This template is intended for testing or demonstration usage only. It is NOT intended to be used in a production Enterprise Manager environment. ---------------------------------------------------------------- Step 1: Download the Files ---------------------------------------------------------------- 1. Download the template files to the /OVS/running_pool directory on Oracle VM server (note that all .zip filenames are examples only): /OVS/running_pool/V123451-01.zip /OVS/running_pool/V123452-01.zip /OVS/running_pool/V123453-01.zip /OVS/running_pool/V123454-01.zip /OVS/running_pool/V123455-01.zip /OVS/running_pool/V123456-01.zip /OVS/running_pool/V123457-01.zip 2. The downloaded files are compressed with the .zip format. Execute the following to uncompress each file using any unzip tool, or download a utility from eDelivery at the following URL: http://updates.oracle.com/unzips/unzips.html # cd /OVS/running_pool # unzip V123451-01.zip # unzip V123452-01.zip # unzip V123453-01.zip # unzip V123454-01.zip # unzip V123455-01.zip # unzip V123456-01.zip # unzip V123457-01.zip Uncompressing the .zip files will create tar files ending in the .tgz extension. Run the following command to create the "OVM_EM" directory and extract the files there: # cat OVM_EM13*.tgz | tar -xzvf - (Note the "-" at the end of the command.) 1. Edit the file /OVS/running_pool/OVM_EM/vm.cfg and replace the occurrences of the string "seed_pool" with "running_pool". 2. Set the MAC address as follows: a) Run the following python command to generate a new MAC address: # PYTHONPATH=/opt/ovs-agent-2.2 python -c \"from OVSCommons import randomMAC; print randomMAC()" b) Edit the vm.cfg file and change the line starting with 'vif' as follows for PVM: vif = [ 'bridge=, mac=00:16:3E:xx:xx:xx', ] or as follows for PVHVM: vif = [ 'bridge=, type=netfront, mac= 0:16:3E:xx:xx:xx', ] The value for 00:16:3E:xx:xx:xx is the MAC address generated in the previous step. The value for is the name of the bridge to be used for the guest virtual machine. Step 2: Create the Guest Virtual Machine ---------------------------------------------------------------- 1. Login to the Oracle VM server machine. 2. Create a guest virtual machine as follows: # cd /OVS/running_pool/OVM_EM # xm create vm.cfg 3. Use the following command on the Oracle VM server to get the VNC port for the guest virtual machine: # virsh dumpxml Note: On Oracle VM server, the vncunused=1 parameter allocates a new VNC port number each time a guest virtual machine is created. Port numbers are allocated starting at the default VNC port number 5900. Therefore, the first guest virtual machine is allocated port 5900, the second guest virtual machine is allocated port 5901, the third gets port 5902, and so on. 4. Use VNC Viewer to access the guest virtual machine as it starts up: : No password is required. If this is the first guest virtual machine on the Oracle VM server, you can VNC to :5900 Configuring the Guest Virtual Machine from the VNC Console ================================================================ On accessing the VNC console of the guest virtual machine, you will be prompted to enter the information below: 1. Static IP or DHCP: Static IP is recommended 2. Network netmask address 3. Hostname 4. Default Gateway IP address 5. DNS server IP address Creating a Guest Virtual Machine with the Oracle VM Template Using the VM Server Terminal 3.x ================================================================ ---------------------------------------------------------------- NOTE: This template is intended for testing or demonstration usage only. It is NOT intended to be used in a production Enterprise Manager environment. ---------------------------------------------------------------- Step 1: Download the Files ---------------------------------------------------------------- 1. Download the template files to the /OVS/running_pool directory on Oracle VM server (note that all .zip filenames are examples only): /OVS/running_pool/V123451-01.zip /OVS/running_pool/V123452-01.zip /OVS/running_pool/V123453-01.zip /OVS/running_pool/V123454-01.zip /OVS/running_pool/V123455-01.zip /OVS/running_pool/V123456-01.zip /OVS/running_pool/V123457-01.zip 2. The downloaded files are compressed with the .zip format. Execute the following to uncompress each file using any unzip tool, or download a utility from eDelivery at the following URL: http://updates.oracle.com/unzips/unzips.html # cd /OVS/running_pool # unzip V123451-01.zip # unzip V123452-01.zip # unzip V123453-01.zip # unzip V123454-01.zip # unzip V123455-01.zip # unzip V123456-01.zip # unzip V123457-01.zip Uncompressing the .zip files will create tar files ending in the .tgz extension. 3. Run the following command to create the "OVM_EM13_2_0_0_Linux64.tgz" file: # cat OVM_EM13*.tgz > OVM_EM13_2_0_0_Linux64.tgz 4. Place the files that make up a virtual machine, or an archive of those files, in a location accessible by Oracle VM Manager using any of these protocols: HTTP, HTTPS or FTP. For example: http://http.example.com/OVM_EM13_2_0_0_Linux64.tgz 5. Log in to th OVM console: https://ovmexmaple.com:7002/ovm/console 6. Click the Repositories tab. 7. Select the repository you want to import the template into. 8. Select VM Templates in the navigation tree. 9. Click Import VM Template in the management pane toolbar. 10. Select an Oracle VM Server to use to the perform the template import. 11. Provide the VM Template URL. For example: http://http.example.com/OVM_EM13_2_0_0_Linux64.tgz Click OK to import the template. Step 2: Create and Start the Guest Virtual Machine from the Template ---------------------------------------------------------------- 1. Click the "Servers and VMs" tab. 2. Select the server pool and click "Create Virtual Machine" in the toolbar. 3. Select the "Clone from an Existing VM Template" option, then click Next to continue. 4. Provide the required details (VM template , VM name , Server Pool ) then click Finish. Note that the cloning job may take some time. Once the job is completed, the virtual machine will be deployed to an Oracle VM Server in the server pool. 5. Click the "Servers and VMs" tab. 6. Select the cloned template, then click the Start icon to start the guest virtual machine. After the guest virtual machine starts, click the Launch Console icon. Configuring the Guest Virtual Machine from the VNC Console ================================================================ On accessing the VNC console of the guest virtual machine, you will be prompted to enter the information below: 1. Static IP or DHCP: Static IP is recommended 2. Network netmask address 3. Hostname 4. Default Gateway IP address 5. DNS server IP address Using the Guest Virtual Machine ================================================================ NOTE: The following instructions are valid for both Oracle Virtual Machine 2.x and 3.x. Once the guest virtual machine has been created, refer to the notes below to use/access the guest virtual machine and the EM software components installed on the guest. 1. The guest virtual machine template contents include the following: - Oracle Database 12.1.0.2.0 - Enterprise Manager Cloud Control 13c Release 1, with the latest plug-ins deployed. The text file README.FIRST in the home dir of the "oracle" user has details on the install environment, Cloud Control console URL, etc. 2. All software is installed under the /u01/OracleHomes directory. The guest virtual machine creation log file is: /var/log/emgc*.log. 3. All terminals of the "oracle" O/S user have the required environment variables set for the various homes installed on the guest virtual machine (refer to .bashrc as needed). 4. After the guest virtual machine has been created, you will be logged in as the "oracle" user. Click on the "start_all.sh" icon on the desktop to start all processes (database, listener, OMS and Management Agent). The Enterprise Manager Cloud Control Start/stop scripts are located in the home dir of the "oracle" unix user and are named "start_all.sh" and "stop_all.sh". 5. The following default passwords have been set: - Unix password for the "root" O/S user and the "oracle" O/S user is "welcome1" - The Enterprise Manager Cloud Control password is "welcome1" You are strongly advised to change all of the above passwords as soon as possible. Refer to the product documentation below for instructions: - Database: http://www.oracle.com/pls/db121/homepage - Enterprise Manager: http://docs.oracle.com/cd/E24628_01/index.htm Run the the following commands to regenerate the certificates: cd /u01/OracleHomes/Middleware/oms/bin ./emctl secure oms -sysman_pwd welcome1 -reg_pwd welcome1 -host -reset -console cd /u01/OracleHomes/agent/agent_13.2.0.0.0/bin ./emctl secure agent Ensure that the O/S image is patched with the latest security fixes. Known Issues ================================================================ ISSUE 1: JVMs And JVM Pool Not Displayed Under The Domain Hierarchy If Enterprise Manager is installed using a VM template, the JVMs and the JVM pool will not be displayed under the domain hierarchy. This happens because the hostname is emcc.example.com. For the JVM pool and the JVMs to be created under the domain hierarchy, the remote host must be configures with the following workaround. On remote the remote target, append the following lines: #sudo vi /etc/hosts emcc.example.com emcc ISSUE 2: Log Viewer Is Not Displayed When Oracle Management Service is configured with a listen address that is not accessible/visible from the other hosts in the network, the log viewer may appear to be failing. For example, assume OMS is running on the host 'myhost.company.com', but the listen address of the EMGC_OMS1 managed server is configured as 'emcc.exmaple.com'. In this case, the log viewer will fail while making a JMX Connection from OMS to the external WebLogic domain. To work around this issue, configure the "External Listen Address" attribute on the EMGC_OMS1 managed server with the actual hostname: 1. Login to the WebLogic Console of the EMGC_OMS1 managed server. 2. Click on "Servers" on the home page, then click on the 'EMGC_OMS1' link to go the EMGC_OMS1 managed server configuration page. 3. On the configuration page, expand the "Advanced" section and update the "External Listen Address" field to 'myhost.company.com'. ISSUE 3: Heap Snapshot Job Fails The Heap Snapshot job fails at step: Load heap snapshot into rep in vm template env. To work around this issue, follow the steps below to load the heap using the loadheap.sh script . 1. Unzip loadheap.zip. 2. Invoke the create_jvm_diagnostic_db_user.sh to create the JVM diag user. 3. Invoke the loadheap.sh script. ISSUE 4: VM Template Deployment Using DHCP Fails Deployment of the VM template using DHCP with a dynamic hostname is not working. To avoid this issue, deploy the VM template using one of these methods: . Using static IP configuration; or . Using DHCP with a fixed hostname ISSUE 5: Extra stop_oms scripts under /home/oracle directory There were extra stop_oms scripts under /home/oracle directory. To avoid this issue, use only stop_oms.sh script which is used while starting all the process using start_all.sh