Installing WebLogic Integration on AIX or Linux for S/390 and zSeries

 

The following sections provide guidelines specific to installing and configuring WebLogic Integration on AIX and Linux for S/390 and zSeries platforms. Use these guidelines in conjunction with the detailed instructions for installing and configuring WebLogic Integration provided in Installing BEA WebLogic Integration and in Starting, Stopping, and Customizing BEA WebLogic Integration.

• Installing WebLogic Integration in Graphics or Console Mode

• Installing WebLogic Integration Using Silent Mode

• WebLogic Integration Client Installation

• Updating the WebLogic Integration Environment

• Configuring the Database

• WebLogic Integration Commands

 

---

Installing WebLogic Integration in Graphics or Console Mode

Refer to the instructions provided in Installing BEA WebLogic Integration for details about starting and running the installation program.

During installation, you must select a database for your samples and production domains. When installing on AIX or Linux for S/390 and zSeries, you must select DB2 for both your production and samples domains.

When you select DB2, you are prompted to provide the information in the following table.

Table A-1. DB2 Database Access Information

Connection Parameter	Description
Database User	Account login name required to connect to the DB2 server
Database Password	Password required to connect
Database Name	Name used to identify the database. Each database on the server is cataloged using a unique name. If you have set up an alias for the database as part of your client configuration, enter the alias. Otherwise, enter the unique name cataloged on the server. For example, you would enter s_dbwli, if that alias has been assigned to the database using the DB2 Client Configuration Assistant, or by executing the following DB2 Universal Database command line processor (CLP) command: catalog database dbwli as s_dbwli at node db2server.

 

Note: After the installation is complete, you must specify the value for DB2_HOME in the setenv.sh file. For instructions, see Updating the WebLogic Integration Environment.

 

---

Installing WebLogic Integration Using Silent Mode

Be sure to review the instructions in "Using Silent Mode to Install WebLogic Integration" in Chapter 3, Installing WebLogic Integration Using Console or Silent Mode in Installing BEA WebLogic Integration. The following table describes the properties you need to specify in the installer properties file for the DB2 database.

Table A-2. Sample DB2 Property Settings

DB2 Property Setting	Description
SELECTED_DATABASE="DB2"	Production database. For installation on AIX or Linux for S/390 and zSeries, you must specify DB2.
production_db2DBName=DatabaseName production_db2User=UserName production_db2Password=Password	DB2 access information. Specify values for each parameter. Leave the other databases listed in the installer properties file as commented text. For a description of these parameters, see Table A-1, "DB2 Database Access Information," on page A-2.
SELECTED_DATABASE="DB2"	Samples database. If you specify Full for the CHOSEN_INSTALL_SET property, you must specify DB2 when installing on an AIX or Linux for S/390 and zSeries platform.
samples_db2DBName=DatabaseName samples_db2User=UserName samples_db2Password=Password	DB2 access information. Specify values for each parameter. Leave the other databases listed in the installer properties file as commented text. For a description of these parameters, see Table A-1, "DB2 Database Access Information," on page A-2.

 

Note: After the installation is complete, you need to specify a value for DB2_HOME in the setenv.sh file. For instructions, see Updating the WebLogic Integration Environment.

 

---

WebLogic Integration Client Installation

When you are performing a client-only installation of WebLogic Integration, it is not necessary to install WebLogic Server 6.1 SP1 on the target system. However, after the installation is complete, you must copy two files, weblogic.jar and xmlx.jar, from the WL_HOME\lib directory on the system on which WebLogic Server is installed to the WLI_HOME\lib directory on the system on which you installed the client version of WebLogic Integration. Here, WL_HOME is the directory in which you installed WebLogic Server, and WLI_HOME is the directory in which you installed WebLogic Integration.

If you have previously performed a client only installation, you must uninstall and reinstall the client applications using the new installer. If you do not reinstall the client applications, the applications wll be unable to communicate with the the instance of WebLogic Integration you installed on AIX or Linux for S/390 and zSeries.

 

---

Updating the WebLogic Integration Environment

The environment variables used by WebLogic Integration are set by the setenv.sh file. This file is located in the WebLogic Integration installation directory (WLI_HOME). The variables in the setenv file are set when you install WebLogic Integration. You must update this file when using the DB2 database by setting the DB2_HOME environment variable to the pathname of the DB2 sqllib directory.

To update the WebLogic Integration environment:

1. Go to the WLI_HOME directory and open setenv.sh in your preferred text editor. (WLI_HOME is the directory in which you installed WebLogic Integration.)

2. Set the value of the DB2_HOME environment variable to the path name of the DB2 sqllib directory. For example:

   DB2_HOME=/home/db2inst1/sqllib

   For additional information about the setenv command, see Appendix A, WebLogic Integration Sample Configuration Files in Starting, Stopping, and Customizing BEA WebLogic Integration.

3. Save your changes and close the file.

When you execute the startWeblogic command, the setenv command is invoked and the environment variables become effective.

 

---

Configuring the Database

Before you can start WebLogic Integration in a preconfigured domain, you must configure the database repository for the domain appropriately. Complete instructions for configuring a database using the database configuration wizard are provided in "Using the Database Configuration Wizard" in Chapter 3, Customizing WebLogic Integration, in Starting, Stopping, and Customizing BEA WebLogic Integration.

The database configuration wizard provides three options:

• Switch Database

• Create Database

• Migrate Database

For WebLogic Integration on AIX or Linux for S/390 and zSeries, however, you can choose only the Create Database option, which initializes the specified database. Because DB2 is currently the only supported database on AIX and Linux, and because it was not supported for earlier releases of WebLogic Integration, you cannot switch to another database or migrate a database from an earlier release.

JDBC Connection Pool Parameters

Although you should use the database configuration wizard to update the database configuration for any of the preconfigured domains, there may be circumstances in which you need to update the database configuration from the WebLogic Server Administration Console. If you do so, you must provide the JDBC connection pool parameters listed in the following table.

Table A-3. DB2 JDBC Connection Pool Parameters

Parameter	Description
JDBC driver	COM.ibm.db2.jdbc.app.DB2Driver
Database user	Account login name required for connecting to the database server
Database password	Password required for connecting to the database server
URL	URL for the database. For DB2, the URL is: jdbc:db2:database_name

 

Complete instructions are provided in "Updating the Database Configuration from the WebLogic Server Administration Console" in Chapter 3, Customizing WebLogic Integration in Starting, Stopping, and Customizing BEA WebLogic Integration.

 

---

WebLogic Integration Commands

Detailed information about the WebLogic Integration commands is provided in Appendix B, WebLogic Integration Commands, in Starting, Stopping, and Customizing BEA WebLogic Integration.

The following table lists the commands that reference database information and the additional information needed for the DB2 database.

Table A-4. DB2 Information for WebLogic Integration Commands

Command	Description
createdb	Creates the repository tables and loads system data. In addition to the files listed in the command description, the following UNIX files are provided for DB2: $WLI_HOME/adapters/dbms/src/sql/CreateDB2Customer_Table.sql $WLI_HOME/adapters/dbms/src/sql/CreateDB2EventTables.sql
setdbtype	Sets the DB_TYPE environment variable for the domain. For DB2, this value is set to DB2. The DB_TYPE environment variable is used in the createdb, switchdb, setdbdata, and RunSamples commands.