bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Installation and Migration

Post-Installation Tasks

After you install BEA Liquid Data for WebLogicTM, we suggest that you do the following:

- Verify the Installation by Running the Samples and Starting Data View Builder

- For Client-Only Installations Modify Data View Builder Start Script

- Verify Client is Using Same Version of JDK as Server

- Work Through the Quick Start Steps

- Start Developing Your Own Data Integration Solution

- Liquid Data Windows Shortcuts and UNIX Paths

- Uninstalling Liquid Data

For convenience, this topic also describes Liquid Data Windows Shortcuts and UNIX Paths. Finally, if you need to uninstall Liquid Data for any reason, follow the instructions in Uninstalling Liquid Data.

Verify the Installation by Running the Samples and Starting Data View Builder

After you install Liquid Data, you can verify that your installation was successful by populating the Samples database and starting the Sample server. We suggest that you also take the time to bring up the Data View Builder and connect to the running Samples server. These sections walk you through both tasks:

- Set Up and Run the Samples

- Start Data View Builder and Connect to the Samples Server

Set Up and Run the Samples

To set up and run the Samples do the following:

1. Populate the Samples database by running the First-Time Samples Configuration.

   - On a Windows platform, choose the menu item:
     Start—>Programs—>BEA WebLogic Platform 7.0—>Liquid Data for WebLogic 1.0—>Liquid Data Samples—>First-Time Samples Configuration

   - On a UNIX platform, open a command window, change directories into the following directory in the Samples domain:

>     WL_HOME/liquiddata/samples/config/ld_samples/command/

Populate the Samples database by running the First-Time Samples Configuration. To do this, enter the following command at the prompt in the same command window.

>     ldsample.sh

A PointBase command window is started, and messages related to Samples setup (database population) are displayed for several seconds. When Samples setup is complete this is indicated in the command window. Wait for the database population to complete before proceeding with the next step.

1. Run the Samples server.

   - On a Windows platform, choose the menu item:
     Start—>Programs—>BEA WebLogic Platform 7.0—>Liquid Data for WebLogic 1.0—>Liquid Data Samples—>Launch Samples Server

   - On a UNIX platform, open a command window and change directories into the Samples domain:

   >     WL_HOME/liquiddata/samples/config/ld_samples

   Run the server by entering the following command at the prompt

   >     sh startWebLogic.sh

   A Samples Server command window is started, and messages related to starting the server are displayed for several seconds.

   Note: The following message in the Samples Server command window indicates that the server is up and running: <Server Started in RUNNING Mode>

2. Run the Liquid Data Avitek Sample.

   When the server is up and running, you can run the Sample as follows:

   - On a Windows platform, choose the menu item:
     Start—>Programs—>BEA WebLogic Platform 7.0—>Liquid Data for WebLogic 1.0—>Liquid Data Samples—>Open Samples Home

   A default Web browser is started and a Samples Welcome page is displayed in the browser.

   - On a UNIX platform, go to the following URL in a Web browser:

   >     http://localhost:7001/ldsample/index.htm

   We suggest that you take some time to tour the Samples a bit and try running the Sample queries. You can learn more about the Samples and associated Quick Start Steps in the Samples documentation.

Start Data View Builder and Connect to the Samples Server

Once you have the Samples server running, be sure to test the Data View Builder client connection by bringing up the Data View Builder and connecting to the running Samples server. In this way, you can make sure the data sources and views used in the Samples are showing up in the Builder client. This also gives you a chance to tinker with the Data View Builder and get familiar with how it works together with the Liquid Data server.

Note: If you have a client-only installation of the Data View Builder you will need to modify the Data View Builder start script to point to weblogic.jar before you can start the Builder. For instructions on how to do this, see For Client-Only Installations Modify Data View Builder Start Script.

To start the Data View Builder and connect to the Samples server, do the following:

1. Start the Data View Builder.

   - On a Windows platform, choose the menu item:

   Start—>Programs—>BEA WebLogic Platform 7.0—>Liquid Data for WebLogic 1.0—>Launch Data View Builder

   You can also start the Data View Builder by double-clicking on the file:

   >     WL_HOME\liquiddata\DataViewBuilder\bin\DVBuilder.cmd

   The Data View Builder graphical user interface (GUI) starts up and a Login window is displayed.

2. Connect to your Samples server.

   1. Enter the following address in the Server URI field on the Login window. (No username or password is required here. Leave those fields blank.)

      >     t3://localhost:7001

   2. Click the Login button.

   The Data View Builder desktop and tools are displayed. Relational Databases (RDBMS) is selected on the left navigation panel. Three RDBMS data sources are shown: PB-BB, PB-CR, PB-WL. These are the PointBase RDBMS data sources used by the Samples. You can double-click on each of these data sources in the left panel to display their source XML schemas in the Data View Builder workspace.

For Client-Only Installations Modify Data View Builder Start Script

Data View Builder startup requires the following:

- A copy of WebLogic Server 7.0 weblogic.jar file must be available to the machine on which you installed the Data View Builder.

- Valid path to WebLogic 7.0 file weblogic.jar in Data View Builder start script

- Valid path to the JDK 1.3.1 or JRE 1.3.1 Java executable in Data View Builder start script. (This is provided in the script automatically.)

In a Liquid Data "Client-Only" installation that includes only Data View Builder, the user must specify these settings manually. (Whereas for install set options that include the Liquid Data server, these are taken care of automatically at install time.)

To configure a Client-Only system for Data View Builder startup, do the following after install.

Ensure that weblogic.jar is Available on Client System

If you have not already done so, copy WebLogic Server 7.0 weblogic.jar file onto the system where you installed Data View Builder or make a remote instance of this file available to your local machine by mapping a drive to its location and path.

Modify Data View Builder Start Script for weblogic.jar

To modify the start script as needed, do the following:

1. Find the Data View Builder start script on the system where you installed the Data View Builder.

WL_HOME\liquiddata\DataViewBuilder\bin\DVBuilder.cmd

1. Edit the Data View Builder start script to provide appropriate path for the weblogic.jar.

   The following code listing (Listing 4-1) shows the "User Configuration" section of the Data View Builder start script. (The lines you need to modify are shown in bold.).

   Modify the setting for the CLASSPATH variable so that it points to the local instance of weblogic.jar. (The default value provided for CLASSPATH will not work for your Client-Only install because WLS_HOME probably does not exist.)

Listing 4-1 Data View Builder Start Script: User Configuration Section

>     : ---------------------------------------------------------------------------
>     : User configuration
>     : ---------------------------------------------------------------------------
>     : JAVA runtime environment
>     : If the default configuration does not work on your system set the local
>     : variable JAVA to point to the location of the Java interpreter (java.exe)
>     : Example:
>     : set JAVA=c:\jdk1.3\bin\java

>     : JAVA classpath
>     : Use the local variable CLASSPATH to add custom entries (e.g. JDBC drivers) to
>     : the classpath. Separate multiple paths with ";". Adding additional files
>     : or locations on separate lines makes things clearer.
>     :
>     : Example:
>     :
>     :     Set the CLASSPATH to a jar file and a directory. Note that
>     :     "classes dir" is a directory of class files with a space in the name.
>     :
>     : SET CLASSPATH=C:\Product1\lib\product.jar
>     : SET CLASSPATH=%CLASSPATH%;C:\MyProject\classes dir

>     : set WLS_HOME=C:\bea\weblogic700    //remove or comment out this line
>     set CLASSPATH=C:\weblogic.jar    //edit this line to point to the correct version of
>                                                                   //weblogic.jar

>     : JVM parameters
>     : If you want to modify the default parameters (e.g. maximum heap size -Xmx)
>     : for the Java virtual machine set the local variable JVM_PARAMETERS below
>     : Example:
>     : SET JVM_PARAMETERS=-Xms100M -Xmx200M

>     : ---------------------------------------------------------------------------
>     : Default configuration. Do not modify below this line.
>     : ---------------------------------------------------------------------------

1. Save the modified Data View Builder start script file.

   You are now ready to start the Data View Builder on the Client-Only system. (See Start Data View Builder and Connect to the Samples Server.) Remember that you must have the Liquid Data server running before you start the Data View Builder.

Verify Client is Using Same Version of JDK as Server

Please note that apart from the requirement for the JDK for use by installer (as detailed in Client Installation Prerequisites), once it is installed the Data View Builder must use the same version of the JDK that the Liquid Data server uses. For the current release, the Liquid Data server uses JDK 1.3.1_06. For example if Liquid Data server is using C:/BEA_HOME/jdk131_06/, then the Data View Builder must use this same Java Home. An entry for the JDK or JRE 1.3.1 bin directory (for example BEA_HOME/jdk131_06/bin) must be included in your PATH environment variable setting before any other JDK bin directories.

You can also set the a local JDK home for the Data View Builder in the Data View Builder start script (see Listing 4-1) by uncommenting the line set JAVA=c:\jdk1.3\bin\java and setting it to the appropriate JDK Home; however, this should not be necessary if the right JDK Home is in your PATH.

Work Through the Quick Start Steps

Work through the Samples and Getting Started steps which show you how to do the following basic tasks:

- Start the Liquid Data server

- Start the WLS Administration Console and use it to set up a data source.

- Start the Data View Builder and use it to map source and target XML schemas and construct a query.

- Run the query you just built.

- Save the project.

Start Developing Your Own Data Integration Solution

Developing your own data integration solution consists of a design phase and an implementation phase. If you want help stepping through the end-to-end process, including design of a business solution, configuration, query construction, JSP presentation, deployment, and using Liquid Data with other BEA products, refer to the Liquid Data Product Overview for an in-depth look at the data integration process and features.

- If you are ready to start setting up and configuring your own data sources, refer to the Liquid Data Administration Guide.

- If you are ready to start mapping source and target XML schemas and constructing queries in the Data View Builder, refer to Building Queries and Data Views.

Liquid Data Windows Shortcuts and UNIX Paths

When installing Liquid Data on a Windows system, the installer program uses BEA WebLogic Platform as the parent folder for WebLogic Server and BEA Liquid Data. However, on the Start menu BEA Liquid Data shows up under "Programs" as follows:

Start—>Programs—>BEA WebLogic Platform 7.0—>Liquid Data for WebLogic 1.0

The Liquid Data folder contains the following shortcut files:

- Liquid Data Samples—>First-Time Samples Configuration—Populates the Samples databases. You need to populate the Samples database before running the Samples for the first time. Choose this action when you have first install Liquid Data.

- Liquid Data Samples—>Launch Samples Server—Starts the Liquid Data Samples server by running the startWebLogic command in the following domain:

WL_HOME/liquiddata/samples/config/ld_samples

- Liquid Data Samples—>Open Samples Home—Launches the Liquid Data Sample in your default Web browser at this URL:

http://localhost:7001/ldsample/index.htm

Provides information about how to run the Avitek Sample queries and where to find more query examples with readme files.

- Launch Data View Builder—Launches the Data View Builder GUI tool. The Windows executable command to start this tool are in the following location: WL_HOME/liquiddata/DataViewBuilder/bin

The command to start the Data View Builder on Windows is DVBuilder.cmd.

- Online Documentation—Launches the Liquid Data Online Documentation in your default Web browser. This requires an internet connection because online documentation resides at BEA edocs site. The path to the Liquid Data documentation home page on "edocs" is: http://download.oracle.com/docs/cd/E13190_01/liquiddata/docs10/index.html

- Start Admin Console—Starts the WLS Administration Console for the Liquid Data server that is currently running.

- Uninstall—Uninstalls the Liquid Data software.

Uninstalling Liquid Data

Removing Liquid Data requires you to run the Liquid Data uninstaller and then manually remove the Liquid Data directory containing the extra files not removed by the uninstaller. In cases where you have added Liquid Data to another domain, when you uninstall you must also undeploy before you uninstall. For information on undeploying, see the topic Undeploying Deployed Applications in the WebLogic Server documentation.

For a successful installation of Liquid Data, the WL_HOME directory into which you install a new version of Liquid Data must not contain any files from a previously installed version. Extra files or folders left in place from an old install can cause a defective installation of a new version of Liquid Data.

To uninstall Liquid Data:

1. Run the Liquid Data uninstaller according to the following instructions:

   - Windows—Choose Start—>Programs—BEA WebLogic Platform 7.0—>Liquid Data for WebLogic 1.0—>uninstall, or run the following command:

   >     WL_HOME\liquiddata\uninstaller\uninstall.cmd

   - UNIX—Run the following command:

   >     WL_HOME/liquiddata/uninstaller/uninstall

   (Use this uninstall option if you installed via GUI mode as described in Installing Liquid Data Using GUI Mode.)

   or

   >     WL_HOME/liquiddata/uninstaller/uninstall -i CONSOLE

   (Use this uninstall option with "-i CONSOLE" if you installed via Console mode as described in Installing Liquid Data Using Console or Silent Mode.)

Note: When the uninstall is completed it will notify you that there are some files that could not be removed by the automated uninstall. This could be a result of new files that were 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 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.

1. To remove the leftover files, manually delete the Liquid Data domain directory. To do this, remove the following directory:

   - Windows

   >     BEA_HOME\weblogic700\liquiddata

   - UNIX

   >     BEA_HOME/weblogic700/liquiddata