Skip navigation.
Downloads | Product Documentation | Support

Installation Guide

# Post-Installation Tasks

This chapter describes tasks you can perform following installation of BEA Liquid Data for WebLogic, including verifying the installation, starting development of applications, and exploring Windows shortcuts and UNIX paths. The chapter also describes how to uninstall Liquid Data, if required.

The chapter includes the following sections:

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

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 Liquid Data, 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 Liquid Data sample domain using the Windows Start menu:

>     Start —> All Programs —> BEA WebLogic Platform 8.1 —> BEA WebLogic LiquidData 8.5 —> 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 Liquid Data 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 Liquid Data Windows Shortcuts and UNIX Paths

When installing Liquid Data 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 Liquid Data. BEA Liquid Data then appears in the Start menu as follows:

>     Start —> Programs —> BEA WebLogic Platform 8.1 —>
>     Liquid Data for WebLogic 8.5

The Liquid Data folder contains the following shortcuts:

Table 4-1 Liquid Data Shortcuts and Paths

Item | Description
Examples`` —>`` RTL Demo`` —>`` Launch RTL Demo Sample Server | Starts the Liquid Data RTL Demo server by running the `startWebLogic.cmd` command in the following domain: <WL_HOME>/samples/domains/ldplatform/
Examples`` —>`` Other Sample`` —>`` Launch Other Demo Sample Server | Starts the Liquid Data Other Demo server by running the `startWebLogic.cmd` command in the following domain: <WL_HOME>/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 Liquid Data server that is currently running.
Examples`` —>`` RTL Demo`` —>`` Liquid Data Console | Starts the Liquid Data Administration Console.
Online Documentation | Launches the Liquid Data online documentation in your default Web browser. The path to the Liquid Data documentation is: http://download.oracle.com/docs/cd/E13190_01/liquiddata/docs85/index.html
Uninstall WebLogic Liquid Data 8.5 | Uninstalls the Liquid Data software. After a full installation, you may need to manually remove some of the sample files that have been placed in: `<WL_HOME>/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 Liquid Data 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 Liquid Data-enabled Workshop application, see the Client Application Developer's Guide.

# Uninstalling Liquid Data

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

You should also undeploy any Liquid Data applications before uninstalling Liquid Data 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 Liquid Data should not contain any files from a previously installed version of Liquid Data.

To uninstall Liquid Data:

1. Run the Liquid Data uninstaller application.

- On Windows, choose the following:

`Start` —>`Programs` —>`BEA WebLogic Platform 8.1` —>`Liquid Data for WebLogic 8.5` —>`Uninstall WebLogic Liquid Data 8.5`

Alternatively, run the following command:

`<WL_HOME>\`<LD_HOME>`\uninstall\uninstall.cmd`

- On UNIX, run the following command in cases when you installed using GUI mode (as described in Installing Liquid Data 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 Liquid Data 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 Liquid Data was installed.

For example if you added new target schemas, stored queries, Web services, and so on to the Liquid Data 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
Liquid Data home directory | Windows | `<WL_HOME>\`<LD_HOME>
UNIX | `<WL_HOME>/`<LD_HOME>
Liquid Data samples directory | Windows | `<WL_HOME>\samples\LiquidData`
UNIX | `<WL_HOME>/`<LD_HOME>`/samples/liquiddata`
Liquid Data samples domain directory | Windows | `<WL_HOME>\`<LD_HOME>`\samples\domains\ liquiddata`
UNIX | `<WL_HOME>/`<LD_HOME>`/samples/domains/ liquiddata`