B Administering Oracle9i Application Server CC

Environment Setup

Oracle9iAS CC generates an environment setup script in the path, $HOME/profile.iascc_env. You can use this script to set up environment variables required for Oracle9iAS CC. You must use the Korn shell to run the script.

To run the environment setup script, and enter the following command:

$. $HOME/profile.iascc_env

If your system has only one ORACLE_HOME, then the script will set up the environment for that ORACLE_HOME.

If your system has multiple Oracle homes, then the script lists all of the available Oracle homes, and prompts you to select the one for which you want to set up the environment.

If you choose to set up an environment during login, then you can provide a link to the profile.iascc_env script in $HOME/.bash_profile file or $HOME/.profile file, so that the environment will be set each time that you log in.

Starting and Stopping Oracle9iAS Services

After you set up the environment for an Oracle9iAS ORACLE_HOME as described in Environment Setup, you can start or stop Oracle9iAS services.

To start all Oracle9iAS services in an ORACLE_HOME, use the following command:

$ORACLE_CC_ROOT/etc/rc.oracle/startias.sh ORACLE_HOME

In the example above, the variable ORACLE_HOME is the full path of the ORACLE_HOME directory in which you want to start the Oracle9iAS services.

To stop all Oracle9iAS services in an ORACLE_HOME, use the following command:

$ORACLE_CC_ROOT/etc/rc.oracle/stopias.sh ORACLE_HOME

In the example above, the variable ORACLE_HOME is the full path of the ORACLE_HOME directory in which you want to stop the Oracle9iAS services.

Table B-1, "Components Started by Default on Oracle9iAS Middle-Tier" lists the components started by default on the Oracle9iAS server.

In addition, Oracle Enterprise Manager is started if the current ORACLE_HOME contains an active Enterprise Manager deployment.

If you want to start Oracle9iAS services automatically on system reboot, then you must put the start command in the system startup script. Ensure that you started Oracle9iAS Infrastructure processes (database, Net listener, Oracle Internet Directory (OiD), Oracle Single Sign-On (SSO)) before you start the Middle-Tier.

Sequence of Starting and Stopping the Oracle9i Application Server Processes

To start or stop the complete instance of Oracle9i Application Server, the instructions in the following sections.

Using Enterprise Manager Web Site

The Oracle Enterprise Manager Web site (EMD) provides Web-based management tools designed specifically for Oracle9iAS. Using the Web site, you can monitor and configure the components of your Oracle9iAS installations. You can deploy applications, manage security, and create and manage Oracle9iAS clusters.

Ensure that the Enterprise Manager Web site is running by entering the following command in the Oracle9iAS ORACLE_HOME with the active Enterprise Manager deployment:

$ emctl status

If the Enterprise Manager Web site is running, then it returns the following message:

EMD is up and running: 200 OK

If the Enterprise Manager Web site is not running, then use the following command to start it:

$ emctl start

After Enterprise Manager is started, use the following procedure to log in to the Enterprise Manager Web site:

1. Enter the following address in your Web browser:

   http://hostname:portnumber/
   
   

   where the variable hostname is the name of the Oracle9iAS server, and the port number is the port number of the Enterprise Manager Web site. By default, that port number is 1810.

   For example, if you install Oracle9iAS in a host called SYS12, then enter the following address in your Web browser:

   http://SYS12:1810
   
   

2. Enter the Oracle9iAS administrator user name and password.

   The user name for the administrator user is ias_admin. You provide the password during Oracle9iAS installation.

3. Click OK.

   Depending on the components you configured and the choices you made during Oracle9iAS installation, Enterprise Manager displays the appropriate Home Page.

   
   

   See Also: For details on how to administer and manage an Oracle9iAS instance, refer to Oracle9i Application Server Administrator’s Guide Release 2 (9.0.2), which is available at the following Web site: >http://iasdocs.us.oracle.com/iasdl/doc/core902/a92171/toc.htm

   
   

Enabling and Disabling Oracle9i Application Server Mid-Tier Services

You can set the Oracle9iAS CC mid-tier Oracle home that is associated with a Oracle9i Application Server Infrastructure to one of the following configuration types:

• Business Intelligence and Forms

• J2EE and Web Cache with Infrastructure

• Oracle Portal and Wireless

Once you set the Oracle home to one of the deployment types above, the startup and shutdown scripts will only control the components for that configuration type. Table B-1, "Components Started by Default on Oracle9iAS Middle-Tier", lists the processes that startias.sh will bring up and stopias.sh will shutdown.

In order to change the mid-tier configuration type, shut down all the mid-tier processes using stopias.sh. Then use the following command:

$ORACLE_CC_ROOT/ias/902/set_iasconfig_type.sh <$ORACLE_HOME> <DEPLOY TYPE>

In the example above <DEPLOY TYPE> is one of the following:

• CC_MT_BIF

• CC_MT_J2EEWC_USEINFRA

• CC_MT_PTLWI

After you change the configuration type, restart the mid-tier using startias.sh. All components for the new configuration type should start.

Configuring a Virtual Hostname for Oracle9iAS CC 9.0.2

Virtual server configurations are Oracle Home based. The scripts are at /admin/mwcc/clone/scripts/reconfig_to_vname.sh. By default log files are in the /tmp directory unless you set the LOGDIR environment variable to a different directory. Log file name is reconfig_to_vname.<process_id>.log.

You need to configure infrastructure Oracle home before the Oracle9i Application Server mid-tier Oracle home.

Use the following procedure to configure Oracle9iAS Infrastructure mid-tier:

1. Log in as the Infrastructure Oracle home owner.

2. Run the /admin/mwcc/clone/scripts/reconfig_to_vname.sh script. When prompted, enter the necessary parameters.

3. If the script finishes successfully, verify that you can access the SSO using the virtual server name that you provided. If the script fails, check the log file. Fix any errors and rerun the script.

Use the following procedure to configure Oracle9iAS mid-tier:

1. Log in as Oracle9i Application Server mid-tier Oracle home owner.

2. Run the /admin/mwcc/clone/scripts/reconfig_to_vname.sh script. When prompted, enter the necessary parameters. For the SSO Server name, use the virtual server name and port that you used when configuring the Infrastructure mid-tier.

3. If the script finishes successfully, verify that you can access the default home page using the virtual server name. If the script fails, check the log file. Fix any errors and rerun the script.