> Installation Guide > Post-Installation Tasks

Installation Guide

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

Post-Installation Tasks

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

The chapter includes the following sections:

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

Figure 4-1 Post-Installation Step

Post-Installation Step

 

Verifying the Installation

After you have installed AquaLogic Data Services Platform, 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 AquaLogic Data Services Platform sample domain using the Windows Start menu:
    2. Start Arrow symbol All Programs Arrow symbol BEA WebLogic Platform 8.1 Arrow symbol BEA AquaLogic Data Services Platform 2.5 Arrow symbol Examples Arrow symbol RTL Demo Arrow symbol 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:
    3. <WL_HOME>/samples/liquiddata/RTLApp/RTLApp.work
  3. Build the RTLApp.

    4. 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. Double-click on the Java page flow file demoPageFlowController.jpf. It is located in the following folder:
    5. RTLSelfService\Pages
  5. With the page flow diagram in your work area choose the Start option from the Workshop Debug menu.
    6. Debug Arrow symbol Start

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

    Figure 4-2 Login Page in the Workshop Test Browser


    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 AquaLogic Data Services Platform Windows Shortcuts and UNIX Paths

When installing AquaLogic Data Services Platform 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 AquaLogic Data Services Platform. It then appears in the Start menu as follows: 

Start Arrow symbol Programs Arrow symbol BEA WebLogic Platform 8.1 Arrow symbol 
  BEA AquaLogic Data Services Platform 8.1

The AquaLogic Data Services Platform folder contains the following shortcuts:

Table 4-1 AquaLogic Data Services Platform Shortcuts and File Paths  
Item
Description
Examples Arrow symbol RTL Demo Arrow symbol 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 Arrow symbol RTL Demo Arrow symbol 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 Arrow symbol JDBC Arrow symbol 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 Arrow symbol RTL Demo Arrow symbol WebLogic Server Console
Starts the WebLogic Administration Console for the AquaLogic Data Services Platform server that is currently running.
Examples Arrow symbol RTL Demo Arrow symbol AquaLogic Data Services Platform Console
Starts the AquaLogic Data Services Console.
Online Documentation
Launches the AquaLogic Data Services Platform online documentation in your default Web browser. The path to AquaLogic Data Services Platform documentation is:

http://download.oracle.com/docs/cd/E13167_01/aldsp/docs25/index.html
Uninstall AquaLogic Data Services Platform
Uninstalls AquaLogic 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.

 

Uninstalling AquaLogic Data Services Platform

For most platforms you can automatically remove system-installed, unmodified AquaLogic Data Services Platform artifacts from your system. Once AquaLogic Data Services Platform has been uninstalled, you can manually remove any extra files, such as modified samples or other user-created files, which were not removed automatically by the uninstaller.

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

Note: If you are planning to reinstall a version of AquaLogic Data Services Platform into the same <WL_HOME> directory from which you uninstalled the product (a current or previous version thereof), make sure that all files associated with the prior installation have been removed.

Automated Uninstallation

To uninstall AquaLogic Data Services Platform:

  1. Back-up any data you want to retain for use with a new installation.
  2. Shut down your server.
  3. Run the AquaLogic Data Services Platform uninstaller.
  4. Remove any remaining files, as appropriate, from directories listed in Table 4-2.
    Table 4-2 Directories Requiring Manual Removal Following an Uninstall
    Directory
    Platform
    Location
    AquaLogic Data Services Platform home directory
    Windows
    <WL_HOME>\liquiddata
    UNIX
    <WL_HOME>/liquiddata
    AquaLogic Data Services Platform samples directory
    Windows
    <WL_HOME>\samples\LiquidData
    UNIX
    <WL_HOME>/liquiddata/samples/liquiddata
    AquaLogic Data Services Platform samples domain directory
    Windows
    <WL_HOME>\liquiddata\samples\domains\
    liquiddata
    UNIX
    <WL_HOME>/liquiddata/samples/domains/
    liquiddata
    AquaLogic Data Services Platform sample server-only domain directory
    Windows
    <WL_HOME>\liquiddata\samples\domains\
    ldplatform
    UNIX
    <WL_HOME>/liquiddata/samples/domains/
    ldplatform

    5. When the uninstall is completed, you may be notified that some files could not be removed. This could be a result of new files that were either generated or user-created after AquaLogic Data Services Platform was installed.

    For example, if you added new target schemas, stored queries, Web services, and so on to the AquaLogic Data Services Platform 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.

    Note: The Uninstall option does not remove any AquaLogic Data Services Platform or other Workshop applications that you have created.

Manual Uninstallation

An automatic installation will not remove all AquaLogic Data Services Platform artifacts, particularly those which have been modified. You can follow the steps in this section to manually remove the product.

Note: For some platforms such as Linux, it is necessary to perform a manual uninstallation since no automated uninstallation is provided.

To manually remove an installation of AquaLogic Data Services Platform follow these steps:

  1. Back-up any data you want to retain for use with a new installation.
  2. If running, shut down your server.
  3. Delete all the AquaLogic Data Services Platform binaries and other artifacts found under your:

    4. <BEA_HOME>/<WL_HOME>

    directory. These directories are listed in Table 4-2.

  4. Open the following file with a text editor:
    5. <BEA_HOME>/registry.xml
  5. Locate the entry for AquaLogic Data Services Platform. Here is an example:
    6. <product format="1.0" name="AquaLogic Data Services Platform">
    <release level="2.5" ServicePackLevel="0" PatchLevel="0" Status="installed" BeaProgramGroup="BEA AquaLogic Data Services Platform 2.5" StartMenu="C:\Documents and Settings\tkatz.AMER\Start Menu\Programs" InstallTime="Aug 9, 2006 1:25:29 PM" InstallDir="d:\bea\weblogic81\liquiddata" JavaHome="d:\bea\jrockit81sp5_142_08" JavaVersion="1.4.2_08-8150" JavaVendor="BEA">
    component name="AquaLogic Data Services Platform" version="2.5.0.0">
      <component name="Runtime" /> 
      <component name="Workshop Extension" /> 
      <component name="Samples" /> 
      </component>
      </release>
      </product>
  6. Remove the entire entry.
  7. Proceed with a new installation and deployment.

  Back to Top       Previous  Next