bea.com | products | dev2dev | support | askBEA |
|
e-docs > Liquid Data for WebLogic > Deploying Liquid Data > Deployment Tasks |
Deploying Liquid Data |
This topic describes the tasks involved in deploying BEA Liquid Data for WebLogicTM in a production environment. It includes the following sections:
Defining Deployment Requirements
Defining deployment requirements is a critical first step in the process of deploying Liquid Data in a production environment.
When planning a deployment, consider the following issues:
Which types of queries (stored or ad hoc queries) will they run? How frequently will users be running different types of queries? Which queries will be run more frequently or less frequently than others? What are the anticipated peak loads for processing concurrent query requests?
Clarifying the specific requirements for your deployment provides the knowledge you will need to design your deployment.
This topic describes how to design a Liquid Data deployment for the following types of domains:
The deployment architecture that you use depends on the requirements for your particular production environment, as described in Defining Deployment Requirements.
If you are installing Liquid Data into an new domain you can use the WebLogic Platform Domain Configuration Wizard.
Figure 2-1 Liquid Data Options in WebLogic Platform Domain Wizard
The Domain Configuration Wizard supports creation of the following Liquid Data-enabled domains:
For more information, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you are installing Liquid Data into an existing WebLogic Platform domain of any type, you will not be able to use the Domain Configuration Wizard for that purpose. Specific instructions for such deployments to existing domains can be found in the following:
In the cases of new deployments, the Domain Configuration Wizard makes most of the steps described in the above articles unnessary. However the discussion appropriate to your deployment should be reviewed since in each case there are a few steps to follow after running the Domain Configuration Wizard.
The following sections describe single domain deployments:
In a single server (standalone) deployment, the Liquid Data software is installed on a standalone WebLogic Server. This design is the simplest to set up and it is the one suggested for use in a development environment or in a production environment in which Liquid Data is the primary application and failover protection is not the top priority.
The following illustration shows Liquid Data and WebLogic Server deployed on a single server:
Figure 2-2 Liquid Data and WebLogic Platform Deployed on a Single Server
For instructions on how to deploy Liquid Data and other WebLogic Platform components on a single server (standalone) deployment, see the following sections:
A multi-node deployment distributes Liquid Data and WebLogic Platform software components across multiple server machines. A multi-node deployment allows you to run the various software components on dedicated servers, distributing resource contention across machines and optimizing system performance.
In each multi-node WebLogic Server domain, one WebLogic Server instance acts as the Administration Server—the server instance that configures, manages, and monitors all other server instances and resources in the domain. In a multi-node deployment, the Administration Server has administrative control over the domain and hosts the server repository. All other servers in the domain are configured as Managed Servers—servers that are managed by the Administration Server.
The following illustration shows Liquid Data deployed in a sample multi-node domain with three dedicated servers, one each for Liquid Data, WebLogic Portal, and WebLogic Workshop:
Figure 2-3 Liquid Data Deployed in a Multi-Node Domain
To deploy this design, follow the steps described in Deploying Liquid Data on a Multi-Node WebLogic Domain.
A clustered deployment distributes Liquid Data and WebLogic Platform software components across multiple server machines. A cluster is a group of servers that work together to provide an application platform that is more powerful and reliable than a single server. A cluster appears to its clients as a single server but it is, in fact, a group of servers acting as one. In contrast to a multi-node deployment (in which Liquid Data and WebLogic Platform software components are installed separately on dedicated machines), in a clustered deployment, all Liquid Data and WebLogic Platform software components are installed on every machine.
A Liquid Data cluster is a deployment in which multiple copies of Liquid Data, referred to as instances, run simultaneously and work together to provide increased scalability and reliability. A Liquid Data cluster appears to clients to be a single Liquid Data instance. The server instances that constitute a cluster can run on the same machine, or can be located on different machines. You can increase a cluster's capacity by adding additional server instances to the cluster on an existing machine, or you can add machines to the cluster to host the incremental server instances. Each server instance in a cluster must run the same version of WebLogic Server. For extensive information about clustering, see Using WebLogic Server Clusters in the WebLogic Server documentation.
In each WebLogic Server domain, one WebLogic Server instance acts as the Administration Server—the server instance that configures, manages, and monitors all other server instances and resources in the domain. In a clustered deployment, the Administration Server has administrative control over the domain and hosts the server repository. All other servers in the domain are configured as Managed Servers—servers that are managed by the Administration Server. In a single instance deployment, the sole WebLogic Server instance is the Administration Server by default.
Note: In general, avoid configuring the Administration Server as part of the cluster.
In a clustered Liquid Data deployment, you select the algorithm to use for load balancing (round robin, weight-based, or random). Once configured, the load balancing mechanism directs incoming XQuery query requests to available Liquid Data Server instances. For more information, see Load Balancing in a Cluster in Using WebLogic Server Clusters in the WebLogic Server documentation.
In a clustered Liquid Data deployment, if a server fails, the WebLogic cluster can redirect request processing to another Liquid Data Server instance in the cluster. For more information, see "Replication and Failover for EJBs and RMIs" in Failover and Replication in a Cluster in Using WebLogic Server Clusters in the WebLogic Server documentation.
The following illustration shows Liquid Data deployed in a clustered domain.
Figure 2-4 Liquid Data Deployed in a Clustered Domain
This design is suggested for a deployment environment in which:
Before proceeding to deploy Liquid Data in a cluster, you should determine whether running Liquid Data on a dedicated server machine, as configured in Multi-Node Deployments, meets the performance and availability requirements for your deployment. Using the single server as a baseline, you can monitor run-time performance, conduct capacity planning, and test to determine whether a single machine provides sufficient performance at high query request loads.
To deploy this design, follow the steps described in:
In a multi-domain deployment, Liquid Data and the WebLogic Platform component are installed on separate WebLogic domains. To deploy this design for WebLogic Portal, follow the steps described in Deploying Liquid Data and WebLogic Portal in Separate Domains.
Deploying Liquid Data in a WebLogic Platform Domain
The following topics describe how to deploy Liquid Data with WebLogic Platform:
Deploying Liquid Data on a Standalone WebLogic Platform Domain
This section describes how to deploy Liquid Data on a standalone (single server) WebLogic Platform domain. For more information about single server deployments, see Single Server Deployments.
To deploy Liquid Data on a standalone WebLogic Platform domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Platform domain, you can create the domain and configure Liquid Data at the same time using the WebLogic Domain Configuration Wizard. After using the wizard, complete the deployment by following instructions starting with step 10.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Platform domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=ld_home_dir
set LDI_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LDI_LIB%\wlldi.jar;%LDI_LIB%\LDS-descriptions.jar;%LDI_LIB%\castor-0.9.3.9.jar;%LDI_LIB%\xercesImpl.jar
set CLASSPATH=%CLASSPATH%;%LDCLASSPATH%
LD_HOME=ld_home_dir
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
CLASSPATH=$CLASSPATH:$LDCLASSPATH
export CLASSPATH
Deploying Liquid Data on a Multi-Node WebLogic Domain
This section describes how to deploy Liquid Data on a WebLogic domain with an Administration Server and Managed Servers in a multi-node, non-clustered environment. For more information about multi-node domains, see Multi-Node Deployments.
Notes: Due to limitations with WebLogic Integration, do not configure WebLogic Integration on a WebLogic domain in a multi-node environment.
Before you begin, verify that your BEA software license is appropriate for your deployment.
To deploy Liquid Data on a multi-node WebLogic Platform domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Platform domain, you can also configure Liquid Data using the WebLogic Platform Domain Configuration Wizard. After using the Wizard, complete the deployment by following instructions starting with step 15.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Platform domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=ld_home_dir
set LDI_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LDI_LIB%\wlldi.jar;%LDI_LIB%\LDS-descriptions.jar;%LDI_LIB%\castor-0.9.3.9.jar;%LDI_LIB%\xercesImpl.jar
set CLASSPATH=%CLASSPATH%;%LDCLASSPATH%
LD_HOME=ld_home_dir
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
CLASSPATH=$CLASSPATH:$LDCLASSPATH
export CLASSPATH
Deploying a Liquid Data Cluster on a WebLogic Platform Domain
This section describes how to deploy a Liquid Data cluster on a WebLogic domain with an Administration Server and Managed Servers. Clustering is typically used to provide scalability in deployments with high volumes of query requests and to provide fail-over protection in deployments with high availability requirements. For more information about clustered deployments, see Clustered Deployments.
Note: Before you begin, verify that your BEA software license is appropriate for your deployment.
To deploy a Liquid Data cluster on a WebLogic Platform domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Platform domain, you can also configure Liquid Data using the WebLogic Platform Domain Configuration Wizard. After using the Wizard, complete the deployment by following instructions starting with step 16.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Platform domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=ld_home_dir
set LDI_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LDI_LIB%\wlldi.jar;%LDI_LIB%\LDS-descriptions.jar;%LDI_LIB%\castor-0.9.3.9.jar;%LDI_LIB%\xercesImpl.jar
set CLASSPATH=%CLASSPATH%;%LDCLASSPATH%
LD_HOME=ld_home_dir
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
CLASSPATH=$CLASSPATH:$LDCLASSPATH
export CLASSPATH
For more information about load balancing algorithms, see "Load Balancing for EJBs and RMI Objects" in Load Balancing in a Cluster in Using WebLogic Server Clusters in the WebLogic Server documentation.
Deploying Liquid Data in a WebLogic Integration Domain
The following sections describe how to deploy Liquid Data with WebLogic Integration.
Note: Due to limitations with WebLogic Integration, do not configure WebLogic Integration on a WebLogic domain in a multi-node environment.
Deploying Liquid Data On a Standalone WebLogic Integration Domain
This section describes how to deploy Liquid Data on a standalone (single server) WebLogic Integration domain. For more information about single server deployments, see Single Server Deployments.
To deploy Liquid Data on a standalone WebLogic Integration domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Integration (WLI) domain, you can create the domain and configure Liquid Data at the same time using the WebLogic Domain Configuration Wizard. After using the Wizard, complete the deployment by following instructions starting with step 13.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Integration domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=%BEA_HOME%\weblogic700\liquiddata
set LDI_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LDI_LIB%\wlldi.jar;%LDI_LIB%\LDS-descriptions.jar;%LDI_LIB%\castor-0.9.3.9.jar;%LDI_LIB%\xercesImple.jar
set SVRCP=%SVRCP%;%LDCLASSPATH%
LD_HOME=$BEA_HOME/weblogic700/liquiddata
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
SVRCP=$SVRCP:$LDCLASSPATH
Deploying Liquid Data in a Clustered WebLogic Integration Domain
This section describes how to deploy Liquid Data in a clustered WebLogic domain. Clustering is typically used to provide scalability in deployments with high volumes of query requests and to provide fail-over protection in deployments with high availability requirements. For more information about clustered deployments, see Clustered Deployments.
Note: Before you begin, verify that your BEA software license is appropriate for your deployment.
To deploy Liquid Data in a clustered WebLogic Integration domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Integration (WLI) domain, you can create the domain and configure Liquid Data at the same time using the WebLogic Domain Configuration Wizard. After using the Wizard, complete the deployment by following instructions starting with step 18.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Integration domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=%BEA_HOME%\weblogic700\liquiddata
set LDI_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LDI_LIB%\wlldi.jar;%LDI_LIB%\LDS-descriptions.jar;%LDI_LIB%\castor-0.9.3.9.jar;%LDI_LIB%\xercesImple.jar
On the Administration Server, specify the following command:
set SVRCP=%SVRCP%;%LDCLASSPATH%
On any Managed Servers, specify the following command:
set CLASSPATH=%CLASSPATH%;%LDCLASSPATH%
In the startup script, verify that the following information about the Administration Server is correct:
set ADMIN_URL=admin_server_name:admin_server_listening_port
LD_HOME=$BEA_HOME/weblogic700/liquiddata
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
For more information about load balancing algorithms, see "Load Balancing for EJBs and RMI Objects" in Load Balancing in a Cluster in Using WebLogic Server Clusters in the WebLogic Server documentation.
Deploying Liquid Data in a WebLogic Server Domain
The following sections describe how to deploy Liquid Data in a WebLogic Server domain:
Deploying Liquid Data in a Standalone WebLogic Server Domain
This section describes how to deploy Liquid Data in a standalone (single server) WebLogic Server domain. For more information about single server deployments, see Single Server Deployments.
To deploy Liquid Data in a standalone WebLogic Server domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Server (WLS) domain, you can create the domain and configure Liquid Data at the same time using the WebLogic Domain Configuration Wizard. After using the Wizard, complete the deployment by following instructions starting with step 12.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Server domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
<Security CompatibilityMode="true" GuestDisabled="false" Name="wls_domain_name" Realm="myRealm" RealmSetup="true"/>
<Realm FileRealm="myFileRealm" Name="myRealm"/>
<FileRealm Name="myFileRealm"/>
This example assumes that you are using a file realm for the compatibility security realm. For other types of security realms, see "Specifying a Security Realm" in Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
ServerCertificateFileName="democert.pem"
ServerKeyFileName="demokey.pem" TrustedCAFileName="ca.pem"
ServerPrivateKeyAlias="demokey"
ServerPrivateKeyPassPhrase="WhatEverHere"
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=ld_home_dir
set LDI_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LDI_LIB%\wlldi.jar;%LDI_LIB%\LDS-descriptions.jar;%LDI_LIB%\castor-0.9.3.9.jar;%LDI_LIB%\xercesImpl.jar;
set CLASSPATH=%CLASSPATH%;%LDCLASSPATH%
LD_HOME=ld_home_dir
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
CLASSPATH=$CLASSPATH:$LDCLASSPATH
export CLASSPATH
Deploying Liquid Data in a Clustered WebLogic Server Domain
This section describes how to deploy Liquid Data in a clustered WebLogic Server domain. Clustering is typically used to provide scalability in deployments with high volumes of query requests and to provide fail-over protection in deployments with high availability requirements. For more information about clustered deployments, see Clustered Deployments.
Note: Before you begin, verify that your BEA software license is appropriate for your deployment.
To deploy Liquid Data in a clustered WebLogic Server domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Server (WLS) domain, you can create the domain and configure Liquid Data at the same time using the WebLogic Domain Configuration Wizard. After using Domain Configuration Wizard, complete the deployment by following instructions starting at step 21.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Server domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
<Security CompatibilityMode="true" GuestDisabled="false" Name="wls_domain_name" Realm="myRealm" RealmSetup="true"/>
<Realm FileRealm="myFileRealm" Name="myRealm"/>
<FileRealm Name="myFileRealm"/>
This example assumes that you are using a file realm for the compatibility security realm. For other types of security realms, see "Specifying a Security Realm" in Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
ServerCertificateFileName="democert.pem"
ServerKeyFileName="demokey.pem" TrustedCAFileName="ca.pem"
ServerPrivateKeyAlias="demokey"
ServerPrivateKeyPassPhrase="WhatEverHere"
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=ld_home_dir
set LD_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LD_LIB%\wlldi.jar;%LD_LIB%\LDS-descriptions.jar;%LD_LIB%\castor-0.9.3.9.jar;%LD_LIB%\xercesImpl.jar
set CLASSPATH=%CLASSPATH%;%LDCLASSPATH%
LD_HOME=ld_home_dir
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
CLASSPATH=$CLASSPATH:$LDCLASSPATH
export CLASSPATH
For more information about load balancing algorithms, see "Load Balancing for EJBs and RMI Objects" in Load Balancing in a Cluster in Using WebLogic Server Clusters in the WebLogic Server documentation.
Deploying Liquid Data in a WebLogic Portal Domain
The following topics describe how to deploy Liquid Data with WebLogic Portal:
For general information about managing WebLogic Portal in a production environment, see System Administration in the WebLogic Portal Administration Guide.
Deploying Liquid Data in a Standalone WebLogic Portal Domain
This section describes how to deploy Liquid Data in a standalone (single server) WebLogic Portal domain. For more information about single server deployments, see Single Server Deployments.
To deploy Liquid Data in a standalone WebLogic Portal domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Portal domain, you can create the domain and configure Liquid Data at the same time using the WebLogic Domain Configuration Wizard. After using the Wizard, complete the deployment by following instructions starting with step 12.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Developing Portals—Tutorials in the Development Guide in the WebLogic Portal documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Portal domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=ld_home_dir
set LDI_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LDI_LIB%\wlldi.jar;%LDI_LIB%\LDS-descriptions.jar;%LDI_LIB%\castor-0.9.3.9.jar;%LDI_LIB%\xercesImpl.jar;
set CLASSPATH=%CLASSPATH%;%LDCLASSPATH%
LD_HOME=ld_home_dir
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
CLASSPATH=$CLASSPATH:$LDCLASSPATH
export CLASSPATH
Deploying Liquid Data and WebLogic Portal in Separate Domains
To deploy Liquid Data and WebLogic Portal in separate domains:
<taglib>
<taglib-uri>LDSTLD</taglib-uri>
<taglib-location>/WEB-INF/lib/LDS-taglib.jar</taglib-location>
</taglib>
Deploying Liquid Data in a Standalone WebLogic Workshop Domain
This section describes how to deploy Liquid Data in a standalone (single server) WebLogic Workshop domain. For more information about single server deployments, see Single Server Deployments.
To deploy Liquid Data in a WebLogic Workshop domain:
Note: If you are using Liquid Data 1.1 or later and you are deploying Liquid Data into a new WebLogic Portal domain, you can create the domain and configure Liquid Data at the same time using the WebLogic Domain Configuration Wizard. After using the Wizard, complete the deployment by following instructions beginning with step 12.
Check the Liquid Data Release Notes for the most up-to-date deployment instructions regarding using the Configuration Wizard.
For instructions, see Creating a New WebLogic Domain in Using the Configuration Wizard in the WebLogic Platform documentation.
Note: If you want to deploy Liquid Data on an existing WebLogic Workshop domain instead of creating a new one, then the existing domain must use a WebLogic Server compatibility security realm. For more information, see Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation.
<Realm FileRealm="myFileRealm" Name="myRealm"/>
<FileRealm Name="myFileRealm"/>
<Security CompatibilityMode="true" GuestDisabled="false" Name="<workshop_domain_name>" Realm="myRealm" RealmSetup="true"/>
Note: If your deployment will use application views as data sources, you need to add the path to the Application Integration wlai-client.jar file (such as %WLI_HOME%\lib\wlai-client.jar) to the end of the Liquid Data classpath (LDCLASSPATH).
set LD_HOME=ld_home_dir
set LDI_LIB=%LD_HOME%\server\lib
set LDCLASSPATH=%LDI_LIB%\wlldi.jar;%LDI_LIB%\LDS-descriptions.jar;%LDI_LIB%\castor-0.9.3.9.jar;%LDI_LIB%\xercesImpl.jar;
set CLASSPATH=%CLASSPATH%;%LDCLASSPATH%
LD_HOME=ld_home_dir
LDI_LIB=$LD_HOME/server/lib
LDCLASSPATH=$LDI_LIB/wlldi.jar:$LDI_LIB/LDS-descriptions.jar:$LDI_LIB/castor-0.9.3.9.jar:$LDI_LIB/xercesImpl.jar
CLASSPATH=$CLASSPATH:$LDCLASSPATH
export CLASSPATH
group.Administrators=system,domain_user_name
acl.lookup.weblogic.jndi=everyone
acl.modify.weblogic.jndi.weblogic.fileSystem=Administrators
acl.admin.weblogic.jdbc=Administrators, guest
acl.lookup.weblogic.jndi.weblogic.fileSystem=Administrators
acl.lookup.weblogic.jndi.weblogic.ejb=Administrators
acl.list.weblogic.jndi.weblogic.rmi=Administrators
acl.shrink.weblogic.jdbc=Administrators, guest
acl.create.weblogic.jms.ConnectionConsumer=Administrators
acl.lockServer.weblogic.admin=Administrators
acl.shutdown.weblogic.admin=Administrators
acl.boot.weblogic.server=Administrators
acl.list.weblogic.jndi.weblogic.fileSystem=Administrators
acl.lookup.weblogic.jndi.weblogic=Administrators
acl.modify.weblogic.jndi.weblogic.rmi=Administrators
acl.modify.weblogic.jndi.weblogic=Administrators
acl.list.weblogic.jndi.weblogic=Administrators
acl.send.weblogic.jms=Administrators
acl.lookup.weblogic.management=Administrators
acl.receive.weblogic.jms=Administrators
acl.reserve.weblogic.jdbc=Administrators, guest
acl.modify.weblogic.management=Administrators
acl.lookup.weblogic.jndi.weblogic.rmi=Administrators
acl.list.weblogic.jndi=Administrators
acl.modify.weblogic.jdbc=Administrators, guest
acl.modify.weblogic.admin.acl=Administrators
acl.list.weblogic.jndi.weblogic.ejb=Administrators
acl.modify.weblogic.jndi=Administrators
acl.write.managedObject=Administrators
acl.reset.weblogic.jdbc=Administrators, guest
acl.read.managedObject=Administrators
acl.admin.weblogic.jdbc.connectionPoolcreate=Administrators,
guest acl.unlockServer.weblogic.admin=Administrators
acl.execute.weblogic.servlet=Administrators
acl.modify.weblogic.jndi.weblogic.ejb=Administrators
Copying a Server Configuration to Another Server
This topic describes the steps involved in copying Liquid Data server configuration information from one server to another, such as from a development environment to a production environment. Rather than configuring the production server manually, you can transfer settings already configured in the development environment.
The following illustration shows the Liquid Data components that you need to transfer to the production server:
Figure 2-5 Migrating From a Development to a Production Server
To migrate from a development environment to a production environment, you need to migrate the following configuration information:
Contains the WebLogic Server configuration, including the domain configuration and, if applicable, the JDBC database configuration. Open the config.xml file on the target server and edit any machine-specific parameters. |
|
Contains the Liquid Data server startup script. Open the startup script on the target server and edit any machine-specific parameters. Also, for a production environment, change the STARTMODE variable to true. |
|
Copy from the WL_HOME/user_projects/domain_name directory on the source server to the corresponding directory on the target server. |
|
Replicate the security realm configuration on the production server. The Liquid Data security configuration includes the compatibility security realm, groups, users, and ACL configurations. How you copy the configuration depends on the type of compatibility security realm that you have set up according to the instructions in "Defining a Compatibility Security Realm" in Implementing Security in the Liquid Data Administration Guide. In general, copy the filerealm.properties file to the target machine and, if you have used any other type of compatibility security realm, use the appropriate import/export utility. For example, for an LDAP realm, use the LDAP import/export features. For more information, see "Specifying a Security Realm" in Using Compatibility Security in Managing WebLogic Security in the WebLogic Server documentation. |
|
On the development server, create a compressed image of the complete server repository, including all sub-folders, using a TAR or ZIP file for the Unix and Windows platforms, respectively. Copy this compressed file to the production server and expand it. On the production server, start the Administration Console and configure the repository root directory on the General tab in the Liquid Data node. |
|
On the development server, export the Liquid Data configuration information to an export file. On the production server, import the contents of the export file. For instructions, see Importing and Exporting Liquid Data Configurations in the Liquid Data Administration Guide. |