5
Oracle9iAS Developer Kits

This chapter guides you through the steps for the Oracle9iAS Developer Kits installation. The topics include:

• Oracle9iAS Developer Kits Installation

• Oracle9iAS Developer Kits Postinstallation

5.1 Oracle9iAS Developer Kits Installation

The following instructions guide you through the Oracle9iAS Developer Kits installation of Oracle9i Application Server (Oracle9iAS).

Table 5-1 lists required information for Oracle9iAS Developer Kits installation. Enter your values for the listed information in the Your Information column before beginning.

Table 5-1 Installation Information 

Information	Example Values	Your Information
Oracle base directoryFoot 1 (Section 2.5.3.1, "ORACLE_HOME")	/private/oraInventory
Oracle home location (Section 2.5.3.1, "ORACLE_HOME")	/private/ora9ias
Instance Name (Section 2.5.3.1, "ORACLE_HOME")	instance1
ias_admin Password (Section 2.5.3.1, "ORACLE_HOME")	oracle1

1 Required for first time installation of Oracle9iAS.

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

   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 deinstall the entire product or components.

   • Previous: Return to the previous screen.

   • Next: Proceed to the next screen.

2. Verify the location of the base directory for installation files and click OK.

   Figure 5-1 Inventory Location Screen

   

   Text description of the illustration inventoryloccommon.gif

   The Inventory Location screen appears during the first installation on a host to set a location for installation files. Product components use a different directory. The installation files can vary in size depending on the complexity of the product. For file storage considerations, assume a file size of 150 KB per product.

   • Browse: Navigate through the available directory to select a location for the base directory for your installation.

   The base directory has the following attributes:

   • Contains the permanent and per-product component files in subdirectories

   • Must be writable by anyone in the same user group installing or deinstalling products on the install computer

   Input where you would like the base directory to be stored. For example:

   /private
   

   The storage location for product component files is the Components directory. For example:

   /private/oraInventory/Components
   

   • You need root privileges to execute certain actions before the installation can continue. You need to run a shell script with root privileges that is stored in the orainstRoot.sh file. (You may need to execute the shell script by typing "./" before orainstRoot.sh). The Root.sh installation screen shows the location of the orainstRoot.sh file. 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 execute the shell script, continue with the installation process.

3. Verify the source path, destination name, and destination path for your Oracle9iAS installation and click Next.

   Figure 5-2 File Locations Screen

   

   Text description of the illustration fileloc.gif

   The File Locations screen allows you to enter the full path for the source and destination locations for your installation.

   • 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.

   • Name: Enter an Oracle home name or select a name from the drop-down list. You may use the default Oracle home name of ora9ias provided or select your own name. If you do not have a home created on your computer, one is created for you during the installation.

     Oracle homes are identified by name. The Oracle home name identifies the program group associated with a specific Oracle home and the installed Oracle services associated with the home.

     The Oracle home name must consist of 1 to 16 characters long and can only include alphanumeric characters and underscores; spaces are not allowed.

   • 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: The Oracle home path must be an absolute path. It cannot contain environment variables or spaces.

     See Also: Section 2.5.3.1, "ORACLE_HOME"

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

4. Select the Oracle9iAS Developer Kits install type and click Next.

   Figure 5-3 Available Products Screen

   

   Text description of the illustration availableprodsdevkit.gif

   Oracle9iAS Developer Kits: Installs Oracle XML Developer's Kit, Oracle9iAS Portal Developer's Kit, Oracle9iAS Wireless Developer's Kit, Oracle LDAP Developer's Kit.

   Oracle9iAS Developer Kits also installs a J2EE and Web Cache instance that can be used in a testing environment.

   • Product Languages: Select product language for installation. The languages available for this product are Arabic, Bengali, Brazilian Portuguese, Bulgarian, Canadian French, Catalan, Croatian, Czech, Danish, Dutch, Egyptian, English, English (United Kingdom), Estonian, Finnish, French, German, Greek, Hebrew, Hungarian, Icelandic, Indonesian, Italian, Japanese, Korean, Latin American Spanish, Latvian, Lithuanian, Malay, Mexican Spanish, Norwegian, Polish, Portuguese, Romanian, Russian, Simplified Chinese, Slovak, Slovenian, Spanish, Swedish, Thai, Traditional Chinese, Turkish, Ukrainian, and Vietnamese. The default language is English.

     See Also: Appendix E, "Components"

5. One of the following screens appears based on whether an Oracle9iAS installation has been installed on this host:
   • Create Instance Name and ias_admin Password: This screen appears if this is a first time installation of Oracle9iAS on this host.

   • Enter ias_admin Password: This screen appears if the Oracle Universal Installer has detected a previous installation of Oracle9iAS in your Oracle home.

   • Create Instance Name: This screen appears if the Oracle Universal Installer has detected a previous installation of Oracle9iAS on this host but in a different Oracle home.

   The following terms may be used on the following three screens:

   Instance Name: Identifies the installation instance of Oracle9iAS Developer Kits on this host.

   ias_admin Password: The ias_admin users password used to administer any Oracle9iAS on this host. This password is required for installation of additional Oracle9iAS instances.

   1. Create Instance Name and ias_admin Password

      Enter a unique Oracle9iAS Developer Kits instance name and ias_admin password and click Next.

      Figure 5-4 Create Instance Name and ias_admin Screen

      

      Text description of the illustration createinstance.gif

      This screen appears if this is a first time installation of Oracle9iAS on this host.

      Enter a unique name in the instance name field for this installation of Oracle9iAS Developer Kits. The instance name must contain alphanumeric and underscore characters only.

      Select an ias_admin password for this instance of Oracle9iAS Developer Kits and then re-enter the password for confirmation. The ias_admin password must consist of at least five alphanumeric characters. Additionally, at least one of the characters must be a number.

      The unique instance name will be used to identify this installation of Oracle9iAS Developer Kits on the install host.

      The ias_admin password allows you to:

      • Manage all instances of Oracle9iAS across the install host

      • Run management tools

      • Facilitate future installations

      • Access the Oracle Enterprise Manager Home Page

   2. Enter ias_admin Password

      Enter your Oracle9iAS ias_admin password and click Next.

      Figure 5-5 Enter ias_admin Password Screen

      

      Text description of the illustration manage.gif

      If the Oracle Universal Installer detects a previous installation of Oracle9iAS in your Oracle home, this screen appears. The existing Oracle9iAS instance name will be used for this installation. Enter your existing Oracle9iAS ias_admin password for this host to continue with the installation.

      If you forget your ias_admin users password following installation, refer to the Oracle9i Application Server Administrator's Guide for the steps you can follow to reset the password.

   3. Create Instance Name

      Enter a unique Oracle9iAS instance name and the ias_admin password and click Next.

      Figure 5-6 Create Instance Name Screen

      

      Text description of the illustration createinstance2.gif

      If the Oracle Universal Installer has detected a previous installation of Oracle9iAS on this host but in a different Oracle home, this screen appears. Enter a unique instance name and the existing ias_admin password for this host to continue with the installation. The instance name must contain alphanumeric and underscore characters only.

      If you forget your ias_admin users password following installation, refer to the Oracle9i Application Server Administrator's Guide for the steps you can follow to reset the password.

6. Review the Summary screen and click Install to begin the installation process.

   The Summary screen allows you to review all the settings before the installation begins. These settings include source, destination, installation type, product language, install file sizes, 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.

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

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

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

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

   Running root.sh

   During installation of Oracle9iAS, the installer prompts you to run the root.sh script.

   Use the following steps to run the root.sh script.

   1. Log on as the root user.

   2. Run the root.sh script in the Oracle home directory.

      prompt> ORACLE_HOME/root.sh
      

      You may need to execute the shell script by typing "./" before root.sh.

   3. Exit root user.

      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.

8. Review the status of Oracle9iAS configuration tools and click Next.

   The Components Configuration and Startup screen appears for components to configure and start. The screen lists the configuration tools for all installed components.

   Depending on the configurations selected you will see some component configuration screens, but no input is required.

   Monitor the progress of each configuration tool by scrolling down the tools 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.

   • 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: Re-executes the configuration script if the configuration of a component fails.

   • Stop: Quits the configuration process.

   • Exit: Quit the configuration tool and continue with the installation.

9. Review the End of Installation screen. Click Exit to quit the installer or click Next Install to install additional Oracle9iAS instances.

   Figure 5-7 End of Installation Screen

   

   Text description of the illustration eoidevkit.gif

   The End of Installation screen appears at the end of the installation process. It notifies you whether the installation was successful or unsuccessful and provides information about accessing the Oracle9iAS instance.

   The End of Installation screen displays the URL and port number for accessing the Oracle HTTP Server page and the Oracle Enterprise Manager Web site. The default Oracle HTTP Server page is the Oracle9iAS Welcome page. The Oracle9iAS Welcome page provides links to demonstrations and information about new features.

   See Also: Section 5.2.1, "Starting Oracle Enterprise Manager Web site" Oracle9i Application Server Administrator's Guide

   You can view the Install Log for the completed installation at:

   /your_base_directory/oraInventory/logs/installActiontodays_date_time.log
   

   in which your_base_directory is the location for your installation files and todays_date_time is the date and time of installation.

   A complete listing of log files is included in the Oracle9i Application Server Administrator's Guide.

   You have successfully installed Oracle9iAS Developer Kits. Proceed to Section 5.2, "Oracle9iAS Developer Kits Postinstallation" to complete the installation process.

5.2 Oracle9iAS Developer Kits Postinstallation

The following instructions guide you through the basic postinstallation tasks for Oracle9iAS Developer Kits.

The postinstallation contains the following sections:

• Starting Oracle Enterprise Manager Web site

• Starting and Stopping Components

• Component Port Numbers

• Additional Oracle9iAS Product Installations

• Additional Documentation

5.2.1 Starting Oracle Enterprise Manager Web site

The Oracle Enterprise Manager Web site is available after Oracle9iAS Developer Kits installation and component configuration. The Oracle Enterprise Manager Web site is comprised of Oracle Enterprise Manager Home Pages. Each Oracle Enterprise Manager Home Page is used to manage an installed Oracle9iAS component or instance.

Oracle strongly recommends that you use the Secure Socket Layer (SSL) protocol and HTTPS for all connections to the Oracle Enterprise Manager Web site. Refer to the Oracle9i Application Server Administrator's Guide for setup information.

5.2.2 Starting and Stopping Components

Oracle9iAS components can be started and stopped using the Oracle Enterprise Manager Home Page. For information on manual starting and stopping of Oracle9iAS components refer to the component specific documentation.

5.2.3 Component Port Numbers

Following installation, the Oracle Universal Installer creates a file showing the port assignments during installation of Oracle9iAS components. The installation process automatically detects any port conflicts and chooses an alternate port in the range allocated for that component. Appendix F, "Default Port Numbers and Port Ranges" lists the default port ranges. The file portlist.ini is located at:

OracleHome/install/portlist.ini

This file lists component entries as "port name = port value". For example:

Oracle HTTP Server port = 7777
Oracle HTTP Server SSL port = 4443
Oracle HTTP Server listen port = 7778
Oracle HTTP Server SSL listen port = 4444
Oracle HTTP Server Jserv port = 8007
Enterprise Manager Servlet port = 1810

You can also view the port numbers by pointing your browser to the Oracle9iAS Welcome page and selecting the Ports tab

Note: The Oracle Universal Installer uses the port numbers for select components during installation of Oracle9iAS. If you are planning on adding additional Oracle9iAS instances, make sure the installed instances are running at the time of additional installation.

See Also: Section 5.2.1, "Starting Oracle Enterprise Manager Web site" Appendix F, "Default Port Numbers and Port Ranges" Section 2.5, "Preinstallation Tasks" Oracle9i Application Server Administrator's Guide

5.2.4 Additional Oracle9iAS Product Installations

For information regarding installation of additional Oracle9iAS installations, refer to Section 2.8, "Additional Oracle9iAS Product Installations", and Chapter 7, "Coexistence".

5.2.5 Additional Documentation

For further information on postinstallation and configuration tasks, refer to the Oracle9i Application Server Administrator's Guide and component-specific documentation. For information on viewing and installing the documentation, refer to Appendix G, "Installing the Documentation Library".