Oracle® Enterprise Manager Ops Center

Adding a Proxy Controller

12c Release 2 (12.2.2.0.0)

E52883-03

December 2014

This guide provides an end-to-end example for how to use Oracle Enterprise Manager Ops Center.

Introduction

This guide describes how to add and configure a new Proxy Controller.

As your environment grows and changes, you can add Proxy Controllers to better accommodate it. Add a Proxy Controller in the following scenarios:

- You are adding additional assets and your existing Proxy Controllers are under heavy load

- You are adding assets on a network that your existing Proxy Controllers cannot access

You will complete the following tasks:

- Identifying a Host System

- Installing and Configuring a Proxy Controller

- Configuring DHCP

- Associating Networks

See Related Articles and Resources for links to related information and articles about Proxy Controllers, DHCP, and networks.

What You Will Need

You will need the following:

- An installed Oracle Enterprise Manager Ops Center Enterprise Controller

- A host system to run the Proxy Controller software

- A user with the Ops Center Admin role

Identifying a Host System

The host system for the Proxy Controller must be in a location where it can manage your assets and it must meet the Proxy Controller system requirements. If you are adding a new Proxy Controller to manage assets on a new network, the network must be accessible by the new Proxy Controller system.

The new Proxy Controller system must meet these requirements:

- The system's operating system must be supported. See the Oracle Enterprise Manager Ops Center Certified Systems Matrix for a list of supported systems.

- To update operating systems, the Proxy Controller must not be installed on a system which uses a web proxy which requires authentication to reach the Enterprise Controller system.

- To provision Oracle Solaris 11 using the Proxy Controller, it must be installed on an Oracle Solaris 11 system.

- To provision an Oracle VM Server for SPARC using the Proxy Controller, it must be installed on an Oracle Solaris system.

- To provision operating systems using the Proxy Controller, it must be in the same subnet as the OS provisioning targets.

- No errors are reported by the OCDoctor utility when it is run using the procedure below.

To Check the Proxy Controller System

1. Download the OCDoctor's compressed file, OCDoctor-LATEST.zip, from http://java.net/projects/oc-doctor/downloads.

2. Create the /var/tmp/OC directory on the host system if it does not already exist, then transfer the zip file to this directory.

3. Extract the OC Doctor utility.

4. Run the OC Doctor utility with the --proxy-prereq option.
For example:

# ./OCDoctor.sh --proxy-prereq
Ops Center Doctor 4.29  [OC 12.2.0.2663-2663,Linux]
========== Checking 12c Proxy Controller Requirements ... ====================
OK: 7929 MB of memory
OK: 10111 MB of swap
OK: Found enough disk space on /var/opt/sun/xvm (110G)
OK: Oracle/RedHat Linux 6.2
OK: XEN kernel is not loaded
OK: xinetd is installed.
OK: tftp-server is installed.

The OC Doctor displays a warning and a suggested solution for each issue.

5. Correct any issues discovered by the OC Doctor utility and re-run the utility until it completes without discovering any issues.

Installing and Configuring a Proxy Controller

Use the Deploy Proxy Wizard to install and configure the new Proxy Controller on the host system through the user interface.

This installation installs, or upgrades to, Java Runtime Environment (JRE) 7 Update 71. Later versions of JRE are not affected.

To install a Proxy Controller through the UI, the Enterprise Controller must be able to reach the Proxy Controller system with an SSH connection using port 22. If your site does not allow this type of connection, install the Proxy Controller from the command line using the procedures in the Installation Guide for Oracle Solaris Operating System or the Installation Guide for Linux Operating Systems.

To Deploy a Proxy Controller

You can use the Deploy Proxy Wizard to deploy and configure one or more Proxy Controllers.

1. Click the Enterprise Controller in the Administration section of the Navigation Pane.

2. Click Deploy Proxy in the Actions pane.
The Proxy Controller Deployment page is displayed.

3. Choose the Remote Proxies deployment option, then click Next.
The Remote Proxy Controllers page is displayed.

4. Enter the credentials for the host system. The Proxy Controller software is installed and configured on this system.

- Hostname or IP address: The host name or IP address of the host system.

- SSH User name: If root SSH access is allowed on the host system, enter the root user name and password in the SSH User and SSH Password fields.

- SSH Password: The password associated with the SSH user name.

- (Optional) Privileged Role: If root SSH access is not allowed on the host system, enter the login user name and password in the SSH User and SSH Password fields, then enter the root user name and password in the Privileged Role and Role Password fields.

- (Optional) Role Password: If you entered the root user name in the Privileged Role field, enter the root password.

- Create Tunnel: Check this box to create a tunnel to the Proxy Controller.

- Port: If you want the Proxy Controller to use a port other than the default, enter that port number.

- Maintenance Mode: Check this box to start the Proxy Controller in maintenance mode.

Click Next.

The Proxy Controller Status page is displayed.

5. View the status of the configured Proxy Controllers.
The new Proxy Controller should be online.

Click Next.

The Summary page is displayed.

6. Click Finish.

Configuring DHCP

DHCP configuration configures and enables basic DHCP services on the Proxy Controller to support OS provisioning operations for Linux and Oracle Solaris 8-10. This action is only necessary if you plan to provision these operating systems using the Proxy Controller.

The DHCP Config action configures and enables either an Oracle Solaris DHCP server, or an Internet Standards Consortium (ISC) DHCP server, on the Proxy Controller.

Use the DHCP Config action to specify the Ethernet interfaces that the Proxy Controller uses to provide DHCP services. You can establish DHCP services on all the Ethernet interfaces in the Proxy Controller. The Proxy Controller's Ethernet interface that you specify must be connected to the network where the target systems for OS provisioning are connected.

You can configure DHCP server on the Proxy Controller to listen to multiple Ethernet interfaces. For example, consider the following network configuration for the Proxy Controller:

e1000g0  203.0.113.2
e1000g1  192.0.2.2
e1000g2  198.51.100.2

If you configure the DHCP server to listen to e1000g1 and e1000g2, then the target system must have the IP address in the range of 192.0.2.0/24 or 198.51.100.0/24.

The Provision OS Wizard supplies the specific identity information that the target system requests, using the basic DHCP services that you establish on the Proxy Controller.

To Configure DHCP Services

1. In the Administration pane, select the Proxy Controller.

2. Click DHCP Config in the Actions pane.
The DHCP Configuration window is displayed.

3. In the DHCP Server menu, select either ISC or Oracle Solaris to implement either the Internet Standards Consortium (ISC) reference DHCP server, or the Oracle Solaris native DHCP server.

4. In the interfaces list, use the arrow buttons to add the correct Proxy Controller interface or interfaces to the list of selected interfaces. DHCP services are provided on the selected interface or interfaces. DHCP configuration is possible for multiple Ethernet interfaces in the Proxy Controller.

5. Click Configure DHCP to save the DHCP configuration that you specified.

6. A warning indicates that the procedure removes existing subnets in the DHCP configuration. Because this is a new DHCP configuration, there are no existing subnets. Click Yes to accept that action and submit the DHCP configuration job.
When the job completes successfully, DHCP services become available.

Associating Networks

To manage assets, the Proxy Controller must have access to the networks that support the assets. This procedure associates the Proxy Controller with one or more management networks. The list of networks includes only the management networks that are reachable by the system running the Proxy Controller.

Note:
If a Proxy Controller is connected to an asset using multiple networks, but management traffic between the Proxy Controller and agent must use a specific network, the Proxy Controller must have a NIC whitelisting file to identify the usable NICs.

To Associate Networks

1. In the Administration pane, select the Proxy Controller.

2. Click Associate Networks in the Actions pane.
The Network/Proxy Controller Associations page is displayed.

The Networks list shows all of the networks that are available but not bound to the Proxy Controller's operating system or already associated with the Proxy Controller.

3. Use the arrow buttons to add networks to the Associate with Proxy Controller list.

4. Click Finish to associate the selected networks with the Proxy Controller.
When the job is completed, the Proxy Controller can manage and provision the assets that use these networks.

Related Articles and Resources

See the Oracle Enterprise Manager Ops Center Installation Guide for Oracle Solaris Operating System or the Oracle Enterprise Manager Ops Center Installation Guide for Linux Operating Systems for more information about installation.

See the Oracle Enterprise Manager Ops Center Administration Guide and Oracle Enterprise Manager Ops Center Feature Reference Guide for more information about DHCP and networks.

These documents are available in the Oracle Enterprise Manager Ops Center Documentation Library at http://docs.oracle.com/cd/E40871_01/index.htm.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Oracle Enterprise Manager Ops Center Adding a Proxy Controller, 12c Release 2 (12.2.2.0.0)

E52883-03

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

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2015, Oracle and/or its affiliates. All rights reserved.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.