Skip navigation.
Downloads | Product Documentation | Support

Installation Guide

# Post-Installation Tasks

This chapter describes tasks you can after installation of an instance of Data Services Platform (DSP), including verifying the installation, starting development of applications, and exploring Windows shortcuts and UNIX paths. The chapter also describes how to uninstall DSP, if required.

The chapter includes the following sections:

- Verifying the Installation
- Starting the Development of a Data Integration Solution
- Exploring DSP Windows Shortcuts and UNIX Paths
- Uninstalling Data Services Platform

Figure 4-1 illustrates the current step in the overall installation process.

Figure 4-1 Post-Installation Step

# Verifying the Installation

After you have installed DSP, you can verify that the installation was successful by building the RTLApp sample application and testing a page flow using WebLogic Workshop.

To verify the installation:

1. Start the DSP sample domain using the Windows Start menu:

>     Start —> All Programs —> BEA WebLogic Platform 8.1 —> BEA AquaLogic Data Services Platform 2.0.1 —> Examples —> RTL Demo —> Launch RTL Demo Sample Server

Note: You can go on to Step 2 while the sample domain server is starting.

2. Open WebLogic Workshop and the RTLApp by executing the `RTLApp.work` file located in the following directory:

>     <WL_HOME>/samples/liquiddata/RTLApp/RTLApp.work

3. Build the RTLApp.

Right-click RTLApp in the navigation tree, and choose Build Application from the context-sensitive menu. WebLogic Workshop displays the status of the build. Confirm that the build was successful, as indicated by the build status messages.

4. Start a page flow.
5. Double-click on the Java page flow file `demoPageFlowController.jpf`. It is located in the following folder:

>     RTLSelfService\Pages

6. With the page flow diagram in your work area choose the Start option from the Workshop Debug menu.

>     Debug —> Start

The appearance of a login page in the Workshop Test Browser, as illustrated in Figure 4-2, indicates that DSP is correctly installed and running.

Figure 4-2 Login Page in the Workshop Test Browser

For an overview of the Retail Sample Application (RTLApp), including a description of data sources, queries, and other application components, see Sample Retail Application Overview.

# Exploring DSP Windows Shortcuts and UNIX Paths

When installing DSP on a Windows system, the installer program uses the BEA WebLogic Platform home directory (`<WL_HOME>`) as the parent folder for WebLogic Server and BEA DSP. It then appears in the Start menu as follows:

>     Start —> Programs —> BEA WebLogic Platform 8.1 —>
>       BEA AquaLogic Data Services Platform 2.0

The DSP folder contains the following shortcuts:

Table 4-1 DSP Shortcuts and Paths

Item | Description
Examples`` —>`` RTL Demo`` —>`` Launch RTL Demo Sample Server | Starts the RTL Demo server by running the `startWebLogic.cmd` command in the following domain: <BEA_HOME>/weblogic81/samples/domains/ldplatform/
Examples`` —>`` Other Sample`` —>`` Launch Other Demo Sample Server | Starts the DSP Other Demo server by running the `startWebLogic.cmd` command in the following domain: <BEA_HOME>/weblogic81//samples/domains/ldplatform/
Examples`` —>`` RTL Demo`` —>`` PointBase Console | Launches the PointBase database console. In order to access the console, you need to enter the Samples URL, such as: `jdbc:pointbase:server://localhost:9093/workshop` You can determine the URL in use through the WebLogic Administration Console. In the Console select Service`` —>`` JDBC`` —>`` Connection Pools. All the pools use the same URL. The default user and password are both `PBPUBLIC`. For additional information see How Do I: Administer the Default PointBase Database in WebLogic Workshop documentation.
Examples`` —>`` RTL Demo`` —>`` WebLogic Server Console | Starts the WebLogic Administration Console for the DSP server that is currently running.
Examples`` —>`` RTL Demo`` —>`` DSP Console | Starts the DSP Console.
Online Documentation | Launches the DSP online documentation in your default Web browser. The path to Data Services Platform documentation is: http://e-docs.bea.com/aldsp/docs20/index.html
> Uninstall Data Services Platform 2.01 | Uninstalls Data Services Platform. After a full installation, you may need to manually remove some of the sample files that have been placed in:
>     <BEA_HOME>/weblogic81/samples/domains/liquiddata/

# Starting the Development of a Data Integration Solution

Developing your own data integration solution consists of a design phase and an implementation phase.

- When you are ready to start setting up and configuring your own data sources, refer to the Data Services Platform Administration Guide.
- When you are ready to start mapping source and target XML schemas and constructing queries using WebLogic Workshop, refer to Data Services Developer's Guide.
- When you are ready to create an application such as a Data Services Platform-enabled Workshop application, see the Client Application Developer's Guide.

# Uninstalling Data Services Platform

You can remove DSP from your system using an uninstaller application. Once DSP has been removed, you can manually remove any extra files, such as modified samples or other user-created files, that were not removed automatically by the uninstaller.

You should also undeploy any DSP applications before uninstalling DSP from your system. For information about undeploying, see the topic Undeploying Deployed Applications in the WebLogic Server documentation.

Note: The `<WL_HOME>` directory into which you plan to install a new version of DSP should not contain any files from a previously installed version of DSP.

To uninstall Data Services Platform:

1. Run the DSP uninstaller application.

- On Windows, choose the following:

>     Start —> Programs —> BEA WebLogic Platform 8.1 —> BEA AquaLogic Data Services Platform 2.0.1 —> Uninstall BEA AquaLogic Data Services Platform 2.0.1

- On UNIX, run the following command in cases when you installed using GUI mode (as described in Installing Data Services Platform Using GUI Mode):

`<WL_HOME>``/`<LD_HOME>`/uninstall/uninstall`

Alternatively, run the following command with the "-i CONSOLE" option in cases when you installed using Console mode (as described in Installing Data Services Platform Using Console or Silent Mode)

`<WL_HOME>``/`<LD_HOME>`/uninstall/uninstall -i CONSOLE`

When the uninstall is complete, you may be notified that some files could not be removed by the automated uninstall. This could be a result of new files that were either generated or user-created after DSP was installed.

For example if you added new target schemas, stored queries, Web services, and so on to the DSP repository, the uninstaller will not remove these files. If you need these files, be sure to save them elsewhere before proceeding to the next step.

2. Remove remaining files, as appropriate.

You can manually delete remaining files by removing the directories specified in Table 4-2.

Table 4-2 Directories to Remove Manually Following an Uninstall

Directory | Platform | Location
DSP home directory | Windows | <WL_HOME>\<LD_HOME>
UNIX | <WL_HOME>/<LD_HOME>
DSP samples directory | Windows | `<WL_HOME>``\samples\LiquidData`
UNIX | `<WL_HOME>``/`<LD_HOME>`/samples/liquiddata`
DSP samples domain directory | Windows | `<WL_HOME>``\`<LD_HOME>`\samples\domains\ liquiddata`
UNIX | `<WL_HOME>``/`<LD_HOME>`/samples/domains/ liquiddata`