3.8 Step 6: Create a Configuration File

Because the Oracle Tuxedo software offers great flexibility and many options to application designers and programmers, no two CORBA applications are alike. An application, for example, may be small and simple (a single client and server running on one machine) or complex enough to handle transactions among thousands of client and server applications. For this reason, for every Oracle Tuxedo CORBA application being managed, the system administrator must provide a configuration file that defines and manages the components (for example, domains, server applications, client applications, and interfaces) of that application.

When system administrators create a configuration file, they are describing the Oracle Tuxedo CORBA application using a set of parameters that the Oracle Tuxedo software interprets to create a runnable version of the application. During the setup phase of administration, the system administrator’s job is to create a configuration file. The configuration file contains the sections listed in the following table.

Table 3-5 Sections in the Configuration File for Oracle Tuxedo CORBA Applications

Sections in the Configuration File	Description
RESOURCES	Defines defaults (for example, user access and the main administration machine) for the Oracle Tuxedo CORBA application.
MACHINES	Defines hardware-specific information about each machine running in the Oracle Tuxedo CORBA application.
GROUPS	Defines logical groupings of server applications or CORBA interfaces.
SERVERS	Defines the server application processes (for example, the Transaction Manager) used in the Oracle Tuxedo CORBA application.
SERVICES	Defines parameters for services provided by the Oracle Tuxedo application.
INTERFACES	Defines information about the CORBA interfaces in the Oracle Tuxedo CORBA application.
ROUTING	Defines routing criteria for the Oracle Tuxedo CORBA application.

The following code snippet depicts the configuration file for the Simpapp sample application.

*RESOURCES
       IPCKEY     55432
       DOMAINID   simpapp  
       MASTER     SITE1
       MODEL      SHM
       LDBAL      N
*MACHINES
       "PCWIZ"
       LMID         = SITE1
       APPDIR       = "C:\TUXDIR\MY_SIM~1"
       TUXCONFIG    = "C:\TUXDIR\MY_SIM~1\results\tuxconfig"
       TUXDIR       = "C:\TUXDIR"
       MAXWSCLIENTS = 10
*GROUPS
       SYS_GRP
       LMID     = SITE1
       GRPNO    = 1
       APP_GRP
       LMID     = SITE1
       GRPNO    = 2
*SERVERS
       DEFAULT:
          RESTART = Y
          MAXGEN  = 5
       TMSYSEVT
          SRVGRP  = SYS_GRP
          SRVID   = 1
       TMFFNAME
          SRVGRP  = SYS_GRP
          SRVID   = 2
          CLOPT   = "-A -- -N -M"
       TMFFNAME
          SRVGRP = SYS_GRP
          SRVID  = 3
          CLOPT  = "-A -- -N"
       TMFFNAME
          SRVGRP = SYS_GRP
          SRVID  = 4
          CLOPT  = "-A -- -F"
      simple_server
          SRVGRP  = APP_GRP
          SRVID   = 1  
          RESTART = N
      ISL
         SRVGRP   = SYS_GRP
         SRVID    = 5
         CLOPT    = "-A -- -n //PCWIZ:2468"
*SERVICES