2 Getting Started Managing Oracle Fusion Middleware

When you install Oracle Fusion Middleware, you install the binary files, such as executable files, jar files, and libraries. Then, you use configuration tools to configure the software.

This chapter provides information you need to get started managing Oracle Fusion Middleware, including information about the tools you use.

• Overview of Oracle Fusion Middleware Administration Tools
  After you install and configure Oracle Fusion Middleware, you can use the graphical user interfaces or command-line tools to manage your environment.
• Getting Started Using Oracle Enterprise Manager Fusion Middleware Control
  Fusion Middleware Control is a Web browser-based, graphical user interface that you can use to monitor and administer your domain. It can manage an Oracle WebLogic Server domain with its Administration Server, one or more Managed Servers, clusters, the Oracle Fusion Middleware components that are installed, configured, and running in the domain, and the applications you deploy.
• Getting Started Using Oracle WebLogic Server Administration Console
  Oracle WebLogic Server Administration Console is a Web browser-based, graphical user interface that you use to manage an Oracle WebLogic Server domain. It is accessible from any supported Web browser with network access to the Administration Server.
• Getting Started Using the Oracle WebLogic Scripting Tool (WLST)
  The Oracle WebLogic Scripting Tool (WLST) is a command-line scripting environment that you can use to create, manage, and monitor Oracle WebLogic Server domains. It is based on the Java scripting interpreter, Jython.
• Getting Started Using the Fusion Middleware Control MBean Browsers
  A managed bean (MBean) is a Java object that represents a JMX manageable resource in a distributed environment, such as an application, a service, a component or a device.
• Changing the Administrative User Password
  During the Oracle Fusion Middleware installation, you must specify a password for the administration account. Then, you can use this account to log in to Fusion Middleware Control and the Oracle WebLogic Server Administration Console for the first time. You can create additional administrative accounts using the WLST command line or the Oracle WebLogic Server Administration Console.
• Configuring Node Manager
  Node Manager allows you to perform common operations, such as starting and stopping a Managed Server, using the Administration Console or Fusion Middleware Control.
• Basic Tasks for Configuring and Managing Oracle Fusion Middleware
  There are several tasks you need to take to configure and manage a basic Oracle Fusion Middleware environment after you have installed the software.

Overview of Oracle Fusion Middleware Administration Tools

After you install and configure Oracle Fusion Middleware, you can use the graphical user interfaces or command-line tools to manage your environment.

Oracle offers the following primary tools for managing your Oracle Fusion Middleware installations:

• Oracle Enterprise Manager Fusion Middleware Control. See Getting Started Using Oracle Enterprise Manager Fusion Middleware Control.

• Oracle WebLogic Server Administration Console. See Getting Started Using Oracle WebLogic Server Administration Console.

• The Oracle Fusion Middleware command-line tools. See Getting Started Using the Oracle WebLogic Scripting Tool (WLST).

• The Fusion Middleware Control MBean Browser. See Getting Started Using the Fusion Middleware Control MBean Browsers.

Note that you should use these tools, rather than directly editing configuration files, to perform all administrative tasks unless a specific procedure requires you to edit a file. Editing a file may cause the settings to be inconsistent and generate problems.

Both Fusion Middleware Control and Oracle WebLogic Server Administration Console are graphical user interfaces that you can use to monitor and administer your Oracle Fusion Middleware environment. You can install Fusion Middleware Control and the Administration Console when you install most Oracle Fusion Middleware components.

Note the following:

• If you install a standalone Oracle WebLogic Server, Fusion Middleware Control is not installed. Only the Administration Console is installed.

• If you install Oracle JDeveloper, neither Fusion Middleware Control or the Administration Console are installed. They can be installed if you install Oracle Fusion Middleware Application Developer.

You can perform some tasks with either tool, but for other tasks, you can only use one of the tools. Table 2-1 lists some common tasks and the recommended tool.

Table 2-1 Comparing Fusion Middleware Control and WebLogic Server Administration Console

Task	Tool to Use
Create additional Managed Servers	Fusion Middleware Control
Clone Managed Servers	WebLogic Server Administration Console
Cluster Managed Servers	Fusion Middleware Control
Start and stop Oracle WebLogic Server	Fusion Middleware Control or WebLogic Server Administration Console
Add users and groups	Fusion Middleware Control or WebLogic Server Administration Console if using the default embedded LDAP; if using another LDAP server, use the LDAP server's tool
Start and stop components	Fusion Middleware Control
Start and stop applications	Fusion Middleware Control
View and manage log files	Fusion Middleware Control for most log files WebLogic Server Administration Console for the following logs: DOMAIN_HOME/servers/server_name/data/ldap/log/EmbeddedLDAP.log DOMAIN_HOME/servers/server_name/data/ldap/log/EmbeddedLDAPAccess.log
Change ports	Fusion Middleware Control or WebLogic Server Administration Console for Oracle WebLogic Server and Java components For some system components, Fusion Middleware Control. See the administration guide for the component.
Manage Oracle HTTP Server	Fusion Middleware Control
Create data sources	Fusion Middleware Control or WebLogic Server Administration Console
Create connection pools	Fusion Middleware Control or WebLogic Server Administration Console
Browse JNDI objects	Fusion Middleware Control or WebLogic Server Administration Console
Create JMS queues	Fusion Middleware Control or WebLogic Server Administration Console
Configure JMS advanced queuing	Fusion Middleware Control or WebLogic Server Administration Console
Configure JMS resources	Fusion Middleware Control or WebLogic Server Administration Console
Create and manage domain partitions	Fusion Middleware Control Note: WebLogic Server Multitenant domain partitions are deprecated in WebLogic Server 12.2.1.4.0 and will be removed in the next release.
Manage virtual targets	Fusion Middleware Control Note: WebLogic Server Multitenant virtual targets are deprecated in WebLogic Server 12.2.1.4.0 and will be removed in the next release.
Control resource sharing	Fusion Middleware Control
Create resource group templates and resource groups	Fusion Middleware Control Note: WebLogic Server Multitenant resource groups and resource group templates are deprecated in WebLogic Server 12.2.1.4.0 and will be removed in the next release.
Deploy SOA Composite applications	Fusion Middleware Control
Monitor SOA Composite applications	Fusion Middleware Control
Modify Oracle BPEL Process Manager MBean properties	Fusion Middleware Control
Debug applications such as Oracle BPEL Process Manager applications	Fusion Middleware Control
Deploy ADF applications	Fusion Middleware Control
Deploy Java EE applications	WebLogic Server Administration Console or Fusion Middleware Control
Administer Oracle WebCenter Portal	Fusion Middleware Control
Deploy Oracle WebCenter Portal applications	Fusion Middleware Control
Administer Oracle WebCenter Content	Fusion Middleware Control
Deploy Oracle WebCenter Content applications	Fusion Middleware Control
Administer Oracle WebCenter Sites	Fusion Middleware Control
Deploy Oracle WebCenter Sites applications	Fusion Middleware Control
Configure and manage auditing	Fusion Middleware Control
Configure SSL	WebLogic Server Administration Console for Oracle WebLogic Server Fusion Middleware Control. See Configuring SSL in Oracle Fusion Middleware.
Change passwords	Fusion Middleware Control or WebLogic Server Administration Console

Getting Started Using Oracle Enterprise Manager Fusion Middleware Control

Fusion Middleware Control is a Web browser-based, graphical user interface that you can use to monitor and administer your domain. It can manage an Oracle WebLogic Server domain with its Administration Server, one or more Managed Servers, clusters, the Oracle Fusion Middleware components that are installed, configured, and running in the domain, and the applications you deploy.

Fusion Middleware Control organizes a wide variety of performance data and administrative functions into distinct, Web-based home pages for the domain, servers, components, and applications. The Fusion Middleware Control home pages make it easy to locate the most important monitoring data and the most commonly used administrative functions—all from your Web browser.

• Displaying Fusion Middleware Control
  
• Using Fusion Middleware Control Help
  
• Navigating Within Fusion Middleware Control
  
• About Users and Roles for Fusion Middleware Control
  
• Locking the WebLogic Server Configuration
  
• Viewing and Managing the WebLogic Domain
  
• Viewing and Managing Java Components
  
• Viewing and Managing System Components
  

Displaying Fusion Middleware Control

To display Fusion Middleware Control, you enter the Fusion Middleware Control URL, which includes the name of the host and the administration port number assigned during the installation. The following shows the format of the URL:

http://hostname.domain:port/em

The port number is the port number of the Administration Server. By default, the port number is 7001. The port number is listed in the following file:

DOMAIN_HOME/config/config.xml

For some installation types, such as Web Tier, if you saved the installation information by clicking Save on the last installation screen, the URL for Fusion Middleware Control is included in the file that is written to disk (by default to your home directory). For other installation types, the information is displayed on the Create Domain screen of the Configuration Wizard when the configuration completes.

To display Fusion Middleware Control:

1. Enter the URL in your Web browser. For example:

   http://host1.example.com:7001/em
   

2. Enter the Oracle Fusion Middleware administrator user name and password and click Login.

Using Fusion Middleware Control Help

At any time while using the Fusion Middleware Control, you can select Help from the username menu at the top of the page to get more information. From the Help menu, you can select the following:

• Contents, which lists the contents of Help.

• Help for This Page, which provides context-sensitive help for the current page.

• How Do I?, which links to tutorial information in the documentation.

• Documentation Library, which links to the library on the Oracle Technology Network.

• User Forums, which links to Discussion Forums on the Oracle Technology Network.

• Oracle Technology Network, which links to the Oracle Technology Network.

Navigating Within Fusion Middleware Control

When you log into Fusion Middleware Control, it displays boxes showing the servers, clusters, and deployments on the left and the domain home page on the right, as shown in the following figure:

Description of the illustration domain_start.gif

To view the target navigation pane, click the target navigation icon near the left top corner. Fusion Middleware Control displays the target navigation pane on the left and the content pane on the right.

From the target navigation pane, you can expand the tree and select an Oracle WebLogic Server domain, an Oracle WebLogic Server Managed Server, a component, an application, or a Metadata Repository.

The following figure shows the target navigation pane, with the right-click context menu:

Description of the illustration target_nav.gif

If your domain contains partitions, Fusion Middleware Control shows the partitions in the navigation tree. However, if a partition is not fully configured with a virtual target and resource group, the partition will not be displayed in the navigation tree.

Note:

WebLogic Server Multitenant domain partitions, resource groups, resource group templates, and virtual targets are deprecated in WebLogic Server 12.2.1.4.0 and will be removed in the next release.

When you select a target, such as a Managed Server or a component, the target's home page is displayed in the content pane and that target's menu is displayed at the top of the page, in the context pane. For example, if you select a Managed Server, the WebLogic Server menu is displayed. You can also view the menu for a target by right-clicking the target in the navigation pane.

The following figure shows the home page of an Managed Server. Because a Managed Server was selected, the dynamic target menu listed in the context pane is the WebLogic Server menu.

Description of the illustration nav.gif

In the preceding figures, the following items are called out:

• Dynamic Target Menu provides a list of operations that you can perform on the currently selected target. The menu that is displayed depends on the target you select. The menu for a specific target contains the same operations as those in the Right-Click Target Menu.

• Change Center shows the changes made and allows you to lock and edit the configuration, release the configuration, activate changes, undo all changes, and change preferences. It also allows you to start and stop recording your session, and view the recording.

• WebLogic Domain Menu provides a list of operations that you can perform on the domain. The WebLogic Domain menu is always available.

• Target Name is the name of the currently selected target.

• Target Information Icon provides information about the target. For example, for a domain, it displays the target name, the version, and the domain home.

• Target Navigation icon expands to list all of the targets in the domain in a navigation tree.

• Context Pane provides the name of the target, the name of the current user, the host name, and the time of the last page refresh, as well as the Refresh icon.

• Content Pane shows the current page for the target. When you first select a target, that target's home page is displayed.

• The username menu provides links to Help, Accessibility, information about Fusion Middleware Control, and logging out.

• Refresh indicates when the page is being refreshed. Click it to refresh a page with new data. (Refreshing the browser window refreshes the page but does not retrieve new data.)

• Right-Click Target Menu, which you access from the target navigation pane, provides a list of operations that you can perform on the currently selected target. The menu is displayed when you right-click the target name in the target navigation pane. In the figure, even though the WebLogic Server is selected and its home page is displayed, the right-click target menu displays the operations for a metadata repository because the user has right-clicked the metadata repository.

  The menu for a specific target contains the same operations as those in the Dynamic Target Menu.

• View lets you expand or collapse the navigation tree.

In addition, from the home pages of targets such as the Administration Server or Managed Servers, you can access the WebLogic Server Administration Console.

Table 2-2 describes some common ways you can navigate within Fusion Middleware Control.

Table 2-2 Navigating Within Fusion Middleware Control

To:	Take This Action:
View all of the targets in the domain	From the View menu, select Expand All.
Operate on the domain	Select the WebLogic Domain menu, which is always available at the top right of Fusion Middleware Control.
Operate on a target	Right-click the target in the target navigation pane. The target menu is displayed. Alternatively, you can select the target and use the dynamic target menu in the context pane.
Return to the target's home page	Click the target name at the top left-hand corner of the context pane.
Refresh a page with new data	Click the Refresh icon in the top right of the context pane.
Return to a previous page	Click the breadcrumbs, which appear below the context pane. The breadcrumbs appear when you drill down in a target. For example, choose Logs from the WebLogic Server menu, then View Log Messages. Select a log file and click View Log File. The breadcrumbs show: Log Messages > Log Files > View Log File: logfile_name
View the host on which the target is running	Select the target in the target navigation pane and view the host name in the target's context pane. You can also view the host name by clicking the Target Information icon.
View a server log file	Right-click the server name in the target navigation pane. Choose Logs, and then View Log Messages to see a summary of log messages and to search log files.

About Users and Roles for Fusion Middleware Control

To access Fusion Middleware Control and perform tasks, you must have the appropriate role. Fusion Middleware Control uses the Oracle WebLogic Server security realm and the roles defined in that realm. If a user is not granted one of these roles, the user cannot access Fusion Middleware Control.

Each role defines the type of access a user has, as described in Table 2-3.

Table 2-3 Roles Supported by Fusion Middleware Control

Role	Actions Allowed
Administrator	All access. An administrator has full privileges, including creating and deleting instances and modifying the configuration. In a multitenancy environment, if the Administrator is logged into a partition, the Administrator can take actions only on the partition, as described in Administrative Roles for Configuration and Management in Using Oracle WebLogic Server Multitenant. Note: WebLogic Server Multitenant domain partitions are deprecated in WebLogic Server 12.2.1.4.0 and will be removed in the next release.
Deployer	Deploy, undeploy, and redeploy applications, modify the configuration of applications, start and stop applications, create and delete JDBC and JMS resources, and modify JDBC and JMS resources, as well as all of the privileges of the Monitor role.
Operator	Start and stop servers and applications, and all of the privileges of the Monitor role.
Monitor	View configuration, status of servers and applications, metrics, log files and log messages.

Table 2-4 summarizes the privileges of each role that is supported by Fusion Middleware Control.

Table 2-4 Privileges for the Supported Roles

Privileges	Administrator	Deployer	Operator	Monitor
Edit session operations: start or release session, activate or undo changes	Yes	Yes	No	No
Server, Cluster, Template, or Machine
Lifecyle operations: create, delete	Yes	No	No	No
Modify configuration	Yes	No	No	No
Control operations: start, stop, resume	Yes	No	Yes	No
View configuration	Yes	Yes	Yes	Yes
Application Deployments
Lifecycle operations: deploy, undeploy, redeploy	Yes	Yes	No	No
Modify configuration	Yes	Yes	No	No
Control operations: start, stop	Yes	Yes	Yes	No
JDBC and JMS resources
Lifecyle operations: create, delete	Yes	Yes	No	No
Modify configuration	Yes	Yes	No	No
Control operations: start, stop	Yes	No	No	No
View configuration	Yes	Yes	Yes	Yes
Startup and Shutdown Classes, Coherence Clusters
Lifecyle operations: create, delete	Yes	No	No	No
Modify configuration	Yes	Yes	No	No
View configuration	Yes	Yes	Yes	Yes

Note that the information in Table 2-4 is based on the default out-of-the-box security policy for WebLogic Resources and MBeans. You can manage the default security policies in the Administration Console, as described in Use Roles and Policies to Secure Resources in Oracle WebLogic Server Administration Console Online Help.

Understanding WebLogic Resource Security in Securing Resources Using Roles and Policies for Oracle WebLogic Server provides more information about resource security.

Locking the WebLogic Server Configuration

Before you make configuration changes, lock the domain configuration, so you can make changes to the configuration while preventing other accounts from making changes during your edit session. To lock the domain configuration from Fusion Middleware Control:

1. Locate the Change Center at the top of Fusion Middleware Control.
2. From the Changes menu, select Lock & Edit to lock the configuration edit hierarchy for the domain.

As you make configuration changes using the Administration Console, you click Save (or in some cases Finish) on the appropriate pages. This does not cause the changes to take effect immediately. The changes take effect when you click Activate Changes in the Change Center. At that point, the configuration changes are distributed to each of the servers in the domain. If the changes are acceptable to each of the servers, then they take effect. If any server cannot accept a change, then all of the changes are rolled back from all of the servers in the domain. The changes are left in a pending state; you can then either edit the pending changes to resolve the problem or revert to the previous configuration.

You can also lock the configuration by using the WLST command, startEdit:

startEdit()

For more information about the startEdit command and the stopEdit command, which releases locks, see startEdit and stopEdit in the WLST Command Reference for WebLogic Server.

Viewing and Managing the WebLogic Domain

When you log in to Fusion Middleware Control, the first page you see is the domain home page. You can also view this page at any time by selecting Home in the WebLogic Domain menu.

The following figure shows the domain home page:

Description of the illustration farmhome.gif

The WebLogic Domain menu is displayed at the top of the page. From this menu, you can monitor and configure the domain.

The WebLogic Domain menu is always displayed, even if you have selected other entities.

Viewing and Managing Java Components

From the target navigation pane, you can drill down to view and manage the Java components in your domain.

For example, to view and manage Oracle SOA Suite, take the following steps:

1. Expand the target navigation pane, then expand SOA.
2. Select the SOA soa_infra instance.

   The home page for the SOA instance is displayed, as shown in the following figure:

   
   Description of the illustration soa_home.gif
3. From the SOA Infrastructure menu, you can perform many administrative tasks, such as starting, stopping, and monitoring Oracle SOA Suite and deploying SOA composite applications.

Monitoring a System Component provides more information about monitoring components.

Viewing and Managing System Components

You can also view and manage system components. For example, to view and manage Oracle HTTP Server, take the following steps:

1. From the navigation pane, expand HTTP_Server.
2. Select the Oracle HTTP Server instance, for example, ohs1.

   The home page for the Oracle HTTP Server ohs1 is displayed, as shown in the following figure:

   
   Description of the illustration ohs_home.gif
3. From the HTTP Server menu, you can perform many administrative tasks, such as starting, stopping, and monitoring Oracle HTTP Server.

Monitoring a System Component provides more information about monitoring system components.

Getting Started Using Oracle WebLogic Server Administration Console

Oracle WebLogic Server Administration Console is a Web browser-based, graphical user interface that you use to manage an Oracle WebLogic Server domain. It is accessible from any supported Web browser with network access to the Administration Server.

Use the Administration Console to:

• Configure, start, and stop WebLogic Server instances

• Configure WebLogic Server clusters

• Configure WebLogic Server services, such as database connectivity (JDBC) and messaging (JMS)

• Configure security parameters, including creating and managing users, groups, and roles

• Configure and deploy Java EE applications

• Monitor server and application performance

• View server and domain log files

• View application deployment descriptors

• Edit selected run-time application deployment descriptor elements

To display the Administration Console:

1. Enter the following URL in a browser:

   http://hostname:port_number/console
   

   The port number is the port number of the Administration Server. By default, the port number is 7001.

   The login page is displayed.

2. Log in using the user name and password supplied during installation or another administrative user that you created.

   Oracle WebLogic Server Administration Console is displayed.

Alternatively, you can access the Administration Console from Fusion Middleware Control, from the WebLogic Server menu.

Getting Started Using the Oracle WebLogic Scripting Tool (WLST)

The Oracle WebLogic Scripting Tool (WLST) is a command-line scripting environment that you can use to create, manage, and monitor Oracle WebLogic Server domains. It is based on the Java scripting interpreter, Jython.

In addition to supporting standard Jython features such as local variables, conditional variables, and flow-control statements, WLST provides a set of scripting functions (commands) that are specific to WebLogic Server. You can extend the WebLogic scripting language to suit your needs by following the Jython language syntax

The following topics describe using WLST to manage Oracle Fusion Middleware components:

• Using WLST with Java Components and Oracle Fusion Middleware Services
  
• Using WLST Commands with System Components
  

Using WLST with Java Components and Oracle Fusion Middleware Services

You can use WLST commands with Java components, such as Oracle SOA Suite, Oracle Platform Security Services (OPSS), Oracle Fusion Middleware Audit Framework, and MDS, and services such as SSL, logging, and the diagnostic framework.

You can use WLST commands in the following ways:

• Interactively, on the command line

• In script mode, supplied in a file

• Embedded in Java code

The script is located at:

(UNIX) ORACLE_HOME/oracle_common/common/bin/wlst.sh
(Windows) ORACLE_HOME\oracle_common\common\bin\wlst.cmd

For example, to invoke WLST interactively, and connect to the WebLogic Server, use the following commands:

ORACLE_HOME/oracle_common/common/bin/wlst.sh
connect('username', 'password', 'localhost:7001')

To display information about WLST commands and variables, enter the help command. For example, to display a list of categories for online commands, enter the following:

wls:/base_domain/serverConfig>  help('online')
    help('activate')            Activate the changes.
    help('addListener')         Add a JMX listener to the specified MBean.
    help('adminHome')           Administration MBeanHome.
    help('cancelEdit')          Cancel an edit session.
    help('cd')                  Navigate the hierarchy of beans.
    help('cmo')                 Current Management Object.
 .
 .
 .

To monitor the status, you use the WLST state command, using the following format:

state(name, type)

For example to get the status of the Managed Server wls_server1, use the following command:

wls:/WLS_domain/serverConfig> state('wls_server1', 'Server')
Current state of 'wls_server1' : RUNNING

Introduction and Roadmap in the WLST Command Reference for WebLogic Server provides comprehensive information about WLST.

Using WLST Commands with System Components

You can use WLST commands with system components. The following component is a system component:

• Oracle HTTP Server

For system components, you can only the use the WLST commands listed in Table 2-5.

Table 2-5 WLST Commands for System Components

WLST Command	Description	Additional Information
create	Creates an instance of the system component with defaults.	The create command in WLST Command Reference for WebLogic Server
displayLogs	Displays the messages in a log file.	The displayLogs command in WLST Command Reference for Infrastructure Components and Viewing Log Files and Their Messages Using WLST
displayMetricTableNames	Displays the names of the DMS metric tables.	The displayMetricTableNames command in WLST Command Reference for Infrastructure Components
displayMetricTables	Displays the contents of the DMS metric tables.	The displayMetricTables command in WLST Command Reference for Infrastructure Components
dumpMetrics	Displays the available DMS metrics.	The dumpMetrics command in WLST Command Reference for Infrastructure Components
listLogs	Lists the log files.	The listLogs command in WLST Command Reference for Infrastructure Components and Viewing Log Files and Their Messages Using WLST
nmKill	Shuts down and instance.	The nmkill command in WLST Command Reference for WebLogic Server and Starting and Stopping System Components
nmServerStatus	Returns the status on an instance.	The nmServerStatus command in WLST Command Reference for WebLogic Server
nmStart	Starts an instance.	The nmStart command in WLST Command Reference for WebLogic Server and Starting and Stopping System Components
shutdown	Stops a system component instance.	The shutdown command in WLST Command Reference for WebLogic Server and Starting and Stopping System Components
start	Starts a system component instance.	The start command in WLST Command Reference for WebLogic Server and Starting and Stopping System Components
state	Returns the state of a system component instance.	The state command in WLST Command Reference for WebLogic Server and Getting Started Using the Oracle WebLogic Scripting Tool (WLST)
resync	Resynchronizes the configuration of a given system component instance in the domain.	The resync command in WLST Command Reference for WebLogic Server
resyncAll	Resynchronizes the configuration of all system component instances in the domain.	The resyncAll command in WLST Command Reference for WebLogic Server
showComponentChanges	Displays the changes made to a specified system component instance or to all system component instances in the domain.	The showComponentChanges command in WLST Command Reference for WebLogic Server
pullComponentChanges	Pulls the changes made to the configuration of a system component instance to the current edit session.	The pullComponentChanges command in WLST Command Reference for WebLogic Server

See WebLogic Server WLST Online and Offline Command Reference in the WLST Command Reference for WebLogic Server for information about whether a command can be invoked in online or offline mode.

To use these commands, you must invoke the WLST script from the Oracle common home. The script is located at:

(UNIX) ORACLE_HOME/oracle_common/common/bin/wlst.sh
(Windows) ORACLE_HOME\oracle_common\common\bin\wlst.cmd

To monitor the status of a system component, you use the WLST state command, using the following format:

state(component_name, SystemComponent)

In online mode, you can use the cmo variable to invoke MBean operations that provide even more functionality. Changing the Current Management Object in Understanding the WebLogic Scripting Tool describes the cmo variable.

Getting Started Using the Fusion Middleware Control MBean Browsers

A managed bean (MBean) is a Java object that represents a JMX manageable resource in a distributed environment, such as an application, a service, a component or a device.

The following topics describe MBeans and how to view or configure MBeans:

• About MBeans
  
• Using the System MBean Browser
  
• Using the MBeans for a Selected Application
  

About MBeans

MBeans are defined in the Java EE Management Specification (JSR-77), which is part of Java Management Extensions, or JMX, a set of specifications that allow standard interfaces to be created for managing applications in a Java EE environment. For information about JSR-77, see https://www.oracle.com/technetwork/es/java/javaee/tech/index.html.

You can create MBeans for deployment with an application into Oracle WebLogic Server, enabling the application or its components to be managed and monitored through Fusion Middleware Control.

Fusion Middleware Control provides a set of MBean browsers that allow to you browse the MBeans for an Oracle WebLogic Server or for a selected application. You can also perform specific monitoring and configuration tasks from the MBean browser.

The MBeans are organized into three groups: Configuration MBeans, Runtime MBeans, and Application-Defined MBeans.

Understanding WebLogic Server MBeans in Developing Custom Management Utilities Using JMX for Oracle WebLogic Server describes WebLogic MBeans.

Using the System MBean Browser

You can view the System MBean Browser for many entities, including an Oracle WebLogic Server domain, an Administration Server, a Managed Server, or an application. You can search for an MBean, filter the list of MBeans, and refresh the list of MBeans in the MBean navigation tree.

To view the System MBean Browser specific to a particular Oracle WebLogic Server Managed Server and to configure and use the MBeans:

1. From the target navigation pane, expand the domain.

2. From the domain home page, select the Managed Server.

3. From the WebLogic Server menu, choose System MBean Browser.

   The System MBean Browser page is displayed.

4. Expand a node in the MBean navigation tree and drill down to the MBean you want to access. Select an MBean instance.

   If you do not know the location of an MBean, you can search for the MBean:

   1. Click the Find icon at the top of the MBean navigation tree.

   2. For Find, select MBean Name.

      You can also select Attributes, Operations, or JMX syntax.

   3. Enter the name of the MBean and click the search icon.

5. To view the MBean's attributes, select the Attributes tab. Some attributes allow you to change their values. To do so, enter the value in the Value column.

6. To view the available operations, select the Operations tab. To perform an operation, click the operation. The Operations page appears. Enter any applicable values and click Invoke.

The Fusion Middleware Control online help provides additional information about the MBean browser.

Using the MBeans for a Selected Application

You can view, configure, and use the MBeans for a specific application by taking the steps described in Using the System MBean Browser, and drilling down to the application. As an alternative, you can navigate to an application's MBeans using the following steps:

1. From the target navigation pane, expand Application Deployments.
2. Select the application.
3. From the Application Deployments menu, choose System MBean Browser.

   The System MBean Browser page is displayed, along with the MBean information for the application.

4. To view the MBean's attributes, select the Attributes tab. Some attributes allow you to change their values. To do so, enter the value in the Value column.
5. To view the available operations, select the Operations tab. To perform an operation, click the operation. The Operations page appears. Enter any applicable values and click Invoke.

Changing the Administrative User Password

During the Oracle Fusion Middleware installation, you must specify a password for the administration account. Then, you can use this account to log in to Fusion Middleware Control and the Oracle WebLogic Server Administration Console for the first time. You can create additional administrative accounts using the WLST command line or the Oracle WebLogic Server Administration Console.

Understanding Users and Roles in the Securing Applications with Oracle Platform Security Services describes users, roles, and changing passwords.

You can change the password of the administrative user using the command line or the Oracle WebLogic Server Administration Console, as described in the following topics:

• Changing the Administrative User Password Using the Command Line
  
• Changing the Administrative User Password Using Fusion Middleware Control
  

Changing the Administrative User Password Using the Command Line

To change the administrative user password or other user passwords using the command line, you invoke the UserPasswordEditorMBean.changeUserPassword method, which is extended by the security realm's AuthenticationProvider MBean.

MBean Reference for Oracle WebLogic Server describes the changeUserPassword method.

Changing the Administrative User Password Using Fusion Middleware Control

To change the password of an administrative user using Fusion Middleware Control:

1. From the WebLogic Domain menu, select Security, then Security Realm.
2. Select the Users and Groups tab.

   The Users and Groups page is displayed.

3. Select the user.

   The Settings for user page is displayed.

4. Select the Passwords tab.
5. Enter the new password, then enter it again to confirm it.
6. Click Save.

Configuring Node Manager

Node Manager allows you to perform common operations, such as starting and stopping a Managed Server, using the Administration Console or Fusion Middleware Control.

This section describes the following topics:

• Configuring Node Manager to Start Managed Servers
  
• Configuring Node Manager to Use the OPSS Keystore Service
  

Configuring Node Manager to Start Managed Servers

If a Managed Server contains other Oracle Fusion Middleware products, such as Oracle JRF or Oracle SOA Suite, the Managed Servers environment must be configured to set the correct classpath and parameters. By default, Node Manager is configured when you install Oracle Fusion Middleware.

However, if you do not select automatic configuration, you must provide this environment information through the start scripts, such as startWebLogic and setDomainEnv, which are located in the following directory:

DOMAIN_HOME/bin

If the Managed Servers are started by Node Manager (as is the case when the servers are started by the Oracle WebLogic Server Administration Console or Fusion Middleware Control), Node Manager must be instructed to use these start scripts so that the server environments are correctly configured. Specifically, Node Manager must be started with the property StartScriptEnabled=true.

There are several ways to ensure that Node Manager starts with this property enabled. As a convenience, Oracle Fusion Middleware provides the following script, which adds the property StartScriptEnabled=true to the nodemanager.properties file:

(UNIX) ORACLE_HOME/oracle_common/common/bin/setNMProps.sh.
(Windows) ORACLE_HOME\oracle_common\common\bin\setNMProps.cmd

For example, on Linux, execute the setNMProps script and start Node Manager:

ORACLE_HOME/oracle_common/common/bin/setNMProps.sh
DOMAIN_HOME/bin/startNodeManager.sh

When you start Node Manager, it reads the nodemanager.properties file with the StartScriptEnabled=true property, and uses the start scripts when it subsequently starts Managed Servers. Note that you need to run the setNMProps script only once.

Also note that when the StartScriptEnable property is set to true, the Node Manager reads the startWebLogic script, which in turns reads the setDomainEnv script. As a result, you must make any tuning changes by editing the setDomainEnv script. Any changes that are performed using the command line or Administration Console will not be implemented when Node Manager starts the servers. For example, if you use the Administration Console to change the server start arguments, those changes are written to config.xml, but the Node Manager ignores these settings and uses those in setDomainEnv.

See Using Node Manager in the Administering Node Manager for Oracle WebLogic Server for other methods of configuring and starting Node Manager.

Configuring Node Manager to Use the OPSS Keystore Service

If you created a domain that included Oracle JRF and you configured Node Manager as "per domain", you can configure Node Manager to use the Oracle Platform Security Services Keystore Service. Take the following steps:

1. Configure the Keystore Service, as described in Keystore Management with the Keystore Service in Securing Applications with Oracle Platform Security Services.
2. Configure Node Manager by editing the following file:

   DOMAIN_HOME/nodemanager/nodemanager.properties
   

   In the file, specify the following properties:

   KeyStores=CustomIdentityAndDemoTrust
   CustomIdentityKeyStoreType=KSS
   CustomIdentityKeyStoreFileName=kss://system/keystore_name
   CustomIdentityKeyStorePassPhrase= keystore_passphrase
   CustomIdentityAlias= key store alias
   CustomIdentityPrivateKeyPassPhrase= keystore_private_key_passphrase
   

Oracle Platform Security Services Keystore Service is not supported for a "per host" Node Manager. In certain circumstances, however, a "per host" Node Manager will attempt to load the keystore service. To prevent that, you must specify UseKSSForDemo=false in the following file:

ORACLE_HOME/oracle_common/common/nodemanager/nodemanager.properties 

Note:

Oracle Platform Security Services adds the following arguments to the startNodeManager script, which triggers the use of the Keystore Service instead of a JKS -based keystore:

-Doracle.security.jps.config=DOMAIN_HOME/config/fmwconfig/jps-config-jse.xml
-Dcommon.components.home=MW_HOME/oracle_common
-Dopss.version=12.1.3

If you configure Node Manager to start WebLogic Server without the startWebLogic script (StartScriptEnabled=false), you must add these arguments to the server's ServerStartMBean Arguments field using and administration tool, such as WLST or the Administration console.

In addition, you must add the following to the CLASSPATH definition:

MW_HOME/oracle_common/modules/oracle.jps_12.1.3/jps-manifest.jar.

Basic Tasks for Configuring and Managing Oracle Fusion Middleware

There are several tasks you need to take to configure and manage a basic Oracle Fusion Middleware environment after you have installed the software.

The following provides a summary of the tasks you need to take to configure and manage Oracle Fusion Middleware:

1. Configure Oracle WebLogic Server and components, such as Oracle SOA Suite or Oracle HTTP Server. See Understanding Your Installation Starting Point in Planning an Installation of Oracle Fusion Middleware.

   For information about configuring Oracle WebLogic Server for multitenancy, see Configuring Domain Partitions in Using Oracle WebLogic Server Multitenant.

   Note:

   WebLogic Server Multitenant domain partitions are deprecated in WebLogic Server 12.2.1.4.0 and will be removed in the next release.

2. Configure Node Manager. See Configuring Node Manager.

3. Configure SSL. See Configuring SSL in Oracle Fusion Middleware.

4. Create and manage metadata repositories, including the MDS Repository. See Creating a Database-Based Metadata Repository.

5. Deploy an application. See Deploying Applications.

6. Configure load balancing. You can configure load balancing between different components or applications. See the Server Load Balancing in a High Availability Environment in the High Availability Guide.

7. Back up your environment. See Introduction to Backup and Recovery.

8. Monitor your environment and manage log files. See Monitoring Oracle Fusion Middleware and Managing Log Files and Diagnostic Data.

9. Expand your environment. See Scaling Up Your Environment.

This guide also describes other tasks that you may need to perform, depending on your Oracle Fusion Middleware environment.

Note:

The procedures in this book for the most part assume that you are using the standard installation topology, which consists of a domain that contains an Administration Server and a cluster containing two Managed Servers.

The standard topology is described in Understanding the Oracle Fusion Middleware Infrastructure Standard Installation Topology in Installing and Configuring the Oracle Fusion Middleware Infrastructure.