Table of Contents Previous Next PDF


Setting Up Your Environment

Setting Up Your Environment
This topic describes how to configure your CORBA application so that you can run the University sample applications.
This topic includes the following sections:
Notes:
Technical support for third party CORBA Java ORBs should be provided by their respective vendors. Oracle Tuxedo does not provide any technical support or documentation for third party CORBA Java ORBs.
The University sample applications use a database (the University database) to store all the data (for example, course names and course summaries) used in the sample applications. Before you can build and run the University sample applications, you need to install and set up the database.
Note:
For details about the setting up a database, see the product documentation for the database you are using.
System Prerequisites
For information about the operating system platforms supported by the product, see Installing the Oracle Tuxedo System.
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 setenv file sets the system environment variables needed to build and run the sample applications. Each sample application directory contains a unique setenv file. The name of the setenv file designates which sample application the file is to be used with. For example, setenvb is for the Basic sample application. Each sample application directory contains a setenv file for the Windows and UNIX operating systems. For a list of the specific filenames for the setenv file, see Table 2‑1.
The UBBCONFIG file is the configuration file for the sample application. The UBBCONFIG file defines parameters for how the client and server applications in the sample application should work. Each sample application directory contains a unique UBBCONFIG file. The name of the UBBCONFIG file designates which sample application the file is to be used with. For example, ubb_b is for the Basic sample application. Each sample application directory contains a UBBCONFIG file for the Windows and UNIX operating systems. For a list of the specific filenames for the UBBCONFIG file, see Table 2‑1.
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. The bold letter is the identifying letter for the sample application.
 
Table 2‑1 Naming Conventions for setenv and UBBCONFIG Files 
setenvb.cmd—the setenv file for Windows
setenvb.sh—the setenv file for UNIX
ubb_b.nt—the UBBCONFIG file for Windows
ubb_b.mk—the UBBCONFIG file for UNIX
setenvs.cmd—the setenv file for Windows
setenvs.sh—the setenv file for UNIX
ubb_s.nt—the UBBCONFIG file for Windows
ubb_s.mk—the UBBCONFIG file for UNIX
setenvt.cmd—the setenv file for Windows
setenvt.sh—the setenv file for UNIX
ubb_t.nt—the UBBCONFIG file for Windows
ubb_t.mk—the UBBCONFIG file for UNIX
setenvw.cmd—the setenv file for Windows
setenvw.sh—the setenv file for UNIX
ubb_w.nt—the UBBCONFIG file for Windows
ubb_w.mk—the UBBCONFIG file for UNIX
setenvp.cmd—the setenv file for Windows
setenvp.sh—the setenv file for UNIX
ubb_p.nt—the UBBCONFIG file for Windows
ubb_p.mk—the UBBCONFIG file for UNIX
Setting setenv Parameters
Table 2‑2 lists the parameters you need to modify in the setenv file.
 
Table 2‑2 Parameters in the setenv File 
APPDIR=c:\work\university\basic
APPDIR=/usr/work/university/basic
TUXCONFIG=/usr/work/university/basic/tuxconfig
USERID=username/password@aliasname
USERID=username/password
The instance ID of the Oracle database. On Windows, you do not need to specify the ORACLE_SID, the parameter automatically defaults to ORCL.
Setting the UBBCONFIG Parameters
Table 2‑3 lists the parameters you need to modify in the UBBCONFIG file.
 
Table 2‑3 Parameters in the UBBCONFIG File 
APPDIR="c:\work\university\basic"
APPDIR="/usr/work/university/basic"
This parameter needs to match the APPDIR parameter in the setenv file.
TUXCONFIG="c:\work\university\basic\tuxconfig"
TUXCONFIG="usr/work/university/basic/tuxconfig"
This parameter needs to match the TUXCONFIG parameter in the setenv file.
This parameter needs to match the TUXDIR parameter in the setenv file.
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
/password+SesTM=100+LogDir=.+MaxCur=5"
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
/
account/password+SesTM=100+LogDir=.+MaxCur=5"
Running the setenv Command
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 database and your configuration. Instructions for running the setenv command are included in the descriptions of building the individual sample applications.
Note:
c:\Program Files\Microsoft Visual Studio.NET 2003\vc7
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:\Program Files\Microsoft Visual Studio.NET 2003\Common7\Tools\ vsvars32.bat

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.