Contents

About the Authors

About the Technical Reviewers

Acknowledgments

 Chapter 1: Architecture

Enterprise Manager Framework

EM CLI Verbs

EM CLI Client Software

EM CLI and EMCTL

Agent Start and Stop

Centralization

Access

Safety Net

 Chapter 2: Installation and Security Framework and EM12c Release 4

EM CLI and WebLogic Installation

Requirements

Creating the WebLogic Domain Provisioning Profile

Filtering Out Fusion Middleware

Jython

Supported Java Versions

Path and Environment Variables

Client or Remote Target Installation

EM CLI Advanced Kit

EMCLI Installation via the OMS

Post-Installation

Patching and Upgrades

Patching with the EM CLI Clients

Patching Remote Client Installations

EM Security Framework

Security in the EM CLI

Secure Mode for EM CLI Setup

HTTPS Trusted Certificate

Verbs of Great Value in Release 4

Gold Agent Update Verbs

BI Publisher Reports Verbs

Cloud Service Verbs

Miscellaneous Verbs

Fusion Middleware Provisioning Verbs

Job Verbs

Target Data Verbs

Summary

 Chapter 3: Terminology and Basics

Terminology: Verbs

Modes

Command-line

Interactive

Scripting

Help!

Understanding Error Codes

Syntax

Setup

Communication

EM CLI

EMCTL

EMCTL versus EM CLI

Task: Establish a Login

Task: Get a List of Targets

Task: Using Blackouts

Task: Create Targets

Task: Manipulating Jobs

Summary

 Chapter 4: Working at the Command Line

Start an EM CLI Session

CLI References

The get_targets Verb

Output Formats

Agent Administration

Deleting EM Targets with EM CLI

Find Exact Target Names

Delete the Target

How to Remove an Enterprise Manager Agent with One Command

Transferring Targets to Another EM Agent

How It Works

OMS-Mediated Targets

Managing OEM Administrators

Role Management

Tracking Management Server Login

Summary

 Chapter 5: Automation Through Shell Scripts

Best Practices for Shell Scripting

Logging

Passwords and Shell Scripts

Calling EM CLI from a Shell Script

Shell Script Functions

GetTargetName Function

Name Argument

Add Targets Argument

Schedule Argument

A Robust Solution for Scheduled Blackouts

Summary

 Chapter 6: Advanced Scripting

History of Python

Jython

JSON

Getting Started

Hello World!

Finding Help

Python Objects

Numbers and Strings

Lists

Simple Lists

Lists in EM CLI

Strings and Lists

Dictionaries

Logon Script

Python Scripting with EM CLI to Set Target Properties

Python Class with EM CLI to Set Target Properties

Using the updateProps( ) Class

Understanding the Code

Summary

 Chapter 7: Using the Software Library and Oracle Extensibility Exchange

The OEM Software Library

Software Library

Setting Up Software Library Storage

Checking In Entities

Adding Scripts to the Software Library

Building a Report Definition Library

OEM Jobs Using CLI Calls

Create a Job

Step 1: Upgrade Agents

Step 2: Remove Old Agents

Export/Import Capabilities for Information Publisher Reports

Store Definition Library in Software Library

Oracle Extensibility Exchange

Extensibility Exchange

Classic View

Development Resources

Contribute

At a Glance

Summary

 Chapter 8: Sample EM CLI Scripts

Section 1: Function Library and Shell Scripts

Command-Line Inputs

Evidence of Life

Sample Function Library

Function-Related Shell Scripts

Section 2: EM CLI and Veritas Cluster Server

Program Logic

Veritas Cluster Server

Oracle Enterprise Manager

Implementation

Section 3: Essential Server-Management Scripts

Configuration Backup Script

Transitory File Cleanup Script

Section 4: EM CLI Scripting and Interactive Scripts

Simple Logon Script (start.py)

Secure Logon Script (secureStart.py)

Update Target Properties Commands (updatePropsFunc.py)

Update Target Properties Class (updateProps.py)

Index