Ops Center Security Overview 12c Release 3
Ops Center Security Overview 12c Release 3
Security
12c Release 3 ([Link].0)
E59968-03
June 2016
Oracle Enterprise Manager Ops Center Security, 12c Release 3 ([Link].0)
E59968-03
Copyright © 2007, 2016, 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.
Contents
Preface ................................................................................................................................................................. v
Audience ........................................................................................................................................................ v
Related Documents....................................................................................................................................... v
Conventions................................................................................................................................................... v
1 Overview
Overview of the Architecture ................................................................................................................. 1-1
About the Knowledge Base (KB) and Package Repository ........................................................ 1-1
About the Enterprise Controller..................................................................................................... 1-2
About the Proxy Controller ............................................................................................................ 1-2
About the Agent Controllers .......................................................................................................... 1-2
About the Database .......................................................................................................................... 1-2
Security of the Architecture ............................................................................................................ 1-3
About Authentication Between the Proxy Controller and Agents ........................................... 1-3
General Principles of Security................................................................................................................. 1-5
About Keeping Software Up To Date............................................................................................ 1-5
About Restricting Network Access................................................................................................ 1-5
About the Principle of Least Privilege........................................................................................... 1-6
About Monitoring System Activity ............................................................................................. 1-23
iii
Viewing the Enterprise Controller's Truststore and Keystore................................................... 2-7
About CA Certificate Expiration.................................................................................................... 2-8
Verify a Certificate's Expiration Date ............................................................................................ 2-8
Replace the Certificate for the Enterprise Controller .................................................................. 2-8
Replace the Certificate for the Proxy Controller........................................................................ 2-12
Substituting Certificates for the Glassfish Web Container....................................................... 2-16
Replace the Certificate for the Apache UCE Container ............................................................ 2-18
About Installing a Remote Proxy Controller Securely.............................................................. 2-20
Configuring Oracle Enterprise Manager Ops Center........................................................................ 2-20
About the Connection Mode ........................................................................................................ 2-21
Disable Multiple Logins ................................................................................................................ 2-22
About Securing the Log Files........................................................................................................ 2-23
About Database Credentials ......................................................................................................... 2-24
Disable the Domain Model Navigator ........................................................................................ 2-28
Enable the Domain Model Navigator on the Enterprise Controller....................................... 2-29
Using the Domain Model Navigator ........................................................................................... 2-29
Secure the Agents ........................................................................................................................... 2-30
About Securing the Browsers ....................................................................................................... 2-31
About Strong Cipher Encryption ................................................................................................. 2-31
Transport Layer Security (TLS) .................................................................................................... 2-32
Viewing the Enterprise Controller's Configuration........................................................................... 2-34
About Editing the Configuration ......................................................................................................... 2-34
Access to Database Data ........................................................................................................................ 2-35
Viewing Core Product Data Using Oracle SQL Developer...................................................... 2-35
Viewing Core Product Data Using SQL*Plus ............................................................................ 2-39
3 Security Features
Configuring and Using Authentication................................................................................................. 3-1
About Identity Management for Users ......................................................................................... 3-1
Credentials for My Oracle Support ............................................................................................... 3-5
Credentials for IAAS and Cloud Deployments ........................................................................... 3-5
About Authorization ................................................................................................................................ 3-5
About Credentials for Assets.......................................................................................................... 3-6
About Certificates........................................................................................................................... 3-25
Configuring and Using Access Control .............................................................................................. 3-25
Verifying Security of Session Cookies......................................................................................... 3-25
Setting the Expiration Time for Sessions .................................................................................... 3-26
Removing Code Examples ............................................................................................................ 3-26
Configuring and Using Data Protection.............................................................................................. 3-26
Using an NFS Server ...................................................................................................................... 3-26
About Backing Up and Restoring the Enterprise Controller ................................................... 3-27
Index
iv
Preface
The Oracle Enterprise Manager Ops Center Security Guide describes good practices for
managing security of Oracle Enterprise Manager Ops Center deployments.
Audience
This document is intended for system administrators who are responsible for planning
the configuration of the software or deploying the software.
Related Documents
For more information, see the Oracle Enterprise Manager Ops Center documentation
library at [Link]
Oracle Enterprise Manager Ops Center provides online Help. Click Help at the top-
right corner of any page in the user interface to display the online help window.
Conventions
The following text conventions are used in this document:
Convention Meaning
italic Italic type indicates book titles, emphasis, or placeholder variables for
which you supply particular values.
v
1
Overview
Overview 1-1
Overview of the Architecture
1-2 Security
Overview of the Architecture
Between Enterprise Controller and the Verify that a firewall does not separate the
NFS server Enterprise Controller and the NFS server.
Verify that the NFS server uses the NFSv4 protocol.
Between Enterprise Controller and Configure a reverse SSH tunnel when you install
remote Proxy Controllers the product software. This option is described in
the Oracle Enterprise Manager Ops Center Installation
for Oracle Solaris Operating System and the Oracle
Enterprise Manager Ops Center Installation for Linux
Operating Systems
Between Proxy Controller and assets Authentication is configured when the asset is
discovered and managed as described in About
Authentication Between the Proxy Controller and
Agents
Overview 1-3
Overview of the Architecture
3. Agent sends the public key to the Enterprise Controller (through its Proxy
Controller)
5. Enterprise Controller saves the public key and the client registration ID together
in the database
1. Proxy Controller's server-side certificate was prompted to the agent as part of the
handshake.
1. Agent creates a string from the client reg ID and the private key. The string is its
signature
1-4 Security
General Principles of Security
2. Agent sends an HTTPS POST of the signature and the requested data to the Proxy
Controller.
3. Proxy Controller retrieves the public key for the agent's client reg ID from the
database.
4. Proxy Controller verifies that the message's signature was created from the
private key that matches the public key.
If the Proxy Controller detects that the message's private key does not match the
public key, the Proxy Controller does not allow the connection. This protects against
an entity misrepresenting itself as the agent.
Topics
Overview 1-5
General Principles of Security
If your data center includes remote Proxy Controllers, use firewalls between the
Enterprise Controller's system and the Proxy Controllers' systems.
To use Oracle Enterprise Manager Ops Center in Connected mode, use a firewall
between the Enterprise Controller and the Internet.
To configure the firewalls, see Oracle Enterprise Manager Ops Center Ports and Protocols
for information about required URLs, ports, and protocol information.
Tasks Permission
Read Access Read Access
1-6 Security
General Principles of Security
Tasks Permission
Add Assets Discover Assets
Find Assets
Overview 1-7
General Principles of Security
Tasks Permission
Import ISO Storage Management
Upload image
Edit Attributes
1-8 Security
General Principles of Security
Tasks Permission
Open Service Request Service Request
Overview 1-9
General Principles of Security
Tasks Permission
Edit Energy Cost EC Energy Cost Management
1-10 Security
General Principles of Security
Tasks Permission
Start Guest Virtualization Guest Usage
Shutdown Guest
Migrate Guest
Clone Guest
Overview 1-11
General Principles of Security
Tasks Permission
OVM Manager Usage OVM Manager Usage
1-12 Security
General Principles of Security
Role Permissions
Asset Admin Asset Group Management
Asset Management
Asset Network Management
Boot Environment Management
Chassis Management
Chassis Usage
Cluster Management
Discover Assets
IPMP Groups
Link Aggregation
Manage Assets
Network Management
Operating System Management
Operating System Usage
Power Distribution Unit Management
Power Distribution Unit Usage
Power Management
Rack Creation
Rack Deletion
Rack Management
Rack Usage
Read Access
Server Management
Server Usage
Service Request
Storage Server Management
Storage Server Usage
Switch Management
Switch Usage
Write Access
Overview 1-13
General Principles of Security
Role Permissions
Cloud Admin Asset Management
Asset Network Management
Cloud Management
Cloud Usage
Fabric Creation
Fabric Deletion
Fabric Management
Fabric Usage
IPMP Groups
Link Aggregation
Manage Assets
Network Creation
Network Deletion
Network Domain Creation
Network Domain Deletion
Network Domain Management
Network Domain Usage
Network Management
Network Usage
Operating System Management
Operating System Usage
OVM Manager Management
OVM Manager Usage
Profile Plan Management
Read Access
Role Management
Server Management
Server Pool Management
Server Pool Usage
Server Usage
Storage Management
Storage Server Management
Storage Server Usage
Storage Usage
Switch Management
Switch Usage
Virtualization Guest Creation
Virtualization Guest Deletion
Virtualization Guest Management
Virtualization Guest Usage
Virtualization Host Management
Virtualization Host Usage
Write Access
1-14 Security
General Principles of Security
Role Permissions
Cloud User Asset Management
Asset Network Management
Cloud Usage
Fabric Creation
Fabric Deletion
Fabric Usage
Manage Assets
Network Creation
Network Deletion
Network Domain Management
Network Domain Usage
Network Management
Network Usage
Operating System Management
Operating System Usage
OVM Manager Usage
Read Access
Server Pool Usage
Server Usage
Storage Management
Storage Server Usage
Storage Usage
Switch Usage
Virtualization Guest Creation
Virtualization Guest Deletion
Virtualization Guest Management
Virtualization Guest Usage
Virtualization Host Management
Virtualization Host Usage
Write Access
Overview 1-15
General Principles of Security
Role Permissions
Exalogic Systems Admin Asset Management
Credential Management
Directory Server Management
EC Energy Cost Management
EC HTTP Proxy Management
EC Registration
Fabric Creation
Fabric Deletion
Fabric Management
Fabric Usage
Job Management
Link Aggregation
Network Creation
Network Deletion
Network Domain Creation
Network Domain Deletion
Network Domain Management
Network Domain Usage
Network Management
Network Usage
Operating System Management
Operating System Usage
Operation Execution
OVM Manager Management
OVM Manager Usage
Power Distribution Unit Management
Power Distribution Unit Usage
Profile Plan Management
Proxy Controller Management
Read Access
Report Management
Role Management
Server Deployment
Server Management
Server Usage
Service Request
Storage Creation
Storage Deletion
Storage Management
Storage Server Management
Storage Server Usage
Storage Usage
Switch Usage
Update Firmware
User Management
Write Access
1-16 Security
General Principles of Security
Role Permissions
Fault Admin Fault Management
Read Access
Write Access
Overview 1-17
General Principles of Security
Role Permissions
Ops Center Admin Add Product Alias
Discover Assets
EC Connection Mode Management
EC Energy Cost Management
EC HTTP Proxy Management
EC Local Agent Management
EC Proxy Management
EC Registration
EC Storage Library Management
EC Upgrade
Enterprise Controller Management
Cloud Control Management
Job Management
Manage Assets
Ops Center Downloads
OVM Manager Management
OVM Manager Usage
Proxy Controller Management
Proxy Controller Upgrade
Read Access
Unconfigure EC
Windows Update Management
Write Access
1-18 Security
General Principles of Security
Role Permissions
Apply Deployment Plans Operation Execution
Read Access
Server Deployment
Update Firmware
Write Access
Overview 1-19
General Principles of Security
Role Permissions
SuperCluster Systems Asset Management
Admin Cluster Management
Credential Management
Directory Server Management
EC Energy Cost Management
EC HTTP Proxy Management
EC Registration
Fabric Creation
Fabric Deletion
Fabric Management
Fabric Usage
Job Management
Link Aggregation
Network Creation
Network Deletion
Network Domain Creation
Network Domain Deletion
Network Domain Management
Network Domain Usage
Network Management
Network Usage
Operating System Management
Operating System Usage
Operation Execution
Power Distribution Unit Management
Power Distribution Unit Usage
Profile Plan Management
Proxy Controller Management
Read Access
Report Management
Role Management
Server Deployment
Server Management
Server Usage
Service Request
Storage Creation
Storage Deletion
Storage Management
Storage Server Management
Storage Server Usage
Storage Usage
Switch Usage
Update Firmware
User Management
Write Access
1-20 Security
General Principles of Security
Role Permissions
Update Admin Boot Environment Management
Read Access
Update
Update Simulation
Windows Update Management
Write Access
Overview 1-21
General Principles of Security
Role Permissions
Virtualization Admin Asset Management
Asset Network Management
Fabric Creation
Fabric Deletion
Fabric Management
Fabric Usage
IPMP Groups
Link Aggregation
Manage Assets
Network Creation
Network Deletion
Network Domain Creation
Network Domain Deletion
Network Domain Management
Network Domain Usage
Network Management
Network Usage
Operating System Management
OVM Manager Management
OVM Manager Usage
Read Access
Server Deployment
Server Management
Server Pool Creation
Server Pool Deletion
Server Pool Management
Server Pool Usage
Storage Creation
Storage Deletion
Storage Management
Storage Server Management
Storage Server Usage
Storage Usage
Virtualization Guest Creation
Virtualization Guest Deletion
Virtualization Guest Management
Virtualization Guest Usage
Virtualization Host Creation
Virtualization Host Deletion
Virtualization Host Management
Virtualization Host Usage
Write Access
1-22 Security
General Principles of Security
5. Add or remove one or more roles from the roles list. By default, a user has all the
permissions of the assigned role. To control the scope of a user's role, remove a
specific permission:
a. Deselect the Use the default Role associations box. Click Next.
b. The privileges for each type of target are displayed on separate pages. Select
the roles to apply to each target, then click Next.
6. The Summary page is displayed. Review the roles and privileges assigned to the
user, then click Finish.
Overview 1-23
General Principles of Security
• On Linux: /var/opt/sun/cacao2/instances/oem-ec/logs/audit-
logs.*
Each audit log file has a maximum size of 10 Mb. When this limit is reached, the file is
closed and a new file is created with an incremented file extension. The maximum
number of audit log files is 15, accumulating 150 Mb of logged activity. When audit-
logs.14 is closed, the next audit file is audit-log.0, overwriting the original
audit-log.0 file.
Figure 1-3 shows the series of log files.
• Job is completed.
1-24 Security
General Principles of Security
action
LOGIN
DISCONNECT If a connection expires, the disconnection is not logged.
JOB_START
JOB_END
USER_ADD
USER_DELETE
ROLES_ASSIGN
SCHEDULED_JOB_STARTED
REMOTE_INFO Indicates a connection through the browser interface and includes
the IP address and port of the http client making the connection, as in the
following example:
REMOTE_INFO rmi://[Link] yogi 52, Remote Info: User yogi Session
ID:c2870004d5308069ffbf367fde6b connected from [Link]:57391 / JMX Session:
[Link]://[Link]:9 [Link]
connect_info
Unique identifier for the connection, depending on the type of connection:
additional_info
• For job actions, the additional information is the job ID, which consists of the
Enterprise Controller's name and the job number as listed in the Job pane.
5. Edit the value field to specify the format of the date and time. Use a specification
that is supported by Java’s SimpleDateFormat class.
7. Wait at least 10 minutes for the change to take effect and view the current audit log
to confirm.
Overview 1-25
General Principles of Security
Example 1-1 shows the contents of an audit log for the following operations:
Example 1-1 Example of an Audit Log
5/23/14 3:06 PM LOGIN rmi://[Link] root 13
5/23/14 3:06 PM REMOTE_INFO rmi://[Link] root 13, Remote Info: User root Session
ID:c2870004d5308069ffbf367fde6b connected from [Link]:45338 / JMX Session:
[Link]^Armi://[Link]:2 [Link]^Aroot
5/23/14 3:12 PM USER_ADD rmi://[Link] root 13, Remote Info: User root connected
from Session ID:c2870004d5308069ffbf367fde6b [Link]:45338 / JMX Session:
[Link]^Armi://[Link]:2 [Link]^Aroot Add user
stanfield: SUCCESS
5/23/14 3:12 PM ROLES ASSIGN rmi://[Link] root 13 Roles [OPS_CENTER_ADMIN]
granted to user stanfield
5/23/14 3:12 PM DISCONNECT rmi://[Link] root 13
5/23/14 3:12 PM LOGIN rmi://[Link] stanfield 18
5/23/14 3:12 PM REMOTE_INFO rmi://[Link] stanfield 18, Remote Info: User
stanfield Session ID:c2870004d5308069ffbf367fde6d connected from [Link]:45351 /
JMX Session: [Link]^Armi://[Link]:3 [Link]^Astanfield
5/23/14 3:13 PM JOB_STARTED rmi://[Link] stanfield 18 sm4170m2-11-
[Link] - DHCP Server Configuration on sm4170m2-11-n172
5/23/14 3:13 PM JOB_END Job sm4170m2-11-n172.27 Completed with Status: SUCCESS
5/23/14 3:13 PM DISCONNECT rmi://[Link] stanfield 18
• On Linux: /var/opt/sun/cacao/instances/oem-ec/audits/
The following log files are specialized for specific events:
1-26 Security
General Principles of Security
High Availability
Lists the Clusterware activity log.
In a High Availability configuration, each Enterprise Controller is a Clusterware node.
The Clusterware resource activity is logged each time the active Enterprise
Controller's resource action script's check() function is executed. The default interval
is 60 seconds.
On Oracle Solaris: /var/opt/sun/xvm/ha/[Link]
Software Updates
Lists the events for software updates.
The Software Update component has its own server with its own logs. The following
logs provide information on the activity for this server:
• Audit Log
– On Linux: /usr/local/uce/server/logs/[Link]
• Errors
– On Linux: /usr/local/uce/server/logs/[Link]
• Job Log
– On Linux: /usr/local/uce/server/logs/[Link]
Agents
Lists the type of event and the type of information about the event that is logged
• /var/scn/update-agent/logs directory.
• /var/opt/sun/xvm/logs
Local Database
Lists the log files for database activity.
Overview 1-27
General Principles of Security
/var/tmp/opscenter/[Link]
1-28 Security
2
Secure Installation and Configuration
Topics
Topics
• Typical Deployment
The High Availability configuration uses multiple Enterprise Controllers with Oracle
Clusterware and a remote database. The active Enterprise Controller is used for all
operations. The standby Enterprise Controllers are configured as backups. If the active
Enterprise Controller must be taken offline, make another Enterprise Controller active.
One of the standby Enterprise Controllers is also activated if the active Enterprise
Controller fails.
Each asset is managed by a specific Proxy Controller. If a Proxy Controller fails or is
uninstalled, Oracle Enterprise Manager Ops Center gives you the option to migrate
the failed Proxy Controller's assets to another Proxy Controller. At any time, move an
asset from one functional Proxy Controller to another Proxy Controller. The
destination Proxy Controller must either be connected to the networks of the assets
being moved, or be associated with those networks and have them enabled.
• Use two or more systems of the same model and configured identically:
– Processor class
– Operating system
• Use the Edit Asset action to add an asset tag that identifies the active Enterprise
Controller and distinguishes it from the standby Enterprise Controller.
• Maintain the standby Enterprise Controller's system in the same way as the active
Enterprise Controller. The active and standby Enterprise Controllers must use the
same version of Enterprise Manager Ops Center software.
• User accounts and data that are not associated with Enterprise Manager Ops
Center are not part of the relocate process. Only Enterprise Manager Ops Center
data is moved between the active and standby Enterprise Controllers.
2-2 Security
Planning the Deployment
Network connections are needed for data operations, for management operations, and
for provisioning operations. The minimum configuration, but least secure, is to
combine all operations on one network. Separate networks, as shown in Figure 2-1,
provide the highest security and the lowest number of points of failure. However,
additional network interface cards (NIC) are needed to support this configuration.
Network connection (net0) can be physical NIC, a link aggregate, or an IPMP group.
NFS server. Because the Enterprise Controller does not mount the NFS share, install
the NFS server on a system that is close to the systems that will use the NFS share, that
is, the systems that host global zones and Oracle VM Servers.
Note:
To add this security enhancement, use the following procedure to execute the
update_pub_privs_12.[Link] script:
2-4 Security
Installing Oracle Enterprise Manager Ops Center
Typical Deployment
Illustrates a typical product architecture.
Figure 2-2 shows a deployment running the product software in Connected mode and
with two Proxy Controllers.
Topics
• Starting in Release [Link], use the Command Line Interface’s security mode to
manage certificates. The instructions for invoking and the product’s Command
Line Interface are in the Oracle Enterprise Manager Ops Center Command Line
Interface, but to summarize:
– Linux: /opt/sun/occli/bin
3. The procedures in this section use the security mode and the jobs mode.
When you enter a mode, the system prompt changes to indicate the current
mode. To enter security mode, type security on the command line. You can
view the man pages for any mode from the command line or in the Oracle
Enterprise Manager Ops Center Command Line Interface.
2-6 Security
Installing Oracle Enterprise Manager Ops Center
• For Java certificates, use the keytool utility, included in the Java Development
Kit, to manage the keystore, which stores your server's certificate, and the
truststore, which stores the Certificate Authority's certificates.
• For Apache certificates, use the Oracle Solaris's OpenSSL utilities to create
certificates for mutual authentication between a server and its clients. OpenSSL is a
cryptography toolkit that implements the Transport Layer Security (TLS) network
protocol. Oracle Enterprise Manager Ops Center does not use any version of SSL.
All transactions with the web browser are in TLS.
Use the procedures in this section to substitute private keys with a Certificate
Authority's private keys, signed by the Certificate Authority. By substituting the
certificates and keys, you change the trust relationship between components. To
ensure authentic communication, substitute the keys on the following:
1. Identify the Certificate Authority you want to use and follow their instructions for
the specific steps of this general procedure.
4. Verify the certificates' fingerprints. When you add a certificate to the keystore, any
transactions using that certificate become trusted. You must be certain that the
certificates you received are authentic before you import them. For a Java
certificate, use the following command to see the fingerprints and then
communicate with the Certificate Authority to compare the fingerprints:
At any time, use the following command to display the content of the Enterprise
Controller's keystore:
keytool -list -v -keystore /etc/cacao/instances/oem-ec/security/jsse/keystore -
storepass:file /etc/cacao/instances/oem-ec/security/password
Use the following command to display the content of the Enterprise Controller's
truststore:
keytool -list -v -keystore /etc/cacao/instances/oem-ec/security/jsse/truststore -
storepass trustpass
Use the CLI security mode at any time to display information about the certificates
in any Proxy Controller’s truststore or any asset’s truststore. The following commands
display information for each certificate on each asset or Proxy Controller: the alias, the
owner, the issuer, the serial number, the creation date, and the period during which
the certificate is valid.
localhost/security > list_proxy [-p|--proxy proxyID]
2-8 Security
Installing Oracle Enterprise Manager Ops Center
2. Create a new password by creating and then editing the following file:
/etc/cacao/instances/oem-ec/security/password
3. Create a new private key in the new keystore. You will be prompted to enter
passwords for the key and keystore.
a. Create a new private key. Use the keytool -genkey command, according
to its documentation and your site's security policy. The following is an
example of the command:
keytool -genkey -alias cacao_agent -keyalg RSA -sigalg SHA1withRSA -keysize 2048 -validity
7300 -keystore keystore_new -storepass:file /etc/cacao/instances/oem-ec/security/password -
dname CN=ec-`uname -n`
where
-keyalg specifies the algorithm to be used to generate the key pair.
-sigalg specifies the algorithm used to sign the self-signed certificate. This
algorithm must be compatible with the algorithm specified by the -keyalg
option, as described in the keytool documentation.
-validity specifies the number of days that the certificate remains valid.
-dname specifies the X.500 Distinguished Name to be associated with alias,
and is used as the issuer and subject fields in the self-signed certificate.
b. At the prompt to enter the key password for cacao_agent, do not enter any
characters. Instead, press the Enter key to set the cacao_agent key password
to be the same password as the one used for the keystore. This method is the
only way to ensure that the passwords match.
where:
SHA256withRSA specifies the algorithm used to sign the self-signed certificate.
[Link] is the name of the file containing the signing request.
6. Import the Certificate Authority's root certificate, your_ca, into the new keystore.
The root certificate is in the file [Link].
keytool -importcert -alias your_ca -keystore keystore_new -file [Link] -
storepass:file /etc/cacao/instances/oem-ec/security/password
8. Import the signed certificate into the new keystore. The signed certificate is in the
file [Link].
keytool -importcert -v -alias cacao_agent -file [Link] -keystore
keystore_new -storepass:file /etc/cacao/instances/oem-ec/security/password
9. Remove the Certificate Authority's root certificate, your_ca, from the new
keystore because it is no longer needed:
keytool -delete -alias your_ca -keystore keystore_new -storepass:file /etc/cacao/
instances/oem-ec/security/password
10. If you are using the EC-HA High Availability feature, copy the new keystore and
the updated truststore to the second node system at the same location. If you are
using a new password, copy it to the second node system too.
11. Use the CLI’s security mode to propagate the new certificate to the truststore of
all Proxy Controllers:
The following example shows that two Proxy Controllers have active
certificates.
Proxy Certificates Status:
Proxy | Alias | Serial |Status|Active|
---------------------------------------------------------------
proxy-1 | cacao_ca | 303b0061 | OK |ACTIVE
proxy-2 | cacao_ca | 303b0061 | OK |ACTIVE
proxy-2 | sds | d61bbb3e03e483f9 | OK |
c. Use the jobs mode as a one-line command to follow the progress of the job.
This one-line command lets you run a command in a different mode without
ending the current mode.
localhost/security > [Link] -C1
d. When the job is finished, verify the status of the certificates again. This
example shows that all new certificates have been propagated but original
certificates are still in use. These certificates remain in use until the active
keystore is changed.
2-10 Security
Installing Oracle Enterprise Manager Ops Center
mv keystore keystore_old
mv keystore_new keystore
rm truststore_gf
17. Rename the directories so that password is in effect and then change its
permissions:
mv ../password ../password_old
mv ../password_new ../password
chmod 600 ../password_new
18. Restart the Enterprise Controller. After this start, the new certificates are in use.
Remote users of the Command Line Interface must accept the new certificate the
first time they connect to the CLI.
19. If you are using the EC-HA High Availability feature, repeat the same commands
on the second node system:
mv keystore keystore_old
mv keystore_new keystore
rm truststore_gf
mv ../password ../password_old
mv ../password_new ../password
chmod 600 ../password_new
20. Use the security mode to remove the original certificates from the Proxy
Controllers’ truststores.
a. Verify that all new certificates are now in use and the original certificates are
not used.
localhost/security > check_proxy
The following example shows that the new certificates, starting with
cacao_agent, are now the active certificates.
b. To remove the old certificates from its truststore, you must remove each one
individually. Each operation creates a job with an ID that includes the
Enterprise Controller’s name.
localhost/security > remove_proxy -s 303b0061
Job ID is ec_name.YY
Because you import the certificates for the new keys into the Proxy Controller
truststore before you switch keys, an SSL error occurs in the Proxy Controller. For a
Proxy Controller running version [Link].0 version or later, the Proxy Controller
recovers automatically in a few minutes. The Proxy Controller reads the truststore,
detects the new certificates, and restores communication with the Enterprise
Controller.
If the Proxy Controller is running a previous version or you experience a delay or
other problem, stop and restart the Proxy Controller to force it to re-read its truststore.
2-12 Security
Installing Oracle Enterprise Manager Ops Center
a. Create a new private key. Use the keytool -genkey command, according
to its documentation and your site's security policy. Do not include the -
keypass option so that a prompt for the password will be displayed. The
following is an example of the command:
keytool -genkey -alias cacao_agent -keyalg RSA -sigalg SHA1withRSA -keysize 2048 -validity
7300 -keystore keystore_new -storepass:file /etc/cacao/instances/scn-proxy/security/password -
dname CN=ec-`uname -n`
where
-keyalg specifies the algorithm to be used to generate the key pair.
-sigalg specifies the algorithm used to sign the self-signed certificate. This
algorithm must be compatible with the algorithm specified by the -keyalg
option, as described in the keytool documentation.
-validity specifies the number of days that the certificate remains valid.
-dname specifies the X.500 Distinguished Name to be associated with alias,
and is used as the issuer and subject fields in the self-signed certificate. If you
do not include the distinguished name in the command, the user is prompted
for one.
b. At the prompt to enter the key password for cacao_agent, do not enter any
characters. Instead, press the Enter key to set the cacao_agent key password
to be the same password as the one used for the keystore. This method is the
only way to ensure that the passwords match.
where:
SHA256withRSA specifies the algorithm used to sign the self-signed certificate.
[Link] is the name of the file containing the signing request.
5. Obtain a new certificate from a Certificate Authority for each Proxy Controller,
according to the procedure in Obtaining a Certificate Authority's Certificate.
6. Import the Certificate Authority's root certificate, your_ca, into the new keystore.
The root certificate is in the file [Link].
keytool -importcert -alias your_ca -keystore keystore_new -file [Link] -
storepass:file /etc/cacao/instances/scn-proxy/security/password
8. Import the signed certificate into the new keystore. The signed certificate is in the
file [Link].
keytool -importcert -v -alias cacao_agent -file [Link] -keystore
keystore_new -storepass:file /etc/cacao/instances/scn-proxy/security/password
9. Remove the Certificate Authority's root certificate, your_ca, from the new
keystore because it is no longer needed:
keytool -delete -alias your_ca -keystore keystore_new -storepass:file /etc/cacao/
instances/scn-proxy/security/password
10. Use the CLI’s security mode to propagate the new certificate to the truststore of
all the assets managed by the specified Proxy Controller:
The following example shows that the two assets managed by this Proxy
Controller have active certificates.
Asset Certificates Status:
Proxy | Asset | Alias | Serial |Status|Active|
----------------------------------------------------------------------------
---
proxy-1 | asset-1 | cacao_ca | 70451d3b | OK |ACTIVE
proxy-1 | asset-2 | cacao_ca | 70451d3b | OK |ACTIVE
c. Use the jobs mode as a one-line command to follow the progress of the job.
This one-line command lets you run a command in a different mode without
ending the current mode.
localhost/security > [Link] -C1
d. When the job is finished, verify the status of the certificates again. This
example shows that all new certificates have been propagated but original
certificates are still in use. These certificates remain in use until the active
keystore is changed.
localhost/security > check_asset -p proxy-1
2-14 Security
Installing Oracle Enterprise Manager Ops Center
11. Place the Proxy Controller in maintenance mode to prevent auto-recovery during
the remaining steps of this procedure.
12. Stop the Proxy Controller's internal communication using the following
command:
mv keystore keystore_old
mv keystore_new keystore
ls -l /var/opt/sun/xvm/bui/conf/password
rm truststore_gf
18. Use the security mode to remove the original certificates from the assets’
truststores.
a. Verify that all new certificates are now in use and the original certificates are
not used.
localhost/security > check_asset -p proxy-1
b. To remove the old certificates from its truststore, you must remove each one
individually. Each operation creates a job with an ID that includes the
Enterprise Controller’s name.
localhost/security > remove_asset -p proxy-1 -s 70451d3b
Job ID is ec_name.tt
Because you import the certificates for the new keys into the agent truststore before
you switch keystores, an SSL error occurs in the agent. Starting with version [Link].0
version, the agent recovers automatically in a few minutes. The agent reads the
truststore, detects the new certificates, and restores communication with the Proxy
Controller.
If the agent is deployed from a previous version or you experience a delay or other
problem, stop and restart the agent to force it to re-read its truststore.
2-16 Security
Installing Oracle Enterprise Manager Ops Center
cd /var/opt/sun/xvm/bui/conf
3. Delete the keystore. The keystore is re-created automatically when you create a
new private key later in this procedure.
rm keystore
4. Delete the Oracle Glassfish Server truststore used by the product's web server. The
truststore is re-created automatically when the Enterprise Controller is restarted.
rm keystore_truststore_gf
5. Create a new private key, according to your site's security policy. Use the keytool
-genkey command, according to its documentation and your site's security policy.
Do not include the -keypass option so that a prompt for the password will be
displayed. The following is an example of the command for creating the private
key:
keytool -genkey -alias `uname -n` -keyalg RSA -sigalg SHA1withRSA -keysize 2048 -validity 7300 -
keystore keystore -storepass password -dname CN=bui-`uname -n`
where
-keyalg specifies the algorithm to be used to generate the key pair.
-sigalg specifies the algorithm used to sign the self-signed certificate. This
algorithm must be compatible with the algorithm specified by the -keyalg option,
as described in the keytool documentation.
-dname specifies the X.500 Distinguished Name to be associated with alias, and is
used as the issuer and subject fields in the self-signed certificate. If you do not
include the distinguished name in the command, the user is prompted for one.
-validity specifies the number of days that the certificate remains valid.
-password specifies either the clear text password or the local file named
password that contains an arbitrary string used as the keystore password. If you
are using a local file named password, then use the -storepass:file
<filename> format.
Note:
If you are installing Oracle Enterprise Manager Ops Center version 12.3.2, use
the -storepass:file <filename> for the keystore password.
6. At the prompt for the key password, press the Enter key to set the key password to
match the keystore password.
keytool -certreq -keyalg RSA -sigalg SHA256withRSA -alias `uname -n` -file
[Link] -keystore keystore -storepass password
8. If you have verified the certificate you received from the Certificate Authority, as
described in Step 4 of the procedure in Obtaining a Certificate Authority's
Certificate, you are ready to import it.
9. Import the certificate that the CA sent to you into the keystore. The certificate is in
the file [Link].
keytool -importcert -alias your_ca -keystore keystore -file [Link] -storepass password
11. Import the signed certificate into the keystore. The certificate is in the file
[Link].
keytool -importcert -v -alias `uname -n` -file [Link] -keystore keystore -storepass password
12. Remove the Certificate Authority's root certificate, your_ca, from the keystore
because it is no longer needed:
• Create and propagate the new certificates to the clients of the Apache service.
• Stop the Apache service, replace the certificates, and then restart the Apache
service.
1. Copy your local Certificate Authority key and certificate files to a secure location
on your server. This is a temporary location.
4. To add the new certificate to the truststore of the client of the Apache Service,
define the following variables
SMSF_STORE=/var/opt/sun/xvm/security/jsse/smsfacade/jssecacerts
SMSF_PASS=`awk -F= '/^[Link]/{print $2}' /var/opt/sun/xvm/persistence/scn-
satellite/[Link]`
NEW_SERVER_SSL_CRT=<your secure temporary location>/[Link]
2-18 Security
Installing Oracle Enterprise Manager Ops Center
TRUST_STORE=/etc/cacao/instances/oem-ec/security/jsse/truststore
TRUST_PASS=`awk -F= '/^[Link]/{print $2}' /etc/cacao/instances/oem-
ec/private/[Link]`
5. Add the new certificate to the truststore. This example uses sds-2 and
[Link]-2 to show that the aliases must be different from the original aliases.
Specify alias names for your convenience or according to your site policy.
– /opt/SUNWxvmoc/bin/ecadm stop -w
– /opt/SUNWxvmoc/bin/proxyadm stop -w
• Linux OS:
– /opt/sun/xvmoc/bin/ecadm stop -w
– /opt/sun/xvmoc/bin/proxyadm stop -w
7. Navigate to the location of the certificate and key files for the Apache web
container:
8. Move the current [Link] file and [Link] file from the [Link]
directory to an alternate, secure location.
9. Copy your local Certificate Authority files from the secure temporary location to
the [Link] directory.
10. Verify the permissions for the [Link] file are set to allow only the service
user to read the file:
11. If the [Link] file is encrypted and requires a password, edit the following file to
echo the password:
– /opt/SUNWxvmoc/bin/ecadm start -w
– /opt/SUNWxvmoc/bin/proxyadm start -w
• Linux OS:
– /opt/sun/xvmoc/bin/ecadm start -w
– /opt/sun/xvmoc/bin/proxyadm start -w
13. Use the CLI’s security mode to propagate the new UCE certificate to each Agent
Controller that needs it.
2-20 Security
Configuring Oracle Enterprise Manager Ops Center
Upgrade the product software Use the Upgrade Enterprise For the Enterprise Controller and
Controller action. For each Proxy each Proxy Controller:
Controller, use the Update to Latest
Available Version action. 1. Log in to each system as root
and create a temporary
directory.
Provision firmware and update Download firmware from http:// Use a CD or DVD to load the
existing firmware, using the latest [Link] or vendor software.
image. sites. Then use the Upload ISO Images
action, the Upload Firmware action,
and the Import Images actions to
update the contents of the
Enterprise Controller's software
library.
Use Automatic Service Requests After you register the assets in the Contact My Oracle Support to
(ASR) My Oracle Support database and request service.
register a user account as the My
Oracle Support user, you have the
option to create a service request
whenever an incident is reported.
In an Automated Service Request,
the following information is sent
from the Enterprise Controller to
My Oracle Support:
serial number
FRU data
site location
hardware SNMP trap
Create a Services Request After you register the assets in the Contact My Oracle Support to
My Oracle Support database and request service. The Open Service
register a user account as the My Request action is disabled.
Oracle Support user, select the
Open Service Request action.
Verify warranties After you register the assets in the Contact My Oracle Support to
My Oracle Support database and coordinate warranty records with
register a user account as the My your own records.
Oracle Support user, view the
warranty of a specific asset or all
assets.
2-22 Security
Configuring Oracle Enterprise Manager Ops Center
The default behavior is to allow a user to log in multiple times. This convenience can
be a security risk. You can disable simultaneous sessions for an individual user
account or for a role, to affect all user accounts that have the role.
4. In the Display Preferences section, select the Disable Multiple Sessions checkbox.
5. Log out and log in again to make the change take effect.
• You must protect the properties file for the database, /var/opt/sun/xvm/
[Link], because it contains schema names and passwords. Use the most
restrictive permission: read-only by file owner.
• You must protect the compressed file created when you use the ecadm backup
command, as described in About Backing Up and Restoring the Enterprise
Controller. This tar file contains the dump of the local database. You must also
ensure that the backup file is moved to an alternate location.
• You must remove the [Link] file after installation. The file contains
unencrypted credentials for the schema on the customer-managed database, used
to configure the connection between the Enterprise Controller and the remote
database. The file is located on the system that hosts the Enterprise Controller in a
directory chosen by the administrator who installed the software.
• If you are upgrading from product version 12c Release 1 ([Link].0) to a later
version and use a remote database, you must also execute the
refactorOCPrivs_12.[Link] script as described in the following section
to further tighten security for the schema owner on the remote database.
• You must protect the properties file for the database, var/opt/sun/xvm/
[Link], because it contains schema names and passwords. Use the most
restrictive permission: read-only by file owner.
• You must ensure that a remote database is included in your site's routine backup
plan so that the Oracle Enterprise Manager Ops Center data can always be
recovered.
2-24 Security
Configuring Oracle Enterprise Manager Ops Center
2. Log in as the database administrator and execute the SQL script, using the
following command:
3. At the prompts for Ops Center database login and Read-Only Ops Center database
login, enter the schema names created when the remote database was created.
4. Verify the new roles and privileges by running the following SQL statement in a
privileged database administrator account:
set pages 0
Select
lpad(' ', 2*level) ||
Granted_Role "User, his roles and privileges"
From
(
-- THE USERS
Select
null Grantee,
UserName Granted_Role
From
Dba_Users
Where
UserName Like Upper('&_OC_SYSTEM_SCHEMA%')
-- ROLES TO ROLES RELATIONS
Union
Select
Grantee,
Granted_Role
From
Dba_Role_Privs
-- THE ROLES TO PRIVILEGE RELATIONS
Union
Select
Grantee,
Privilege
From
Dba_Sys_Privs
)
Start With
Grantee is null
Connect By
Grantee = Prior Granted_Role
/
Enter the value for the OC System Database Login (i.e the value for
[Link]) at the prompt:
Enter value for _oc_system_schema: OC <cr>
The following are the new roles and privileges, in addition to those granted when the
original schema was created such as CREATE DATABASE LINK.
CREATE TABLE
CREATE VIEW
OC_SYSTEM_ROLE
CREATE CLUSTER
CREATE INDEXTYPE
CREATE OPERATOR
CREATE PROCEDURE
CREATE SEQUENCE
CREATE SESSION
CREATE TRIGGER
CREATE TYPE
1. Create a temporary file containing the new password and secure it with 600
permissions.
For example:
# touch /tmp/password
# chmod 600 /tmp/password
# vi /tmp/password
newpassword
2. Use the ecadm command with the change-db-password subcommand and the -
p <password file> option to change the database password. When prompted,
confirm the Enterprise Controller restart.
For example:
# ./ecadm change-db-password -p /tmp/password
The Enterprise Controller will be restarted after the database password is
changed. Continue? (y/n)
y
ecadm: --- Changed database password, restarting.
ecadm: shutting down Enterprise Controller using SMF...
ecadm: Enterprise Controller services have stopped
ecadm: Starting Enterprise Controller with SMF...
ecadm: Enterprise Controller services have started
#
3. If you have a high availability configuration, the ecadm command copies the new
database properties to each remote cluster node. Enter the root password for each
remote cluster node.
For example:
2-26 Security
Configuring Oracle Enterprise Manager Ops Center
For example:
# rm /tmp/password
For example:
# vi /tmp/password
newpassword
2. Use the ecadm command with the change-db-password subcommand and the -
p <password file> and -r options to change the database password. When
prompted, confirm the Enterprise Controller restart.
For example:
# ecadm change-db-password -r -p /tmp/password
The Enterprise Controller will be restarted after the database password is
changed. Continue? (y/n)
y
ecadm: --- Changed database password, restarting.
ecadm: shutting down Enterprise Controller using SMF...
ecadm: Enterprise Controller services have stopped
ecadm: Starting Enterprise Controller with SMF...
ecadm: Enterprise Controller services have started
#
3. If you have a high availability configuration, the ecadm command copies the new
database properties to each remote cluster node. Enter the root password for each
remote cluster node.
For example:
ecadm: --- Changed database password, restarting.
The DB configuration file must now be copied to each remote cluster node.
You will be prompted for the root password for each node to perform the copy.
Copying to node OC-secondary
Password: password
<output omitted>
ecadm: --- Enterprise Controller successfully started HA
#
For example:
# rm /tmp/password
6. Click in the Value field to edit it. Change the value to false.
2-28 Security
Configuring Oracle Enterprise Manager Ops Center
To investigate an issue with an asset, My Oracle Support might instruct you to view
the Domain Model Navigator. To re-enable the Domain Model Navigator, use the
same procedure to set the property values to true.
• Match JMX patterns in the name. For example, to search for all cache managers,
search for: *:type=*Cach*,*
– Status Not OK, which invokes the not Status = 'OK' query
• Refresh
• Set
Warning:
2-30 Security
Configuring Oracle Enterprise Manager Ops Center
/var/opt/sun/xvm/OCDoctor/[Link] --update
/var/opt/sun/xvm/OCDoctor/[Link] --troubleshoot
2. Check the prerequisites for encryption and then encrypt the agent password:
Note:
Oracle Enterprise Manager Ops Center does not use any version of SSL. All
transactions with the web browser are in TLS. To verify that SSL is not used,
use the following command:
openssl s_client -connect IPaddress:port -ssl3
Information sent to and from a browser is transmitted in the clear so any intermediate
site can read the data and potentially alter it in transit. Oracle Enterprise Manager Ops
Center's browsers and servers address this problem in part by using the Secure
Sockets Layer to encrypt HTTP transmissions (referred to as HTTP/SSL or HTTPS).
This ensures the security of data transmitted from the client to the server. However,
because browsers do not ship with client certificates, most HTTPS transmissions are
authenticated in only one direction, from server to client. The client does not
authenticate itself to the server.
The browser interface uses JavaScript extensively. Take care to protect against
JavaScript-based attacks.
Note:
Some locales do not allow the use of strong ciphers. It is the user's
responsibility to verify that this level of encryption is allowed under local
regulations.
2-32 Security
Configuring Oracle Enterprise Manager Ops Center
protocol for all communications, change the Enterprise Controller’s Glassfish server
and each remote Proxy Controller’s Glassfish Serve and change the Apache UCE
Container.
1. Login as root.
4. To set the protocol to accept only TLS v1.2, change the line to: SSLProtocol -
all +TLSv1.2
Note:
Before changing the TLS version used by the Proxy Controller, check if all the
Agent Controllers managed by the Proxy Controller can use the TLS version.
Agent Controllers that use JDK 6 version lesser than 1.6.115 only supports
TLSv1.0.
1. To see the current minimum version of the TLS protocol, issue the following
command:ecadm get-tls-level
ecadm set-tls-level -e 2
• Database: Manages the database used by Oracle Enterprise Manager Ops Center.
• Proxy Manager: Manages the interactions between the parts of the infrastructure.
2-34 Security
Access to Database Data
Note:
• Database host name – The name of the database host is listed in the [Link]
property of the /var/opt/sun/xvm/[Link] file on the Enterprise
Controller system. The format for this property is:
jdbc:oracle:thin:@<databasehostname>:<listenerPort>/
<OracleServiceName>
• Read-Only User Name – The Read-Only User name is a schema on the Oracle
Enterprise Manager Ops Center Repository that is configured to access Oracle
Enterprise Manager Ops Center data using read-only views. When the Enterprise
Controller uses an embedded database, the username is OC_RO. When the
Enterprise Controller uses a customer-managed database, the schema name is
included in the [Link] property of the /var/opt/sun/xvm/
[Link] file.
• Listener Port – The listener port number for the database is listed in the
[Link] property of the /var/opt/sun/xvm/[Link] file on the
Enterprise Controller system. The format for this property is:
jdbc:oracle:thin:@<databasehostname>:<listenerPort>/
<OracleServiceName.
Using Oracle SQL Developer, you can connect to the database using a read-only
account and view the schema structures and data.
$ su - oracleoc
vi $ORACLE_HOME/network/admin/[Link]
#tcp.validnode_checking = yes
#tcp.invited_nodes = (localhost,x4150-brm-04)
5. To use the new version of the file, either restart all services on the Enterprise
Controller, or reload the Oracle*Net Listener configuration from the oracleoc
user environment.
/opt/SUNWxvmoc/bin/satadm stop -w
/opt/SUNWxvmoc/bin/satadm start -w
OR
$ lsnrctl reload OCLISTENER
2. Change to the user that owns the Oracle software. For example:
$ su - oracleoc
3. Modify the [Link] file to comment out the two lines beginning with
tcp.validnode_checking and tcp.invited_nodes. For example:
$ vi $ORACLE_HOME/network/admin/[Link]
#tcp.validnode_checking = yes
#tcp.invited_nodes = (localhost,<EnterpriseControllerHostname>)
4. Use the lsnrctl reload command to reload the listener configuration without
stopping the Enterprise Controller services. For example:
2-36 Security
Access to Database Data
You must create a connection to the Enterprise Manager Ops Center database in .
1. In Oracle SQL Developer, click the New Connection icon in the Connections tab.
• Connection Name – Enter a name. This name is only used in Oracle SQL
Developer.
• Service Name – Select the service name option and enter the service name. For
embedded databases, the service name is shown in the following figure. For
customer-managed databases, the service name is included in the
[Link] property in the /var/opt/sun/xvm/[Link] file.
1. Select the connection you created in the previous procedure. The contents of the
target database are displayed.
2. Within the database hierarchy, expand the Other Users section, then select the
application user and expand the Views section. If you are using an embedded
database, the application user is OC. If you are using a customer-managed
database, the application user is included in the [Link] property of
the /var/opt/sun/xvm/[Link] file.
2-38 Security
Access to Database Data
3. View the comment column to find the location of the Javadoc for each column,
which explains the usage of the column.
Note:
After you get access to the product data, you can integrate the data with other
applications, run analytics on the product data, or take other actions that require the
data.
2. Run the ecadm sqlplus command. Use the -r option to access the database in
read-only mode.
2-40 Security
3
Security Features
• Authentication
• Authorization
• Access Control
• Data Protection
• ASSET_ADMIN
• CLOUD_ADMIN
• CLOUD_USER
• EXALOGIC_ADMIN
• FAULT_ADMIN
• NETWORK_ADMIN
• OPS_CENTER_ADMIN
• PROFILE_PLAN_ADMIN
• READ
• REPORT_ADMIN
• ROLE_ADMIN
• SECURITY_ADMIN
• SERVER_DEPLOY_ADMIN
• STORAGE_ADMIN
• Update_ADMIN
• Update_SIM_ADMIN
• USER_ADMIN
• VIRT_ADMIN
3-2 Security
Configuring and Using Authentication
2. Add users to these groups. The users within each group are given the role
corresponding to the group.
• SSL: Check this box to use TLS to connect to the directory server.
• Anonymous Bind: Check this box to use anonymous binding to access the
directory server.
• Username: The user name used to access the directory server. Username is
required only if Anonymous Bind is not checked.
• Password: The password for the given user name. Password is required only if
Anonymous Bind is not checked.
• Group search DN: The container or operational unit in which to search for the
role groups.
• Group search scope: The scope of the group search. Select Search One Level or
Search Subtree.
• User search DN: The container or operational unit in which to search for users.
• User search scope: The scope of the user search. Acceptable values are base,
one, subtree, baseObject, singleLevel, wholeSubtree, or subordinateSubtree.
• User search filter: An LDAP search filter which users must meet for inclusion.
Click Next.
The Summary page is displayed.
1. On a Linux system, create a configuration file or edit the existing configuration file
for the service to use. The configuration file has the same name as the service.
/etc/pam.d/filename
3. To initialize the PAM service with the new configuration, stop the Enterprise
Controller:
/opt/sun/xvmoc/bin/satadm stop
3-4 Security
About Authorization
/opt/sun/xvmoc/bin/satadm start
Note:
If you use the SafeNet SafeWord® Agent for PAM software
(pam_safeword.so), you can use the SafeWord static password mode or
single-use dynamic password mode, but you cannot use the dynamic
challenge password mode. To use single-use dynamic passwords, you must
modify the pam_safeword.cfg file to ensure that the User ID source is set to
SYSTEM and not USER. The SYSTEM setting causes the authentication process
to get the User ID from the /etc/passwd file.
• The file must be owned by the user running the IAAS command-line interface.
• The file must have the highest restrictive permission: read-only by file owner.
About Authorization
Describes authorization.
Authorization allows a system to determine the privileges which users and other
systems have for accessing resources on that system.
Roles grant users the ability to use the different functions of Oracle Enterprise
Manager Ops Center. By giving a role to a user, an administrator can control what
functions are available to that user and for which groups of assets.
An Enterprise Controller Admin can grant users different roles for the Enterprise
Controller, the All Assets group, and any user-defined groups. A user who is assigned
a role for a group receives the same role for all subgroups.
Caution:
• SSH credentials for Operating System instances and hardware service processors.
Note:
IPMI communications from the Proxy Controller to the ILOM system are not
encrypted. To protect the transmissions, isolate the ILOM system and the
Proxy Controller it uses within your private administrative network.
• You must create the SSH key on each Proxy Controller that needs to get access to
the asset.
• For an OS asset, you must add the SSH public key to the ~/.ssh/
authorized_keys file. For a hardware asset, you must use the asset's Web
interface to upload the public SSH key.
3-6 Security
About Authorization
2. Click the Custom SSH key button, as shown in Figure 3-1, to enable the remaining
fields.
3. In Login User, enter the name of the account that uses this key.
4. The location of the key file is set to the default location for the sshkey-gen utility.
If your site uses a different location, edit this field.
The passphrase is an optional addition to the password and is created at the same
time as the key.
Note:
If you do not specify this account, Enterprise Manager Ops Center creates an
account each time it accesses a serial console and deletes the account when the
connection is no longer needed. This activity might not conform to your site's
security policy.
The following types of assets use SSH to connect to a serial console. Create an account
for each type and define the same password for each account.
• Proxy Controllers
• Global zones that use agents and require access to the consoles of non-global zones
• Control domains that use agents and require access to the consoles of logical
domains
To create the account, define the ConsoleSSHCredname system property using the
procedure in Defining the system property for console access and then define a user
account for that property using either the procedure in Creating the account using
Enterprise Manager Ops Center or the procedure in Creating the account using the
useradd command.
5. Enter the name of the new user account. For example, SERIALCONSOLE_CRED1.
6. Click Save.
When the job is completed, define the account using the following procedure.
3-8 Security
About Authorization
After you define the user account, the account is created automatically in /etc/
passwd the first time a job for console access is run. However, if your site's security
policy requires that the operating system account must be created outside of
Enterprise Manager Ops Center's control or if you prefer to create the account
manually, use the procedure described in Creating the account using the useradd
command.
• Login User: Enter a convenient or descriptive name for the user account, for
example, ConsoleAccess.
1. Create the home directory for the account. In the following example, the account is
named consolex:
mkdir /var/tmp/consolex
where uid is an available user ID on the Enterprise Controller's system and profile is
either LDoms Review for a control domain or Zone Management for a global
zone. The -A option is a feature of Oracle Solaris 11's useradd(1m) command that
includes an authorization defined in auth_attr(4).
passwd consolex
– User name: the user account provides authentication that supports Agent
Controller registration. Use the user name of this account as the argument for
the -u option of the agentadm command.
• IP address or host name of the Proxy Controller with which you will associate the
Agent Controller – Use this IP address or host name as the argument for the
agentadm -x option. Typically, you would associate the Agent Controller with
the Proxy Controller that is connected to the same subnet as the target system.
• The IP address of the network interface that the Agent Controller will use for
registration – Use this IP address as the argument for the agentadm -a option.
Some example agentadm commands in this procedure use the alternative
administrative user name droot. In these examples, the droot user exists on the
Enterprise Controller.
3-10 Security
About Authorization
When you install an Agent Controller on a global zone, the installation installs, or
upgrades to, Oracle Java Runtime Environment (JRE) 1.6.0_91. If a later version of JRE
is installed, the installation does not downgrade.
# cd /var/opt/sun/xvm/images/agent/
# ls
[Link]
[Link]
[Link]
[Link]
[Link]
[Link]
[Link]
[Link]
#
2. Identify the Agent Controller archive that is appropriate for the system where you
intend to install the Agent Controller, the target system. See Table 3-1 for a
description of the available packages.
Table 3-1 Agent Controller Packages and Their Operating System and
Architecture
3. On the system where you want to install the Agent Controller, create the following
directory:
# mkdir /var/tmp/OC
4. Use scp or ftp to transfer the Agent Controller archive from the Enterprise
Controller to the /var/tmp/OC directory. Respond to any authentication or
confirmation prompts that are displayed. For example:
# cd /var/tmp/OC
#
6. Use the unzip command to uncompress the Agent Controller archive. For
example:
# unzip [Link]
(output omitted)
7. If you are installing the Agent Controller on Oracle Solaris 8-10, run the install
-a script in the OpsCenterAgent directory. For example:
# OpsCenterAgent/install -a
Installing Ops Center Agent Controller.
No need to install 120900-04.
No need to install 121133-02.
No need to install 119254-63.
No need to install 119042-09.
No need to install 121901-02.
No need to install 137321-01.
Installed SUNWjdmk-runtime.
Installed SUNWjdmk-runtime-jmx.
(output omitted)
6 patches skipped.
19 packages installed.
Installation complete.
Detailed installation log is at /var/scn/install/log.
Uninstall using /var/scn/install/uninstall.
If you are installing the Agent Controller on Oracle Solaris 11, run the install
command with the -p option and specify the IP address. The command configures
a local IPS repository using the IP address. For example:
# OpsCenterAgent/install -p [Link]
If you are installing an Oracle VM Server Virtualization Controller Agent, use the -
l (or --ldom) option.
# touch /var/tmp/OC/mypasswd
# chmod 400 /var/tmp/OC/mypasswd
9. Edit the /var/tmp/OC/mypasswd file to add the password for the administrative
user that exists on the Enterprise Controller to which the Proxy Controller is
connected. The following echo command appends the password to
the /var/tmp/OC/mypasswd file. Replace the password with the correct
password. For example:
10. Use the agentadm command to associate the Agent Controller with the Proxy
Controller.
3-12 Security
About Authorization
• -u: Specifies the administrative user that exists on the Enterprise Controller to
which the Proxy Controller is connected. Be certain that the password that you
specified in the /var/tmp/OC/mypasswd file is correct for the user that you
specify for this option.
Note:
The examples use droot as the administrative user.
• -p: Specifies the absolute path name of the file that contains the password for
the user that you specified with the -u option.
• -x: Specifies the IP address or host name of the Proxy Controller to which this
Agent Controller will connect.
• -a: Specifies the IP address to use during Agent Controller registration. This
selects the network interface that the Agent Controller will use for registration.
Accept the server's certificate when prompted. For example:
# /opt/SUNWxvmoc/bin/agentadm configure -u droot -p /var/tmp/OC/mypasswd -x
[Link]
agentadm: Version 1.0.3 launched with args: configure -u droot -p /var/tmp/OC/
mypasswd -x [Link]
workaround configuration done.
Certificate:
Serial Number: 947973225
Version: 3
Issuer: CN=flyfishing_scn-proxy_ca
Subject: CN=flyfishing_scn-proxy_Agent Controller
Not valid before: Thu Jun 19 [Link] MDT 1969
Not valid after: Thu Apr 19 [Link] MDT 2029
Certificate:
Serial Number: 1176469424
Version: 3
Issuer: CN=flyfishing_scn-proxy_ca
Subject: CN=flyfishing_scn-proxy_ca
Not valid before: Thu Jun 19 [Link] MDT 1969
Not valid after: Thu Apr 19 [Link] MDT 2029
Accept server's certificate? (y|n)
y
Connection registered successfully.
scn-Agent Controller configuration done.
Checking if UCE Agent Controller process is still running, it may take a
couple of minutes ...
Process is no longer running
UCE Agent Controller is stopped.
UCE Agent Controller is in [online] state.
Checking if UCE Agent Controller process is up and running ...
The process is up and running.
UCE Agent Controller is started.
Added the zone configuration automation successfully.
Added the service tags recreate script successfully.
#
the file that you specified for the agentadm -p option, match an existing
administrative user on the Enterprise Controller.
Accept server's certificate? (y|n)
y
Error with connection to CRS: [Link]:
droot, Code: 4, Code: 4
ERROR : Connection cannot be registered.
Code--2
sc-console registration failed on [2].
sc-console : User authentication error.
Error executing step : sc_console
If the system where you are installing the Agent Controller has multiple active
network interfaces, you can use the -a option to specify the IP address of the
interface that you want to use for Agent Controller registration. For example:
# /opt/SUNWxvmoc/bin/agentadm configure -u droot -p /var/tmp/OC/mypasswd -x
[Link] -a [Link]
(output omitted)
11. If you encountered a Connection cannot be registered error message from the
agentadm command, use agentadm to unconfigure the Agent Controller. For
example:
# /opt/SUNWxvmoc/bin/agentadm unconfigure
agentadm: Version 1.0.3 launched with args: unconfigure
verified sc_console command is OK
End of validation
{output omitted}
End of configuration.
After the Agent Controller has been unconfigured, correct the problem that was
indicated by the error message, and re-run the agentadm configure command.
12. Use the sc-console command to list the Agent Controller connection. For
example:
# sc-console list-connections
scn-Agent Controller [Link]
urn:scn:clregid:abcdef12-6899-4bcc-9ac7-a6ebaf71c1f5:20090420171121805
#
# cd /var/opt/sun/xvm/images/agent/
# ls
[Link]
[Link]
[Link]
[Link]
[Link]
[Link]
#
3-14 Security
About Authorization
2. Identify the Agent Controller archive that is appropriate for the system where you
intend to install the Agent Controller. See Table 3-1 for a description of the
available packages.
3. On the system where you want to install the Agent Controller, create the following
directory:
# mkdir /var/tmp/OC
4. Use scp or ftp to transfer the Agent Controller archive from the Enterprise
Controller to the /var/tmp/OC directory. Respond to any authentication or
confirmation prompts that are displayed. For example:
# cd /var/tmp/OC
#
6. Use the unzip command to uncompress the Agent Controller archive. For
example:
# unzip [Link]
(output omitted)
7. If you are installing the Agent Controller on Oracle Solaris 8-10, run the install
-a script in the OpsCenterAgent directory. For example:
# OpsCenterAgent/install -a
Installing Ops Center Agent Controller.
No need to install 120900-04.
No need to install 121133-02.
No need to install 119254-63.
No need to install 119042-09.
No need to install 121901-02.
No need to install 137321-01.
Installed SUNWjdmk-runtime.
Installed SUNWjdmk-runtime-jmx.
(output omitted)
6 patches skipped.
19 packages installed.
Installation complete.
Detailed installation log is at /var/scn/install/log.
Uninstall using /var/scn/install/uninstall.
#
If you are installing the Agent Controller on Oracle Solaris 11, run the install
command with the -p option and specify the IP address. The command configures
a local IPS repository using the IP address. For example:
# OpsCenterAgent/install -p [Link]
#
8. On the Proxy Controller that will communicate with this Agent Controller instance,
examine the /var/opt/sun/xvm/persistence/scn-proxy/
[Link] file. The last line in this file contains the auto-reg-
token that is required for Agent Controller registration. For example:
# cat /var/opt/sun/xvm/persistence/scn-proxy/[Link]
#Generated by a program. Do not edit. All manual changes subject to deletion.
(output omitted)
trust-store=/var/opt/sun/xvm/security/jsse/scn-proxy/truststore
auto-reg-token=abcdef12-1700-450d-b038-ece0f9482474\:1271743200000\:T
#
9. On the system where you have installed the Agent Controller software, create an
empty file named /var/tmp/OC/mytoken, and set its permission mode to 400.
For example:
# touch /var/tmp/OC/mytoken
# chmod 400 /var/tmp/OC/mytoken
10. Edit the /var/tmp/OC/mytoken file so that it contains the auto-reg-token string
from Proxy Controller with the following changes:
• Remove any backslash characters from the token string. For example:
abcdef12-1700-450d-b038-ece0f9482474:1271743200000:T
11. Use the agentadm command to associate the Agent Controller with a Proxy
Controller.
• -t: specifies the absolute path name of the file that contains the registration
token.
• -x: specifies the IP address or host name of the Proxy Controller to which this
Agent Controller will connect.
• -a: specifies the IP address to use during Agent Controller registration. This
selects the network interface that the Agent Controller will use for registration.
Accept the server's certificate when prompted. For example:
# /opt/SUNWxvmoc/bin/agentadm configure -t /var/tmp/OC/mytoken -x [Link]
agentadm: Version 1.0.3 launched with args: configure -t /var/tmp/OC/mytoken -
x [Link]
workaround configuration done.
Certificate:
Serial Number: 947973225
Version: 3
Issuer: CN=flyfishing_scn-proxy_ca
Subject: CN=flyfishing_scn-proxy_Agent Controller
Not valid before: Thu Jun 19 [Link] MDT 1969
Not valid after: Thu Apr 19 [Link] MDT 2029
Certificate:
Serial Number: 1176469424
3-16 Security
About Authorization
Version: 3
Issuer: CN=flyfishing_scn-proxy_ca
Subject: CN=flyfishing_scn-proxy_ca
Not valid before: Thu Jun 19 [Link] MDT 1969
Not valid after: Thu Apr 19 [Link] MDT 2029
If the system where you are installing the Agent Controller has multiple active
network interfaces, you can use the -a option to specify the IP address of the
interface that you want to use for Agent Controller registration. For example:
# /opt/SUNWxvmoc/bin/agentadm configure -t /var/tmp/OC/mytoken -x [Link] -a
[Link]
(output omitted)
12. If you encountered a Connection cannot be registered error message from the
agentadm command, use agentadm to unconfigure the Agent Controller. For
example:
# /opt/SUNWxvmoc/bin/agentadm unconfigure
agentadm: Version 1.0.3 launched with args: unconfigure
verified sc_console command is OK
End of validation
{output omitted}
End of configuration.
After the Agent Controller has been unconfigured, correct the problem that was
indicated by the error message, and re-run the agentadm configure command.
13. Use the sc-console command to list the Agent Controller connection. For
example:
# sc-console list-connections
scn-Agent Controller [Link]
urn:scn:clregid:abcdef12-6899-4bcc-9ac7-a6ebaf71c1f5:20090420171121805
#
Topics
2. Enter the visudo command to edit the asset’s sudoers file safely.
3. Edit the sudoers file to conform with the example. Add the command aliases for
discovery and provisioning in the following way according to the operating system
of the asset and whether it :
• For agentless Oracle Linux assets, add the LINUX_DISCOVERY section of the
file.
4. In the ## User privilege specification section, add the name of the new
SSH credential that you created or will create using the procedure in “Creating
Management Credentials.”. Because a password is mandatory, do not add the
NOPASSWD parameter.
##
## Host alias specification
3-18 Security
About Authorization
##
## Groups of machines. These may include host names (optionally with wildcards),
## IP addresses, network numbers or netgroups.
# Host_Alias WEBSERVERS = www1, www2, www3
##
## User alias specification
##
## Groups of users. These may consist of user names, uids, Unix groups,
## or netgroups.
User_Alias OPSCENTER = <username>
##
## Cmnd alias specification
##
## Groups of commands. Often used to group related commands together.
##
## Defaults specification
##
## You may wish to keep some of the following environment variables
## when running commands via sudo.
##
## Locale settings
# Defaults env_keep += "LANG LANGUAGE LINGUAS LC_* _XKB_CHARSET"
##
## Run X applications through sudo; HOME is used to find the
## .Xauthority file. Note that other programs use HOME to find
## configuration files and this may lead to privilege escalation!
# Defaults env_keep += "HOME"
##
## X11 resource path settings
# Defaults env_keep += "XAPPLRESDIR XFILESEARCHPATH XUSERFILESEARCHPATH"
##
## Desktop path settings
# Defaults env_keep += "QTDIR KDEDIR"
##
##
## Runas alias specification
##
##
## User privilege specification
##
root ALL=(ALL) ALL
## Uncomment to allow any user to run sudo if they know the password
## of the user they are running the command as (root by default).
# Defaults targetpw # Ask for the password of the target user
# ALL ALL=(ALL) ALL # WARNING: only use this together with 'Defaults targetpw'
3-20 Security
About Authorization
• To assign an existing set of credentials, select Assign existing set and then select
an existing set of credentials.
• To assign a new set of credentials, select Create and assign new set and then
enter a protocol, name, and credential information.
3. Select the credentials that you want to change. You can select more than one type of
credentials.
Note:
If you are modifying the SNMPv3 credentials, then you can edit the username,
authentication protocol, authentication password, privacy protocol, or privacy
password.
You can create a new set of management credentials. These credentials can then be
used to discover and manage new assets or to manage existing assets.
To create management credentials, perform the following steps:
3. Click on the drop-down list to see the list of available protocols. Accept the default
SSH protocol or select a different protocol. Depending on the type of protocol you
select, the remaining fields change to collect the required information for the
credentials. For specific examples, see Creating SSH Credentials or Creating
SNMPV3 Credentials.
5. Select or specify the required information for the type of credential, such as the
username and password.
The default protocol for managing assets is SSH. To create SSH credentials, perform
the following steps:
3. Specify a name and description, such as their purpose for the credentials.
5. Accept the default authentication type or choose one of the alternatives. Each type
has different requirements for authentication.
• Custom SSH Key: Creates a public SSH key by specifying the Login User name,
a Private Key file name, and a passphrase. In the Private Key File on Proxy
Controller(s) field, accept the default file or change it to refer to other keys. The
Proxy Controller installs the SSH public key on the asset's privileged user's
authorized SSH key.
• Ops Center Key: Oracle Enterprise Manager Ops Center generates a new SSH
key pair, based on the username you provide, and installs the public key in the
asset’s login account during discovery. This method requires a set of credentials
to begin the discovery. After discovery, the SSH key pair is used. This method
does not provide a way to escalate privileges.
6. You can allow the new account to use escalated privileges. The default method is to
not allow a change in privileges. The alternatives are to specify a role for the
account or to add sudo to the account.
3-22 Security
About Authorization
• If you choose the Role method, the Privileged Role field is displayed. Enter the
name of an Ops Center role and specify a password. The new account has this
level of access.
• If you choose the Sudo method, the Privileged Role field is displayed. Enter the
name of an Ops Center account and specify a password. This account must be
included in the asset’s /etc/sudoers file. The privileges defined in the /etc/
sudoers file will be used by the new account. See “Preparing to Use sudo” for
instructions in creating this file. You can edit this file after you complete this
procedure, but the Ops Center account must be in the file before the new
credentials are effective.
7. Accept the default port for SSH of 22, unless your site has a different requirement.
For more information on creating SSH Credentials, see Oracle Enterprise Manager
Ops Center Configuration Reference.
3. Click on the drop-down list to see the list of available protocols. Click SNMPV3.
4. Specify a name and description, such as their purpose for the credentials.
5. Specify the user name with the prefix OC for the credential.
Note:
The user name for SNMPV3 protocol is always prefixed with OC.
8. Accept the default privacy protocol, DES, or choose AES, which is a stronger
encryption protocol.
For more information on creating SSH Credentials, see Oracle Enterprise Manager
Ops Center Configuration Reference.
You can edit an existing set of management credentials to reflect changes to the
managed assets.
To edit management credentials, perform the following steps:
2. In the center pane, select a set of credentials and click the Edit Credentials icon.
3. Edit the description and the information required by the protocol, then click
Update to save the changes.
2. In the center pane, select a set of credentials and click the Copy Credentials icon.
3. Edit the name, description, and the information required by the protocol, then click
Copy to save the new set of credentials.
2. In the center pane, select a set of credentials and click the Delete Credentials icon.
4. Click the drop-down list of protocols to select the type of protocol. Enter a name
and description of the purpose of these credentials, for example, the type of asset
they support.
3-24 Security
Configuring and Using Access Control
The window displays the assets that use these credentials and are affected by any
change.
3. Click Apply.
About Certificates
Describes self-signed certificates.
By default, Oracle Enterprise Manager Ops Center uses self-signed certificates for
authentication between the web container and the browser client. Oracle Enterprise
Manager Ops Center does not provide certificates signed by a Certificate Authority
such as Verisign because an Authority requires the name of the domain where the
certificate will be used. The Oracle Enterprise Manager Ops Center software cannot be
delivered with a generated signed certificate because the domain where the Web
server of the Enterprise Controller runs is unknown until the customer installs the
software. However, after installation, use the procedure in Substituting Certificates for
the Glassfish Web Container to replace the self-signed certificate with a certificate
from a Certificate Authority.
Topics
3. In the Time Intervals section of the User Interface Preferences window, change the
value in the Session Timeout field.
rm -rf /opt/SUNWoccli/doc/examples
Topics
3-26 Security
Configuring and Using Data Protection
1. Create the directory to share, and set its ownership and permission modes. For
example:
# mkdir -p /export/lib/libX
# chmod 777 /export/lib/libX
3. Add an entry to share the directory. For example, to share the directory named /
export/lib/libX, create the following entry:
If you want the NFS share to be accessible from other network domains, use the rw
option to specify a list of allowed domains:
share -F nfs -o rw=IPaddress1,IPaddress2 "Share 0" export/lib/libX
4. Share the directory and then verify that the directory is shared. For example:
# shareall
# share
export/lib/libX rw, "Share 0"
The share now allows a root user on the NFS clients to have write privileges.
• The new system must have the same architecture and operating system as the old
system. It is recommended that the operating system versions be identical,
including updates and SRUs.
• The host name of the new system should be the same as the old system. You can
change the host name of the new system, provided the old host name is added as
an alias host name in the new system.
• The IP address of the new system can be different. If the new system has a different
IP address, the restore process includes a step to configure any remote Proxy
Controllers to use the new Enterprise Controller IP address. The MAC address of
the new system can be different.
• The new system's Enterprise Controller software version must also match those of
the backed up system.
For a regular back up and restore procedure, the IP address and the host name of the
new system should match that of the old system. For a disaster recovery procedure,
the IP address and the host name of the new system can be different than that of the
old system.
If a remote Proxy Controller system fails, you can use the proxyadm
restore command and the backup file to restore the Proxy
Controller. The proxyadm restore command accepts the name of the backup file as
input, and restores the Proxy Controller to the state it had at the time of the backup.
Some of the procedures described in this section use the ecadm and proxyadm
commands. See the Oracle Enterprise Manager Ops Center Administration for more
information about these commands.
Note:
The ecadm backup command does not back up the /var/opt/sun/xvm/
images/os directory because the size of some of the OS image files in this
directory can be prohibitively large.
In addition to running the ecadm backup command, back up
the /var/opt/sun/xvm/images/os directory and archive the files to
another server, file-share facility, or a location outside of the /var/opt/sun
directory.
3-28 Security
Configuring and Using Data Protection
By default, the server data is saved in a backup file in the /var/tmp directory with a
file name that includes a date and time stamp. You can define the file name and
location during the backup, as shown in the example below.
If you are using an embedded database, the backup file includes the product schema
from the embedded database. If you are using a customer-managed database, you can
back up the database schema using the --remotedb option, or you can use the
existing backup and recover processes implemented by your database administrator.
2. Use the ecadm command with the backup subcommand to back up the Enterprise
Controller.
• -o|--output <backup file>: Specify the file in which the backup archive is
generated. Do not specify a path inside the /opt/*xvm* directories. The
default output file is /var/tmp/sat-backup-<date>-<time>.tar.
• -l|--logfile <logfile>: Save output from command in <logfile>. Log files are
stored in the /var/tmp/ directory.
For example:
ecadm start -w
Note:
Before you restore on a system, you must uninstall any previously existing
Enterprise Controllers, Proxy Controllers, and Agent Controllers from the
system.
• If you are restoring the backup on a new system, then the new system must
have the same architecture and operating system as the old system. It is
recommended that the operating system versions be identical, including
updates and SRUs. The new system's host name and Enterprise Controller
software version must also match those of the backed up system. If the host
name does not match, add the old host name as an alias to the /etc/hosts file.
• If you are restoring the backup on the same system, but the software has
become corrupt or an upgrade failed, uninstall the Enterprise Controller
software.
Run the install script with the -e and -k options. The -e option uninstalls
the Enterprise Controller and co-located Proxy Controller, and the -k option
preserves the Oracle Configuration Manager software. For example:
# cd /var/tmp/OC/xvmoc_full_bundle
# install -e -k
2. Install the Enterprise Controller to the same version that was running when the
backup was made, but do not configure the Enterprise Controller, as the ecadm
restore command restores your configuration settings.
• Oracle Solaris OS: See Oracle Enterprise Manager Ops Center Installation for Oracle
Solaris Operating System.
• Linux OS: See Oracle Enterprise Manager Ops Center Installation for Linux
Operating Systems.
3-30 Security
Configuring and Using Data Protection
Note:
3. Run the ecadm command with the restore subcommand and the -i <backup
directory location and file name> flag.
• -i|--input <backup file>: (Required) Specify the location of the backup file.
• -l|--logfile <logfile>: Save output from command in <logfile>. Log files are
stored in the /var/tmp/ directory.
# proxyadm status
offline
# proxyadm start -w
proxyadm: Starting Proxy Controller with SMF...
proxyadm: Proxy Controller services have started
5. If you restored the Enterprise Controller on a new system, restart each remote
Proxy Controller to use the new Enterprise Controller.
# proxyadm stop -w
6. Restart the co-located Agent Controllers using the agentadm command with
the start subcommand and the -w option. For example:
/opt/SUNWxvmoc/bin/agentadm start -w
Note:
After restoring the Enterprise Controller, the asset details might take several
minutes to display completely in the user interface.
Note:
During the database schema restore, an import log is created. The name of the
import log appears in the Enterprise Controller restore log file with
the OC_import<timestamp>.log format. You can check the progress of the
database import status using this import log.
3-32 Security
Configuring and Using Data Protection
In this example, the ecadm restore command includes options to set the restore in
verbose mode (-v), and to create a restore log (-l) for debugging purposes. The input (-
i) option specifies the backup file location. The (-r) option is not included.
# /opt/SUNWxvmoc/bin/ecadm restore -v -i /var/tmp/OC/server1/[Link] -l
[Link]
3-34 Security
Index
A C
Access control, 3-25 Certificate Authority, 2-7
Accounts Certificates
serial console, 3-7 expiration, 2-8
Activity, 1-24, 1-26, 1-27 Oracle Glassfish Server, 2-16
Agent Controllers cipher, 2-31
encryption, 2-30 Cipher, 2-32
installing, 3-10, 3-11, 3-14 Cloud, 3-5
log file, 1-27 Clusterware, 2-1
agentadm Code examples, 3-26
requirements, 3-10 Command line interface, 3-26
Apache UCE Container
Configuration, 2-34
certificates, 2-18 Connection modes
Architecture, 1-3 comparison, 2-21
Asset management
Console access, 3-8
credentials
Cookies, 3-25
copying, 3-24
Create Credentials, 3-8
creating, 3-21
Credentials
deleting, 3-24
applying a plan, 3-25
editing, 3-23 asset management
updatng, 3-21 copying, 3-24
upgrading, 3-20 creating, 3-21
Audit logs
creating a plan, 3-24
date and time, 1-25
deleting, 3-24
example, 1-25
editing, 3-23
[Link], 1-25
upgrading, 3-20
Authentication
authentication, 3-22, 3-23
Agent Controller, 1-4
creating, 3-22, 3-23
LDAP, 3-2
roles, 3-22
PAM, 3-4
SNMPV3, 3-23
Proxy Controller, 1-4
ssh, 3-7
Authorization, 3-5
SSH, 3-22
curl, 3-25
B
Backup, 3-26, 3-27 D
backup and restore
Data protection
backing up an Enterprise Controller, 3-28
NFS, 3-26
Index-1
Database J
accessing data, 2-35
credentials, 2-26, 2-27 Java Cryptography Extension, 2-32
customer-managed, 1-2 JCE, 2-32
embedded, 1-2 JMX, 2-30
encryption, 2-24 Jurisdiction policy files, 2-32
local, 1-2, 2-24
log file, 1-27 K
remote, 1-2, 2-4, 2-24
Date and time, 1-25 Keys, 2-7
Directory Server, 3-2, 3-3 Knowledge Base, 1-1
Disable Multiple Logins, 2-22
DMZ, 1-5 L
Domain model
Navigator, 2-29 LDAP, 3-2
Domain Model Navigator, 2-28 Listener Port, 2-35
Local database, 2-24
Log files
E audit log, 1-27
Encryption, 2-24, 2-31, 2-32 errors, 1-27
Enterprise Controller jobs, 1-27
backing up, 3-28 updates, 1-27
certificates, 2-7 Logging, 1-23, 1-27
configuration, 2-34 Logging in
High Availability, 2-2 multiple, 2-22
port, 1-5 Logs
private keys, 2-7 database, 1-27
restoring, 3-30 installation, 1-27, 2-23
server, 2-3
Enterprise Controllers M
certificates, 2-8
Expiration, 2-8 My Oracle Support, 3-5
F N
Firewalls Networks
ports, 1-5 Logs
web sites, 1-5 installation, 1-27, 2-23
OCDoctor, 2-23
separate, 2-2, 2-23
G NFS, 3-26
Glassfish, 2-16 NFS servers, 3-26
H O
High availability OCDB service name, 2-35
limitations, 2-2 Oracle SQL Developer, 2-35, 2-36
requirements, 2-2 Oracle*Net, 2-36
High Availability, 2-2 Oracle*Net Listener, 2-36
http-only, 3-25
P
I PAM
IAAS, 3-5 changing credentials, 3-4
Installation, 2-1, 2-5 Planning for security, 2-1
IPMI, 3-6 Plans
credentials, 3-25
Index-2
Ports, 1-5, 2-35 ssh (continued)
Privilege, 1-6 SSH
Product architecture, 2-5 key, 3-6
Product role, 1-1 sudo, 3-18
Proxy Controllers Storage, 2-3
certificates, 2-12 sudo, 3-18, 3-22
System properties, 3-7
R
T
Read-Only User Name, 2-35
Remote database, 2-4, 2-24 Timeout
Remote Directory Server, 3-2, 3-3 session, 3-26
Restore, 3-27 TLS
Restoring Apache UCE, 2-33
example, 3-32 Glassfish Web Container, 2-33
Role, 2-34 TRACE, 3-25
Roles Transport Layer Security, 2-6, 2-32
assign, 1-23 Types of security, 3-1
credentials, 3-22
root
U
SELINUX, 2-6
[Link], 2-32
S Upgrading the product, 1-5
User access, 1-6, 3-1
Safenet, 3-4 User roles
Session expiration, 3-26 assign, 1-23
Setting up, 1-5 useradd, 3-9
Setting up the product, 2-20
SNMPV3, 3-23
W
SQL, 2-24
SQL*Plus, 2-39 Web browsers, 2-31
ssh Web sites, 1-5
console access, 3-7 wget, 3-25
Index-3
Index-4