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

Oracle VM VirtualBox 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 VirtualBox Template for Oracle Enterprise Manager Cloud Control 13c Release 2. 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 is required

- The VBox template requires 8 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

- Ensure at least 60 GB of free disk space is available

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

- 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_EM13_2_0_0_Linux64_1.ova VBox_EM13_2_0_0_Linux64_2.ova VBox_EM13_2_0_0_Linux64_3.ova VBox_EM13_2_0_0_Linux64_4.ova VBox_EM13_2_0_0_Linux64_5.ova VBox_EM13_2_0_0_Linux64_6.ova VBox_EM13_2_0_0_Linux64_7.ova VBox_EM13_2_0_0_Linux64_8.ova VBox_EM13_2_0_0_Linux64_9.ova  VBox_EM13_2_0_0_Linux64_10.ova > VBox_EM13_2_0_0_Linux64.ova

      On Windows: type VBox_EM13_2_0_0_Linux64_1.ova VBox_EM13_2_0_0_Linux64_2.ova VBox_EM13_2_0_0_Linux64_3.ova VBox_EM13_2_0_0_Linux64_4.ova VBox_EM13_2_0_0_Linux64_5.ova VBox_EM13_2_0_0_Linux64_6.ova VBox_EM13_2_0_0_Linux64_7.ova VBox_EM13_2_0_0_Linux64_8.ova VBox_EM13_2_0_0_Linux64_9.ova VBox_EM13_2_0_0_Linux64_10.ova  > VBox_EM13_2_0_0_Linux64.ova

3. Import the 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. You will see the virtual machine as "(Powered Off)" after the import completes.

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 "EM13cR2" 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 12.1.0.2.0 (with PSU 12.1.0.10.0, which has PSUJUL2016

    - Enterprise Manager Cloud Control 13c Release 2, 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 duties. The accounts for which passwords need to be changed are:

    - 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: BI Publisher (BIP) Process Fails to Start

If the BIP process fails to start, start it with the following command:

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

ISSUE 2: Deploying Management Agents from a Windows VBox Machine

1. If deploying a guest VBox on a Windows machine, update the deployed template settings as follows:
   
    a) Power down the guest VBox .

    b) Go to Settings for the guest VBox

    c) Go to Network

    d) Select "Attached to" as "Bridge Adapter" in "Adapter 1" tab

    e) Start the guest VBox 
    
2. On the remote target, modify the /etc/hosts file:

    a) #sudo vi /etc/hosts <VBox IP of the OMS host>

    b) Modify the following line in the file:
    
        emcc.example.com emcc

3. On the guest VBox machine, log in as the 'root' user and disable the firewall with the following command:

    a) #su

    b) Provide "welcome1" as the 'root' user password

    c) #/etc/init.d/iptables stop

    d) .#exit

4. Perform the following steps on the VBox guest machine:

    a) .cd <OMS_Home>/bin

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

    c) .cd <AgentHome>/bin

    d) ../emctl secure agent 

                                                                                                                                          - - end - -