Oracle VirtualBox Template for Oracle Enterprise Manager Cloud Control 12c Guide

Oracle VM VirtualBox for Oracle Enterprise Manager Cloud Control 12c Release 5 (12.1.0.5) Media Pack v1 for 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 VirtualBox Template for Oracle Enterprise Manager Cloud Control 12c Release 5 (12.1.0.5). This template can be used to provision new guest virtual machines hosting Oracle Management Service (OMS), Oracle Management Agent(s) and the Management Repository database.

Requirements
================================================================
. VirtualBox Manager version 4.2.18 or higher

. The VBox template requires 3.75 GB of memory, so make sure that you have at least that much free memory on your machine.

You may choose to allocate more memory to the template via the VBox manager to improve performance. To do so:

- Run the VBox Manager

- Import the appliance

- Select Settings-->System-->Base Memory

. At least 50 GB of free disk space

. Run the commannd "WMIC CPU Get NumberOfCores,NumberOfLogicalProcessors /Format:List" on your Windows box to get the number of cores and logical processors. Ideally, the machine should have 2 cores and 4 logical processors.

. The VT-X option should be enabled in the BIOS; otherwise VBox will not be able to enable > 1 virtual CPU

Deploying the VirtualBox Template
================================================================

1. Download and install Oracle VM VirtualBox on your host system.

2. Download and extract the VirtualBox files as follows:

a) Extract all of the zip files using unzip. This will create files with the .ova extension.

b) Run the following command to combine the .ova files into one .ova file:

On Linux: cat VBox*.ova > EM12cR5.ova

On Windows: type VBox*.ova > EM12cR5.ova

3. Import your VirtualBox template as follows:

a) In the VirtualBox Manager, run the following command to launch the Appliance Import Wizard:

File > Import Appliance

b) Click Choose... to browse to the directory you re-assembled all the files in and select the .ova file.

c) You will see the virtual machine as "(Powered Off)" after the import has completed.

4. After the import has completed, double-click the virtual machine or click "Start" to start the virtual machine.

Note that the O/S passwords for the "root" and "oracle" O/S users are "welcome1". The Enterprise Manager Cloud Control password is "welcome1".

Using The Guest Virtual Machine
================================================================
Refer to the notes below for details on using and accessing the guest virtual machine and the Enterprise Manager software components installed on it.

Note that the guest virtual machine image is strictly intended for Enterprise Manager setup or for proof of concept efforts. It is NOT intended to be used as a production site.

1. 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 and choose "Run in Terminal" to start all processes (database, listener, OMS and Management Agent).

Next, click the "EM12cR5" icon on the desktop to launch the Enterprise Manager Cloud Control console.

The desktop icon "stop_all.sh" can be used to stop all processes. Start/stop scripts are also located in the home directory of the "oracle" user.

2. The guest virtual machine template contents include the following:

- Oracle Database 11.2.0.4.0 (with PSU 11.2.0.4.7, which has CPUAPR2015

- Enterprise Manager Cloud Control 12.1.0.5, 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.

3. All software is installed under the /u01/OracleHomes directory.

4. 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).

5. All xterm 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).

It is recommended that you change all passwords to facilitate Separation of Duty. The accounts for which passwords need to be changed are as follows:

- O/S accounts: root, oracle
- Database accounts: sys, system
- Enterprise Manager accounts: sysman, dbsnmp, mgmt_view
- Weblogic Server accounts: weblogic, weblogic_mntr, node_mgr

Refer to the product documentation as needed to change these passwords:

- Database: http://www.oracle.com/pls/db121/homepage

- Enterprise Manager: http://docs.oracle.com/cd/E24628_01/index.htm

. Ensure that the O/S image is patched with the latest security fixes.

Known Issues
================================================================

ISSUE 1: start_all.sh Does Not Start All Enterprise Manager Processes

. To start all Enterprise Manager processes, run the commands below:

- Start the Management Repository database:

./start_db.sh from /home/oracle

- Start the OMS instance:

/u01/OracleHomes/Middleware/oms/bin/emctl start oms

. To stop all Enterprise Manager processes, run the commands below:

- Stop the OMS:

/u01/OracleHomes/Middleware/oms/bin/emctl stop oms

- Stop the Management Repository database:

./stop_all.sh

- Kill any process that is running within the /u01 directory

ISSUE 2: Deploying Management Agents

1. On the remote target, edit the /etc/hosts file & append the following line:

#sudo vi /etc/hosts <VBox IP of the OMS host>
emcc.example.com emcc

2. On the VBox guest machine, disable the firewall by logging in as root user with following command:

#sudo /etc/init.d/iptables stop

Perform the following steps on the VBox guest machine:

cd <OMS_Home>/bin

./emctl secure oms -sysman_pwd <pwd> -reg_pwd <pwd> -host oms-host-name -reset -console

cd <AgentHome>/bin

./emctl secure agent 

ISSUE 3: Incorrect $AGENT_HOME Is Set In Bash Console

Perform the following steps on the VBox guest machine to set the correct AGENT_HOME.

1. Execute the following: 

#vi .bashrc

2. Update the AGENT_HOME value to point to the 12.1.0.5.0 Management Agent location:

/u01/OracleHomes/agent/core/12.1.0.5.0
AGENT_HOME=/u01/OracleHomes/agent/core/12.1.0.5.0