|
|
Setting Up Your Environment
This topic describes how to configure up your WebLogic Enterprise (WLE) application so that you can run the University sample applications.
This topic includes the following sections:
A copy of the Readme.txt file with troubleshooting information and the latest information about setting up the sample applications is included in each sample application directory.
For information about setting up a database so that it can be used with the University sample applications, see Setting Up the Database.
System Prerequisites
For information about the operating system platforms supported by the product, see the BEA WebLogic Enterprise Installation Guide.
To run the client applications in the University sample applications, you need the following development tools:
Editing the setenv and UBBCONFIG Files
You need to set several parameters in the setenv and UBBCONFIG files in order for the University sample applications to work properly, as follows:
The information in the setenv and UBBCONFIG files must match. The following sections explain how to edit the setenv and UBBCONFIG files.
Naming Conventions for the setenv and UBBCONFIG Files
Table 2-1 describes the naming conventions for the setenv and UBBCONFIG files.
University |
Naming Convention |
---|---|
Basic |
|
Security |
|
Transactions |
|
Wrapper |
|
Production |
|
Setting setenv Parameters
Table 2-2 lists the parameters you need to modify in the setenv file.
Parameter |
Description |
---|---|
APPDIR |
The directory path where you copied the sample application files. For example: Windows NT APPDIR=c:\work\university\basic UNIX APPDIR=/usr/work/university/basic |
TUXCONFIG |
The directory path and name of the configuration file. For example: Windows NT TUXCONFIG=c:\work\university\basic\tuxconfig UNIX TUXCONFIG=/usr/work/university/basic/tuxconfig |
TUXDIR |
The directory path where you installed the WebLogic Enterprise software. For example: Windows NT TUXDIR=c:\WLEdir UNIX TUXDIR=/usr/local/WLEdir |
ORACLE_HOME |
The directory path where you installed the Oracle software. For example: Windows NT ORADIR=c:\Orant UNIX ORACLE_HOME=/usr/local/oracle |
NETSCAPE |
The directory path where you installed the Netscape Enterprise Server software. For example: Windows NT NETSCAPE=c:\Netscape\SuiteSpot UNIX NETSCAPE=/usr/local/netscape/suitespot You need to specify this parameter only if you plan to use the CORBA Java client application. |
JARTYPE |
Specifies the version of the JDK being used. Windows NT JARTYPE = JDK or jdk UNIX JARTYPE = JDK or jdk If you do not specify the JARTYPE parameter, it is assumed you are using the JDK version 1.1. You need to specify this parameter only if you plan to use the CORBA Java sample application. |
JDKDIR |
The directory path where you installed the JDK software. For example: Windows NT JDKDIR=c:\JDK1.2 UNIX JDKDIR=/usr/local/jdk1.1.6 You need to specify this parameter only if you plan to use the CORBA Java sample application. |
TOBJADDR |
If you are using a CORBA C++ client application that does not reside on the same machine as the server application, enter the host and port of the machine where the server application runs. It must be specified exactly (including case) as it appears in the UBBCONFIG file for the machine. For example: //BEANIE:2500 |
USERID |
If you are using a remote instance of the Oracle database, the format is as follows: USERID=username/password@aliasname This is the same information you defined when you set up a remote instance of the Oracle database. If you are using a local instance of the Oracle database, the format is as follows: USERID=username/password |
ORACLE_SID |
The instance ID of the Oracle database. On Windows NT, you do not need to specify the ORACLE_SID, the parameter automatically defaults to ORCL. |
CCMPL |
The directory location of the C compiler. This parameter is set to a typical installation directory. Verify that your installation matches this directory location and change the location if necessary. This parameter applies only to the UNIX operating system. |
CPPCMPL |
The directory location of the C++ compiler. This parameter is set to a typical installation directory. Verify that your installation matches this directory location and change the location if necessary. This parameter applies only to the UNIX operating system. |
CPPINC |
The directory location of the C++ include directory. This parameter is set to a typical installation directory. Verify that your installation matches this directory location and change the location if necessary. This parameter applies only to the UNIX operating system. |
SHLIB_PATH, LD_LIBRARY_PATH, or LIBPATH |
The directory location of the shared library. This parameter is set to a typical installation directory. Verify that your installation matches this directory location and change the location if necessary. This parameter applies only to the UNIX operating system. |
PROC |
The directory location of the Oracle Programmer C/C++ SQL Precompiler. You only need to specify this parameter if you are using the Windows NT operating system. |
PRODIR |
The directory location of the Oracle Programmer C/C++ SQL Precompiler. You only need to specify this parameter if you are using the Windows NT operating system. |
Setting the UBBCONFIG Parameters
Table 2-3 lists the parameters you need to modify in the UBBCONFIG file.
Parameter |
Description |
---|---|
MY_SERVER_MACHINE |
Delete this parameter and replace it with the name of the server machine. On Windows NT, you can obtain the server machine name by entering the following command at the MS-DOS prompt: set COMPUTERNAME On UNIX, you can obtain the server machine name by entering the following command at the shell prompt: prompt>uname -n You must enter the server machine name exactly (including case) as it appears in the output of the command. Specify the server machine name as it appears. For example, BEANIE. Full names must be included in quotation marks. For example: "beanie.bea.com". |
APPDIR |
The full directory path where you copied the sample application files. The directory path needs to be included in quotation marks. For example: Windows NT APPDIR="c:\work\university\basic" UNIX APPDIR="/usr/work/university/basic" This parameter needs to match the APPDIR parameter in the setenv file. |
TUXCONFIG |
The full directory path of the configuration file. This is the subdirectory of the sample application. The directory path needs to be included in quotation marks. For example: Windows NT TUXCONFIG="c:\work\university\basic\tuxconfig" UNIX TUXCONFIG="usr/work/university/basic/tuxconfig" This parameter needs to match the TUXCONFIG parameter in the setenv file. |
TUXDIR |
The full directory path where you installed the WebLogic Enterprise software. The directory path needs to be included in quotation marks. For example: Windows NT TUXDIR="c:\M3dir" UNIX TUXDIR="/usr/local/M3dir" This parameter needs to match the TUXDIR parameter in the setenv file. |
CLOPT for the ISL process |
Enter the host name and port number of the machine on which the server application is installed. For example: ISL SRVGRP = SYS_GRP SRVID = CLOPT = "-A --n //BEANIE:2500" |
OPENINFO |
If you are using the Transactions, Wrapper, or Production sample applications, you need to specify this parameter for the Oracle database. If you are using a remote instance of the Oracle database, the OPENINFO parameter is specified as follows: OPENINFO = "Oracle_XA:Oracle_XA+SqlNet=aliasname+Acc=P/account For example, on Windows NT: OPENINFO = "Oracle_XA:Oracle_XA+SqlNet=ORCL+Acc=P/scott/ If you are using a local instance of the Oracle database, the OPENINFO parameter is specified as follows: OPENINFO = "Oracle_XA:Oracle_XA+Acc=P For example, on Windows NT: OPENINFO = "Oracle_XA:Oracle_XA+Acc=P |
Before you can use the University sample applications, you need to run the setenv script to ensure your system environment variables reflect all the changes made in the process of setting up the Oracle database and your configuration. Instructions for running the setenv command are included in the descriptions of building the individual sample applications.
Note: The makefiles for the University sample applications assume Microsoft Visual C++ is installed in the following location on Windows NT:
c:\Progra~1\Devstu~1\VC
If your copy of Microsoft Visual C++ is not installed in that directory, run the following command procedure to set the appropriate system environment variables.
c:\Progra~1\Devstu~1\VC\Bin\VCVARS32.bat
The Oracle Pro*C/C++ compiler uses short names so you need to use ~ in the directory path to ensure the system variable is set correctly.
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|