Administration Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Getting Started with ALDSP Administration

With ALDSP 3.0 release, you need to create and configure WebLogic Server 9.2.x unlike the previous ALDSP releases, which used WebLogic Server 8.1. Before you start working with ALDSP development environment, you need to deploy your dataspace project on a WebLogic domain enabled for ALDSP. Using WebLogic Server 9.2.x, you can create users and groups for ALDSP and manage their permissions.

Most of the other administrations tasks for ALDSP 3.0, can be performed through the ALDSP Administration Console and therefore you may not need to launch the WLS Administration console frequently. Table 2-1 lists the tasks that you can perform using ALDSP Administration Console and the ones that you need to perform using WebLogic Server Administration console.

Table 2-1 Administration Tasks for ALDSP Administration Console and WLS Administration Console
Administered Through
ALDSP Users and Groups: Securing ALDSP Resources
WebLogic Server Administration Console
ALDSP Administration Console
ALDSP Administration Console
ALDSP Administration Console
ALDSP Administration Console

For more information about creating and configuring a new server for ALDSP, refer to Post-Installation Tasks in AquaLogic Data Services Platform Installation Guide:

This chapter describes the tasks that you can perform using ALDSP Console and also provides steps to start and stop the WebLogic Server. It contains the following sections:


Updating the ALDSP License

ALDSP requires a valid product license to run. The ALDSP license is included as a component in the WebLogic Server license file, license.bea. To apply or update an ALDSP license file, use the BEA UpdateLicense utility to update the license.bea file.

For details about BEA product licensing, see Installing and Updating WebLogic Platform License Files in Installing WebLogic Platform of the WebLogic Server documentation.


Starting and Stopping WebLogic Server

To start working with the ALDSP development environment and to administer the WLS enabled for ALDSP, you must first start WebLogic Server. Although you may not need to stop WebLogic Server frequently, it may be required in certain situations. This section describes how to start and stop WebLogic Server (WLS) in a standalone WebLogic domain, after you have configured your WebLogic Server 9.2.x.

Note: If you are already running an instance of WebLogic Server that uses the same listener port as the one to be used by the server you are starting, you must stop the first server before starting the second server.

Starting the Server

  1. At the command prompt, navigate to the domain directory.
  2. The domain directory is BEA_HOME/user_projects/domain_name. An example could be c:\bea\user_projects\domains\mydomain.

  3. Run the server startup script: startWebLogic.cmd (Windows) or (UNIX).
  4. The startup script displays a series of messages, finally displaying a message similar to the following:

    <Dec 8, 2004 3:50:42 PM PDT> <Notice> <WebLogicServer> <000360> <Server started in RUNNING mode>

You can also start WebLogic Server through the eclipse-based IDE for ALDSP. To start the server:

  1. Open the IDE and click the Servers tab.
  2. Right-click the server that you have configured and select Start, as shown in Figure 2-1. If you want run the server in debug-mode then select Debug. This starts WebLogic Server.
  3. Figure 2-1 ALDSP IDE: Starting WebLogic Server
    Workspace Content Area

Stopping the Server

To stop the WebLogic Server using the eclipse-based IDE, right-click the server listed in the Servers tab, as shown in Figure 2-1 and select Stop.

Alternatively, you can stop a WebLogic Server instance that is running a dataspace project from the WebLogic Administration Console.

  1. Start the WebLogic Server Administration Console.
  2. Acquire the lock by clicking Lock & Edit.
  3. In the left pane, click to expand Environment and select Servers.
  4. Select the server instance you need to stop.
  5. Click the Control tab. The Start/Stop tab is displayed, as illustrated in Figure 2-2.
  6. Figure 2-2 Graceful Shutdown of a Server

    Graceful Shutdown of a Server

  7. Specify the graceful shutdown timeout limit incase you need to do a force shutdown after some time.
  8. From Server Status table, click the Shutdown list.
  9. Select the When work completes option.
  10. Select Yes to confirm shutdown. This shuts down the selected server after all the pending tasks are completed.


Launching ALDSP Administration Console

The AquaLogic Data Services Platform Administration Console is a web-based interface that enables you to administer and manage dataspace projects, access metadata, and configure security and caching policies.

Before you launch the ALDSP Administration Console, make sure that the WebLogic Server is started. For more information about starting WebLogic Server, see Starting the Server on page 2-3. To launch ALDSP Administration Console:

  1. Open the following URL:
  2. http://hostname:port/dspconsole


    • hostname is the machine name or IP address of the host server
    • port is the address of the port on which the host server is listening for requests (7001 by default)
    • For example, to start the ALDSP Administration Console on a local instance of WebLogic Server (running on your computer), navigate to the following URL:

  3. When the login page appears, enter the appropriate user name and password.
  4. The default user name and password is weblogic/weblogic, respectively.

Note: The discussion and examples in the following chapters of this book (Administration Guide) assume that you have:

In case you need to launch the WLS Administration console, click the WLS Console link on the top-right corner of ALDSP Administration Console, as shown in Figure 2-3.

Figure 2-3 WLS Console Link in ALDSP Console
Note: For more information about starting the WebLogic Administration Console, refer to Starting the Administration Console section in Introduction to WebLogic Server and WebLogic Express.


Exploring ALDSP Administration Console

This section provides details about using different components of the ALDSP administration console. It includes the following topics:

Using the Navigation Pane

You can use the navigation pane to view the navigation tree and all the data services, functions, and web services. The change center allows you lock and edit the configuration settings within the console and then save or discard changes depending on your requirement. Using the category-based tabs from the category list, you can view and manage the artifacts related to each tab, including the system administration tasks such as deployment of data services, importing and exporting data service JAR files, and auditing.You can also view metadata, manage caching, and configure security settings using the category-list.

Figure 2-4 displays the components of the navigation pane.

Figure 2-4 Navigation Pane

Navigation Pane

This section describes the functions of some of the components of the navigation pane in detail.

Change Center and Configuration Locking

The change center feature in ALDSP Administration console is similar to the WLS Administration console. It enables you to acquire a global lock over the console configuration, make one or more changes to the configuration, if required, and then activate or discard the changes. The configuration settings are edited in a transactional manner, therefore, only one user can acquire the lock to the console.

To acquire the lock and then activate or discard changes:

  1. Click Lock & Edit option from the change center. This enables you to make changes to the workspace.
  2. Save the changes in the Workspace Content Area by clicking Save. The message “Settings updated successfully” is displayed in the workspace content area.
  3. From the change center area, click Activate Changes or Undo All Changes, as shown in Figure 2-5, to activate or discard the changes. If you click Activate Changes, then the message “Changes activated successfully“ is displayed in the workspace content area and if you select Undo All Changes, then the “Changes discarded successfully” message is displayed.
  4. Figure 2-5 Activating/Deactivating Configuration Changes

    Activating/Deactivating Configuration Changes

The change center feature is available only to the domain and admin entitlements for a resource configured for security in ALDSP. Other ALDSP entitlements cannot use the change center. For more information about user entitlements, refer to the Administrative Access Control section in Securing ALDSP Resources.

You do not need to acquire a lock to edit the configuration within the administration console in the following cases:

Based on the operations performed using the change center, the change center behavior may differ. Table 2-2 lists and describes the change center behavior in different situations:

Table 2-2 Change Center Behavior
User does not have domain or admin entitlements for any of the ALDSP resources such as a dataspace or data service.
User is denied access and the change center is disabled.
Lock has not been acquired by any one and can be acquired by the logged in user.
The user can acquire the lock to the change center and perform configuration changes.
Lock has been acquired by the logged in user and changes are made.
The change center provides the option to activate or discard changes. So, the Activate Changes and Undo All Changes options appear in the change center area.
Lock has been acquired by some other user but the logged in user being a domain user is allowed to forcibly acquire the lock.
The change center displays the Take Lock && Edit option if the user has domain entitlements for the dataspace.

For more information about using the change center, you can also refer to:

Pending Changelist

The pending change list displays the difference between the current session values and the core values. The dataspace artifacts that are created, updated, or deleted are displayed in the pending changelist. Pending changes are shown in the tree view, as shown in Figure 2-6, whereas the configuration changes are shown in the leaf node.

Figure 2-6 Pending Changelist

Pending Changelist

Navigation Tree and Category List

There are six categories in the ALDSP administration console. The artifacts displayed in the workspace content area for a data service, function, or web service depend on the category-based tab that you select from the category list.

The following list describes the function of each category tab:

Using the Workspace Content Area

The workspace content area displays artifacts based on the tab selected in the category list and the node selected from the navigation tree. It consists of various options that enable you to view, search, configure, and audit ALDSP resources. Figure 2-7 displays the workspace content area that is displayed when you log in to the console.

Figure 2-7 Workspace Content Area

Workspace Content Area

As illustrated in this figure, the workspace content area constitutes the following:

  Back to Top       Previous  Next