Administration Console Online Help
The System Administration Console is a Web browser-based, graphical user interface you use to manage a WebLogic Server domain. A WebLogic Server domain is a logically related group of WebLogic Server resources that you manage as a unit. A domain includes one or more WebLogic Servers and may also include WebLogic Server clusters. Clusters are groups of WebLogic Servers that work together to provide scalability and high-availability for applications. You deploy and manage your applications as part of a domain.
One instance of WebLogic Server in each domain is configured as an Administration Server. The Administration Server provides a central point for managing a WebLogic Server domain. All other WebLogic Server instances in a domain are called Managed Servers. In a domain with only a single WebLogic Server instance, that server functions both as Administration Server and Managed Server. The Administration Server hosts the Administration Console, which is a Web Application accessible from any supported Web browser with network access to the Administration Server.
For more information on WebLogic Server domains, see Overview of WebLogic System Administration.
The Administration Console uses the Java Management Extension (JMX) API as its underlying architecture. The JMX API models system administration functions using Java objects called MBeans. Each MBean contains a set of
attributes that define parameters for various management functions and operations that define administrative actions. The Administration Console allows you to access these MBean attributes and operations using a convenient graphical user interface. The Administration Server persists the values of MBean attributes in a domain-wide configuration file called
config.xml. (Some security attributes, however, are persisted in other files.)
You can also perform nearly all of the management tasks that you perform using the Adminstration Console using the WebLogic Server command-line interface. The command-line interface is useful for scripting of WebLogic Server system administration operations or for system administrators who prefer to use a command-line environment. For more information, see the WebLogic Server Command Reference.
Additional documentation on WebLogic Server system administration is available on BEA's e-docs Web site. For a list of these documents, see System Administration.
hostname is the DNS name or IP address of the Administration Server and
port is the address of the port on which the Administration Server is listening for requests (7001 by default). If you start the Administration Server using Secure Socket Layer (SSL), you must add
http as follows:
For more information about setting up SSL for system administration, see Servers-->Configuration-->Keystores and SSL.
Note: If your Web browser is configured to send HTTP requests to a proxy server, you may need to configure your browser so that it does not send Administration Server HTTP requests to the proxy. If the Administration Server is running on the same machine as your Web browser, configure your browser so that requests sent to
localhost or IP address
127.0.0.1 are not sent to the proxy server.
The WebLogic Server Administration Console allows users to edit configurations or to perform other operations based on the default global security role they are granted. If this security role does not permit editing of configuration data, for example, the data is displayed in the Administration Console but is not editable. If the user attempts to perform a control operation that is not permitted, such as starting or stopping servers, the Administration Console displays an Access Denied error.
In this release of WebLogic Server, users granted the
Admin default global role can perform any function using the Administration Console. The other default global roles (
Operator) primarily have read-only permissions, except for functions specific to their security role. Table 1-1 lists the default global roles and describes the view of the Administration Console for users granted these security roles.
Additionally, users in the
Note: Deployable objects include applications, Web application modules, EJB modules, Connector modules, JDBC connection pools, JDBC data sources, JDBC MultiPools, JDBC data source factories, JMS servers, and WTC Services. Applications to not have Clone icons.
For more information on using security roles to control access to the Administration Console, see "Security Roles" in Securing WebLogic Resources.
To add or modify users see Defining Users.
The left panel in the Administration Console contains a navigation tree that you use to navigate to the console pages you use to manage your domain. By selecting (left-clicking) a node in the tree, you can access console pages related to the node, which are displayed in the right panel of the console. If a node in the tree is preceded by a plus sign, you can click on the plus sign to expand the tree to access additional resources.
By right-clicking on a node, you can also access a variety of operations such as viewing log files, viewing the JNDI tree, creating security policies, viewing monitoring data, creating, deleting or cloning configuration objects, and opening the configuration page in a new window.
Once you select a node from the navigation tree, a list of objects that you can configure appears as branches of the node and as a tabular list displayed in the right panel of the console. To select an object, click the branch for the object you want to configure or click its link in the table in the right panel.
After you select the object, you will see a tabbed interface in the right panel. Clicking on a tab (Some tabs also contain sub-tabs.) displays a console page containing configuration attributes, controls for administrative operations, or displays you use to monitor the current state of the object.
You change configuration data by editing the attribute fields displayed in the right panel. After you make your changes, click the Apply button. Changing some attributes requires that you restart one or more WebLogic Server instances. These attributes are marked with the icon.
Some attributes are displayed in a light grey color and are not editable. These attributes may or may not be editable depending on the value of another attribute. For example, on the Servers --> Configuration --> General tab, the attribute called SSL listen Port is only editable if the SSL Listen Port Enabled box is checked.
Some console screens contain a section labeled Advanced Options. Click the [Show] link to display the Advanced Options section, or click the [Hide] link if you do not want to see the Advanced Options. Advanced options contain seldom used attributes that usually do not require editing.
The Administration Console home page is the first page displayed in the right panel when you log into the Administration Console. You can always display this page by clicking the icon in the banner area of the console. From this page you can navigate to configuration and monitoring pages you use to manage your domain. (You can also use the Navigation Tree to access these pages.)
Cloning an object allows you to create an identical object with a new name. This feature can be useful when you need to create many objects, such as server instances, with identical configurations. Note that each new cloned object may require additional editing after cloning.
To monitor a domain resource either right click on the resource in the navigation tree and select a monitoring option, or navigate to the resource and select the monitoring tab from the right panel. The data displayed represents the current state of the resource. To update the information click the icon in the upper right section of the screen. The data will refresh regularly until you click the icon again. The icon displays a circular animation to that the Administration Server is working to refresh the data. By default, the data refreshes every 10 seconds, or you can specify the refresh interval. See Changing the Monitoring Interval.
Note: The value of the Auto-refresh every field is not persisted in the domain's configuration file (
config.xml). It is, however, persisted as a browser cookie. If you access the Administration Console using the same computer and Web browser, this setting is retained.
If you have a Japanese or English language version of WebLogic Server, you can change the default language used in the Administration Console and the online help. Normally, the console uses your browser's language settings to determine which language to display, and you do not need to change this setting. To change the default language:
When the data displayed in the right panel is a table of data listing objects of a particular type, you can customize the table by adding or subtracting columns. You can also sort the data tables by clicking on the column headers.
Documentation on how to use the Administration Console is included with the console application. To get help about an Administration Console screen, click the help icon in the upper right corner of the console, as shown in Figure 6-4.
When you click the help link, a new browser window opens containing help for the Adminstration Console. The text displayed in the right frame of the help window describes the functionality of the console screen you are using and contains links to related tasks.
For list of general topics, click the Topic List button and select a topic from the list displayed. The text of that topic appears in the right frame and a table of contents containing links to headings under that topic appears in the left frame.
The console, by default, displays descriptive text for each configuration attribute or control. You can choose whether or not to display this text. For more information, see Changing Administration Console Behavior. You can access additional information, such as default and allowable values for each attribute by clicking the Attributes link at the top of the right frame in the help window, as shown in Figure 6-5.
Additional documentation is also available on the BEA e-docs Web site. Many help screen include links to related topics on the e-docs Web site. These links are preceded with the label (e-docs). An Internet connection is necessary to view this documentation.