3
Core Installation

This chapter guides you through the installation steps for the Core Edition of Oracle9i Application Server. The following topics provide detailed installation steps, and basic postinstallation tasks:

• Installation

• Postinstallation

Installation

The following instructions guide you through Oracle9iAS Core Edition install.

1. Review the Oracle Universal Installer Welcome screen and click Next.

   Figure 3-1 Welcome Screen

   
   
   Text description of the illustration wel.gif

   The Welcome screen provides information about the Oracle Universal Installer.

   The following function buttons appear on the installation screens.

   • Deinstall Products: Deinstall individual components or the entire product. This button appears only on the Welcome screen.

   • About Oracle Universal Installer: View the version number of the installer in use.

   • Exit: Quit the installation process and exit the installer.

   • Help: Access detailed information about the functionality of each screen.

   • Installed Products: View currently installed products or to deinstall the entire product or components.

   • Previous: Return to the previous screen.

   • Next: Move to the next screen.

2. Verify the source and destination paths and click Next. If you have not previously installed Oracle products on your machine, the "OraInventory Location screen" appears after you click Next. Enter the complete location path for oraInventory directory and click OK.

   Figure 3-2 File Locations Screen

   
   
   Text description of the illustration filloc.gif

   The File Locations screen allows you to enter the full path for the source and destination locations of Oracle9i Application Server.

   • Source: This is the full path to the products.jar file from which the product will be installed. The installer detects and uses the default values of the products.jar file of the installation program. Do not change the path.

   • Destination: This is the full path to the Oracle home where the product will be installed. The installer defaults to the Oracle home set in the preinstallation chapter.

     Note: Oracle home path must be a real, absolute path. It cannot contain symbolic links, environment variables, or spaces.

     For more information regarding Oracle home, refer to "ORACLE_HOME" .

   • Browse: Navigate through the file system to find source and destination locations.

3. This screen appears only the first time you run Oracle Universal Installer on your machine. Take note of the default value if it appears. Enter a UNIX group name and click Next.

   Figure 3-3 UNIX Group Name Screen

   
   
   Text description of the illustration grpnm.gif

   The UNIX Group Name screen grants permission for the oraInventory directory to the group specified. For more information, refer to "UNIX Group Name for the Oracle Universal Installer Inventory" .

   UNIX Group Name:

   • Enter a UNIX group name for those who have permission to configure all the functionality of Oracle9i Application Server. Verify your group name by entering this command from the UNIX prompt the installer was launched from:

     prompt> id
     
     

   • Run the orainstRoot.sh script from your Oracle home to grant permissions to the root user only. You must have root privileges to run this script. The script creates pointers to the components as the installer installs them in the system so that they can be identified later in the installation procedure. It produces the /var/opt/oracle/oraInst.loc file, which provides a pointer to the oraInventory directory.

     After you have run the script, click Retry to continue.

4. Select Core Edition and click Next.

   Figure 3-4 Installation Types Screen

   
   
   Text description of the illustration cinstype.gif

   The Installation Types screen allows you to select the Oracle9i Application Server installation option that you are licensed to use.

   • Core Edition: Oracle9iAS Containers for J2EE, Oracle9iAS Web Cache, and Oracle HTTP Server

   • Minimal Edition: Installs Oracle9iAS Portal, Oracle9iAS Wireless, Oracle Enterprise Manager Client, and Oracle HTTP Server.

   • Standard Edition: Installs Oracle9iAS Portal, Oracle9iAS Wireless, Oracle Enterprise Java Engine, Oracle Enterprise Manager Client, Oracle HTTP Server, and Oracle Internet File System.

   • Enterprise Edition: Installs Oracle9iAS Database Cache, Oracle9iAS Discoverer, Oracle9iAS Forms Services, Oracle9iAS Portal, Oracle9iAS Reports Services, Oracle9iAS Web Cache, Oracle9iAS Wireless, Oracle Enterprise Java Engine, Oracle Enterprise Manager Client, Oracle HTTP Server, Oracle Internet File System, and Oracle Management Server.

5. This screen appears only if Oracle Universal Installer has detected insufficient disk space in the Oracle home directory. If needed, verify and change the locations of the components displayed on the screen, and click Next.

   Figure 3-5 Component Locations Screen

   
   
   Text description of the illustration entcploc.gif

   The Component Locations screen allows you to select alternative locations for some components.

   Note: Insufficient disk space is indicated in red with a hand icon next to it.

   • Show all components to be installed: To view the complete list of components chosen for installation. Select check box to display component list.

   Click individual components to view and change destination location path. The installer enables you to change the destination location of the components displayed on the screen.

   • Destination Location: To view the full path of the selected component.

   • Change Location: To browse for alternate locations for the selected component.

   • Available Disk Space: To view available disk space in the current directory. The installer also provides information about the total disk space required for the installation of additional components.

   • Required Disk Space for directory_name: To view the total disk space required for installation in the selected directory.

   • Total Required Disk Space: To view the total disk space required for the product to be installed.

   • Show all available volumes: To browse through file system for available disk space. Select check box to display the file system.

6. This screen appears if the installer detects insufficient TMP space. Remove unneeded files from the swap directory to provide sufficient space for installation and click Next. If your swap space is smaller than 500 MB, click Exit and correct the problem.

   Figure 3-6 Insufficient Swap Space for Install Screen

   
   
   Text description of the illustration tmpwarn.gif

   The Insufficient Swap Space for Install screen indicated inadequate space in the swap directory. You have two options:

   • If you have more than 500 MB swap space, then remove unneeded files from your swap space to create room for installation and click Next to proceed.

   • If you have less than 500 MB swap space, then Exit the installer and set TMP environment variable to point to a writable directory with sufficient space.

   For detailed information on TMP directory, refer "TMP".

7. Click the Help button to verify that all the preinstallation tasks have been performed, and then click Next.

   Figure 3-7 Installation Overview Screen

   
   
   Text description of the illustration preinsta.gif

   The Installation Overview screen gives you an overview of the installation process. Click on the Help button for information on the installation process, preinstallation checklist, automatic process startup, configuration tools, and frequently asked questions.

8. Select the components you wish to configure during the installation process and click Next. These components will automatically start up after installation. If you wish to configure the components later, do not select them.

   Figure 3-8 Component Configuration and Startup Screen

   
   
   Text description of the illustration c_compst.gif

   The Component Configuration and Startup screen allows you to select the components that you want the installer to configure and start after installation. This screen offers two configuration options:

   • If you select a component here, then the installer prompts you for any or all configuration information required by that component. After installation, the installer starts that component.

   • If you de-select a component here, then the installer installs it, but does not configure or start it. later on, if you decide to use that component, then manually launch the configuration assistant to configure that component.

     See Also: Appendix A, "Configuration Tools"

   You can select or de-select multiple components by holding down the Control key while clicking on the component name.

9. Review the summary and click Install to begin the installation process.

   Figure 3-9 Summary Screen

   
   
   Text description of the illustration coresumm.gif

   The Summary screen allows you to review all the settings before the actual installation process. These settings include source, destination, installation type, product language, space requirements, and a list of components.

   • To make changes to any of these settings, click Previous to return to the respective screens.

     Note: Insufficient disk space is indicated in red under Space Requirements.

   When you click Install, the installation process begins.

10. Monitor the installation process and after the installer finishes, click Next.

    Figure 3-10 Install Screen

    
    
    Text description of the illustration inst.gif

    The Install screen appears while the product is installing. Installation operations include executing actions such as file copy and linking, and executing decision points and calculations. It also displays the full path of the installation log.

    • Cancel: To discontinue the installation process. You can then choose to stop the installation of an individual component or the entire product.

    For more information about installation log, refer to "oraInventory Directory".

    Changing Disks

    During installation, the installer prompts you to switch between Disks 1 through 5. Use these steps to change disks and continue the installation process.

    Figure 3-11 Changing Disks Dialog

    
    
    Text description of the illustration disk2.gif
    1. Eject and unmount the current disk.

       If you are using Solaris Volume Management software and Disk1 was automatically mounted, then this can be done with the following command:

       prompt> eject cdrom
       
       

       If you are not using Solaris Volume Management software, then you must manually eject and unmount the disk. For further instructions, refer to your operating system documentation

    2. Insert the next disk into the CD-ROM drive and mount it.

       If you are using the Solaris Volume Management software, then the next disk will be automatically mounted.

       If you are not using Solaris Volume Management software, then you must manually mount the disk. For further instructions, refer to "Starting Oracle Universal Installer".

    3. Click the Browse button on the changing disks dialog, and navigate to /cdrom/9ias_10222_diskx. This directory may be different depending on where the original disk was mounted.

    4. Click OK to continue the installation process.

    Running root.sh

    After installation is completed, the installer prompts you to run root.sh script. Use these steps to run the root.sh script.

    1. Log on as the root user.

    2. Go to the Oracle home directory.

       prompt> cd ORACLE_HOME
       
       

    3. Run the root.sh script.

       prompt> ./root.sh
       
       

    Once you see "Finished running generic part of the root.sh script" and "Now product-specific root actions will be performed," exit root user and return to the Install screen.

    The root.sh script detects:

    • Settings of ORACLE_OWNER, ORACLE_HOME and ORACLE_SID environment variables.

    • Full path of local bin directory. You can accept the default or change to a different local bin directory.

11. Verify the list of configuration tools and click Next. This screen appears only if you select components to configure and start in the Components Configuration and Startup screen.

    Figure 3-12 Configuration Tools Screen

    
    
    Text description of the illustration ccftool.gif

    The Configuration Tools screen lists the configuration tools for all installed components.

    Scroll down the list to review the configuration status of each tool. The status changes as each component is configured.

    The installer performs the following functions in this screen:

    • Executes a configuration tool for each component selected previously in the Component Configuration and Startup screen.

    • Displays all the configuration settings in the display window below as it executes a configuration tool for each component.

    • Enables you to view configuration settings after all configuration tools are executed. Click on each component to review all the changes made.

    • Allows you to view data for failed executions in the display window. You can either fix the error and click Retry to execute the configuration tool again, or ignore the error and click Next to proceed to the next screen.

    • Retry: To re-execute the configuration script if the configuration of a component fails.

    • Stop: To quit the configuration process.

    Configuration Tools

    This installation option launches the following configuration tools:

    Oracle9iAS Web Cache Configuration Assistant - This launches the service to start Oracle9iAS Web Cache.

    Net8 Configuration Assistant - This configuration assistant enables you to connect and configure the Oracle client/server network environment.

    See Also: Net8 Administrator's Guide in the Oracle Database Documentation Library for information on running Net8 Configuration Assistant.

    Starting HTTP Server - This starts Oracle HTTP Server.

12. Ensure that the installation was successful. Click Exit to quit the installer.

    Figure 3-13 End of Installation Screen

    
    
    Text description of the illustration end.gif

    The End of Installation screen appears at the end of the installation process. It notifies you whether the installation was successful or unsuccessful.

    • Release Information: To view the latest release information.

    If the installer detects that specific port numbers such as 7777, are occupied, it will display the alternate port numbers on the end of Installation screen. For Oracle HTTP Server port number information, refer to "Port Allocation".

You have successfully installed the Core Edition of Oracle9i Application Server. Proceed to "Postinstallation" to complete the installation process.

Postinstallation

The following instructions guide you through the basic postinstallation tasks for Oracle9i Application Server. Before performing these tasks, install, if needed, Oracle9i Application Server Client from the Oracle9i Application Server Administrative and Development Client CD included in the Oracle9i Application Server CD pack.

See Also: Appendix B, "Installing Oracle9i Application Server Administrative and Development Client CD-ROM"

The postinstallation contains the following sections:

• Configuring Oracle9iAS Containers for J2EE

• Starting and Stopping Components

• Component Web Sites

• Component Port Numbers

• Additional Documentation

Configuring Oracle9iAS Containers for J2EE

For Oracle9iAS Containers for J2EE (OC4J) installation and configuration information, refer to Oracle9iAS Containers for J2EE Quick Reference Card located in the Oracle9i Application Server Documentation Library.

Starting and Stopping Components

Table 3-1 lists the commands needed to individually start and stop Oracle HTTP Server.

Table 3-1 Starting and Stopping Components

Component	Function	Command
Oracle9iAS Web Cache	Start	ORACLE_HOME/webcache/bin/webcachectl start
Oracle HTTP Server	Start	ORACLE_HOME/Apache/Apache/bin/apachectl start
	Stop	ORACLE_HOME/Apache/Apache/bin/apachectl stop
Oracle HTTP Server SSL-enabled	Start	ORACLE_HOME/Apache/Apache/bin/apachectl startssl (Log in as root user)
	Stop	ORACLE_HOME/Apache/Apache/bin/apachectl stop (Log in as root user)

Component Web Sites

Table 3-2 lists Web sites for Oracle9i Application Server components.

Table 3-2 Component Web sites

Component	Web Site
Oracle9iAS Web Cache	http://hostname.domain:4000 (Log on as administrator/administrator)
Oracle HTTP Server Oracle HTTP Server (SSL-enabled)	http://hostname.domain:listener_port https://hostname.domain:listener_port

Component Port Numbers

Table 3-3 lists the default port numbers on which requests are received for each component.

Table 3-3 Port Numbers

Components	Port Number
Oracle9iAS Web Cache Oracle9iAS Web Cache Administration Port Oracle9iAS Web Cache Invalidation Port Oracle9iAS Web Cache Statistics Port	1100 4000 4001 4002
Oracle HTTP Server Oracle HTTP Server (SSL-enabled) Oracle HTTP Server Jserv Servlet Engine	For information on port numbers, refer to "Port Allocation". 8007

Additional Documentation

For further information on postinstallation and configuration tasks, refer to component-specific documentation. For information on viewing and installing the documentation, refer to Appendix E, "Installing Documentation Library".