Skip Headers

Oracle9i Application Server Installation Guide
Release 1 (v1.0.2.2.2) for AIX-Based Systems, Compaq Tru64 UNIX, HP 9000 Series HP-UX, and Linux Intel

Part Number A95909-01
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

A
Configuration Tools

This appendix guides you through the steps required to run component-specific configuration assistants to configure Oracle9i Application Server. It contains instructions on manually launching, and running the following configuration assistants to configure the components you chose not to configure during installation:

Net8 Configuration Assistant

For information on running the Net8 Configuration Assistant, refer to the Net8 Administration Guide in your database documentation library.

Oracle9iAS Database Cache Configuration Assistant

Before you can run the Oracle9iAS Database Cache Configuration Assistant, you need to configure the ora_icache_origin service manually.

  1. Shut down the IntelligentAgent using the following command:

    prompt> ORACLE_HOME/bin/lsnrctl dbsnmp_stop
    
    
  2. Configure the ora_icache origin service manually. The tnsnames.ora in the ORACLE_HOME/network/admin directory has the following entry after installation:

        ora_icache_origin 
          (DESCRIPTION =
            (ADDRESS_LIST =
               (ADDRESS = 
                  (PROTPCOL = TCP) 
                  (HOST = ORIGINHostName) 
                  (PORT = originPortNumber>)
               )
            )
            (CONNECT_DATA =
               (SERVICE_NAME = originServiceName)
            )
          )
    
    

Fill in the origin host name, port and service name in tnsnames.ora file as per the above example before running the following command to launch the Oracle9iAS Database Cache Configuration Assistant:

prompt> ORACLE_HOME/bin/wtacca -create -typical

The following steps guide you through the Oracle9iAS Database Cache Configuration Assistant:

  1. Review the Oracle9iAS Database Cache Configuration Assistant welcome screen and click Next.

Figure A-1 Welcome Screen


Text description of icach1.gif follows.
Text description of the illustration icach1.gif

The Welcome screen introduces you to the Oracle9iAS Database Cache Wizard.

  • Enter the privileged account information and click Next.

    Figure A-2 Origin Database Credentials Screen


    Text description of icach2.gif follows.
    Text description of the illustration icach2.gif

    The Origin Database Credentials screen specifies the database that is the original and primary storage for the data that you cache on the middle-tier node.

  • Review the summary screen and click Finish to configure the cache.

    Figure A-3 Summary Screen


    Text description of icach3.gif follows.
    Text description of the illustration icach3.gif

    The Summary screen provides information about the origin database, cache node, port number, cache name, memory, disk space allocated and file specification.

  • Monitor the Configuration Assistant as it configures your cache.

    Figure A-4 Cache Configuration Assistant Progress Screen


    Text description of n_cach4.gif follows.
    Text description of the illustration n_cach4.gif

    The Cache Configuration Assistant Progress screen informs you of the results of the configuration.

    Oracle9iAS Portal Configuration Assistant

    The following command launches the Oracle9iAS Portal Configuration Assistant:

    prompt> ORACLE_HOME/assistants/opca/launch.sh
    
    

    The following steps guide you through the Oracle9iAS Portal Configuration Assistant:

    1. Choose the first installation option to install Oracle9iAS Portal and the Login Server and click Next.

    Figure A-5 Installation Options Screen


    Text description of portca1.gif follows.
    Text description of the illustration portca1.gif

    The Installation Options screen allows you to install and deinstall Oracle9iAS Portal. Selecting "Install Oracle9iAS Portal and the Login Server" installs the Oracle9iAS Portal schema and the Login Server onto your database.

  • Enter the database connection information and click Next.

    Figure A-6 Database Authentication Screen


    Text description of portca2.gif follows.
    Text description of the illustration portca2.gif

    The Database Authentication screen allows you to specify the database connection information granting the Configuration Assistant database access to install the Oracle9iAS Portal database objects.


    Note:

    Be sure to connect, and store objects in the origin database or any Oracle database that you have access to. Otherwise you will get an error stating that the sys user is locked. 


  • Enter the Oracle9iAS Portal Schema and Oracle9iAS Portal DAD names, and click Next.

    Figure A-7 Oracle9iAS Portal Schema Screen


    Text description of portca3.gif follows.
    Text description of the illustration portca3.gif

    Oracle9iAS Portal Schema screen allows you to enter the Schema and DAD name. These must match the Oracle9iAS Portal Schema and DAD name you entered during the installation process on the Apache Listener Configuration for Oracle9iAS Portal (DAD and Schema name) screen. The default is portal30.

  • Enter the SSO Schema and SSO DAD names for the Login Server, and click Next.

    Figure A-8 Single SIgn-On Schema Screen


    Text description of portca4.gif follows.
    Text description of the illustration portca4.gif

    Single Sign-On Schema screen allows you to enter the SSO Schema and DAD name. These must match the SSO Schema and DAD name you entered during the installation process on the Apache Listener Configuration for Oracle9iAS Portal (Login Server) screen. The default is portal30_sso.

  • Enter the tablespace names for Oracle9iAS Portal installation. Click Next.

    Figure A-9 Tablespace Options Screen


    Text description of portca5.gif follows.
    Text description of the illustration portca5.gif

    Tablespace Options screen allows you to enter the tablespace names for Oracle9iAS Portal. Choose from the list of tablespaces. For more information, refer to Table A-1.

    Table A-1 Tablespace Options
    Field  Description 

    Default Tablespace 

    Used to store any database objects or components created by the Oracle9iAS Portal user.
    Required minimum: 150 MB 

    Temporary Tablespace 

    Improves the concurrence of multiple sort operations, reduce their overhead, or avoid Oracle space management operations altogether. Used for the creation of temporary table segments for operations performed by the Oracle9iAS Portal user such as sorting table rows. 

    Document Tablespaces 

    Used to store any items uploaded onto an Oracle9iAS Portal content area. These item types can include files, images, folders, and stored procedures.

    Note: The Document Tablespace will gradually fill as users add items to Oracle9iAS Portal content area. You should choose a tablespace large enough to accommodate these additions or a tablespace that automatically extends itself. Size the document tablespaces according to the planned size of your content areas. 

    Logging Tablespace 

    Name of the tablespace where the logs are stored. These contain logging information such as end user requests for components and information about the time of the request, the end user who made the request, the machine and browser that was used, and when an Oracle9iAS Portal developer created or last edited the component. Additional logging information includes database storage allocated to users, objects, and tablespaces, memory allocation, object creation dates, objects created during a given time span, rollback segment attributes, session locks, redo logs, and DBMS jobs. 

  • Determine if you want to overwrite or keep the existing PL/SQL Web Toolkit packages. Click Yes or No accordingly.

    Figure A-10 PL/SQL Web Toolkit Screen


    Text description of portca6.gif follows.
    Text description of the illustration portca6.gif

    PL/SQL Web Toolkit screen appears only if the configuration assistant detects that PL/SQL Web Toolkit packages already exist on your machine. Click Yes to overwrite the existing packages, or click No to abort the Oracle9iAS Portal Repository Install.


    Note:

    Oracle9iAS Portal requires the latest version of PL/SQL Web Toolkit packages. If you are unsure if your existing packages are compatible with PL/SQL Gateway, click Yes to install the correct version. 


  • Monitor the progress of the configuration assistant as the database objects are installed.

    Figure A-11 Installing Oracle9iAS Portal Screen


    Text description of portca7.gif follows.
    Text description of the illustration portca7.gif

    Installing Oracle9iAS Portal screen displays a database objects installation progress bar. Please be patient and refrain from using your machine while this is underway. This process may a take long time to complete.

  • Make note of the information, and click OK.

    Figure A-12 Summary Screen


    Text description of portca8.gif follows.
    Text description of the illustration portca8.gif

    Summary screen appears at the end of installation. It reveals information about accessing the Oracle9iAS Portal Home page, Login Server page and the gateway settings page. For your convenience, make note of this information before clicking OK.

  • An installation session log that describes the actions performed and the components installed is created. You can check the log file for ORA and PLS errors that may have occurred during installation. The log file is located in the following locations:

    ORACLE_HOME/assistants/opca/install.log
    

    Oracle Database Configuration Assistant

    The following command launches the Oracle Database Configuration Assistant:

    prompt> ORACLE_HOME/bin/dbassist
    
    

    The Oracle Database Configuration Assistant creates a database that is used as a container for Oracle Enterprise Java Engine. You might see more screens if you launch the Oracle Database Configuration Assistant manually.The following screen appears as the configuration assistant creates the database:

    Figure A-13 Oracle Database Configuration Assistant Screen


    Text description of dbca.gif follows.
    Text description of the illustration dbca.gif

    Oracle Database Configuration Assistant does not require any user input. Once the database creation process ends, the following screen appears.

    Figure A-14 Database Information Screen


    Text description of dbconf.gif follows.
    Text description of the illustration dbconf.gif

    The Database Information screen displays database information such as global database name, database SID, SYS account password, and SYSTEM account password. Make a note of this information and click OK. You have completed the database creation process.

    Oracle Internet File System Configuration Assistant

    The following command launches the Oracle Internet File System Configuration Assistant:

    prompt> ORACLE_HOME/ifs1.1/bin/ifsconfig
    
    


    Note:

    Be sure that the origin database is running to store the Oracle Internet File System schema. You must have a TNS name that maps to that database instance.  


    The following steps guide you through the Oracle Internet File System Configuration Assistant:

    1. Review the Welcome screen and click Next.

    Figure A-15 Welcome Screen


    Text description of ifs1.gif follows.
    Text description of the illustration ifs1.gif

    The Welcome screen introduces you to the Oracle Internet File System Configuration Assistant and allows you to review the licensing agreement before you can proceed to configure Oracle Internet File System.

  • Select the database to store Oracle Internet File System, and click Next.

    Figure A-16 Select Oracle Database Screen


    Text description of ifs2.gif follows.
    Text description of the illustration ifs2.gif

    Select Oracle Database screen allows you to choose where the Oracle Internet File System schema will be stored. Select whether the origin database is on the local machine or on the remote machine other than the Oracle Internet File System server machine currently being configured.


    Note:

    Be sure to connect, and store objects in the origin database or any Oracle8i database that you have access to. Otherwise you will get an error stating that the sys user is locked. 


    If you select Oracle8i on THIS machine, then you will have to fill in the SYS password field.

    If you select Oracle8i on another machine, then you will have to enter the TNS service name and the SYS password in their respective fields.

    If an error occurs, you will be required to correct the database connection information before continuing.

  • Choose to create a schema or reuse an existing one, and click Next.

    Figure A-17 Select iFS Schema Screen


    Text description of ifsn1.gif follows.
    Text description of the illustration ifsn1.gif

    The Select iFS Schema screen allows you to either create a new iFS schema or select from a list of existing iFS schemas that have been found on the database identified by the TNS service name you specified.

    If you are using an Oracle9i database as the backend database

    If you are using an Oracle 8.1.7 database as the backend database

    If you select "Create a new iFS schema", then click Next to proceed with the instructions provided.

    If you select "Reuse an existing iFS schema", then click Next. The following screens will appear:

    1. Select Existing iFS Schema screen: This screen informs you of all the existing iFS schemas found on the database identified by the TNS service name you specified. Select an existing schema from the menu and enter its password, and click Next.

    2. Set iFS Options screen: This screen allows set various iFS options. Set the necessary options, and click Next.

    3. Configure iFS Email screen: This screen provides you with options to configure your iFS email. Select the necessary options, and click Next.

    4. Configuring iFS screen: This screen displays the various configuration tasks. Click Cancel to stop the configuration.

    5. iFS Configuration Completed screen: This screen appears when the configuration completes. It prompts you to run the ifssetup script as an admin user. The script is located in the ORACLE_HOME/ifs1.1/bin directory. This script will configure your system for Oracle Internet File System email, if this option was selected.

    6. Perform the following steps to configure Oracle HTTP Server:

      Stop Oracle HTTP Server.

      prompt> ./apachectl stop
      
      

      Run the following script:

      prompt> ORACLE_HOME/ifs1.1/bin/ifsapachesetup
      
      

      Be sure to run this script as the user who owns the Oracle software.


      See Also:

      "UNIX Account to Own Oracle Software" for more information. 


      Restart Oracle HTTP Server.

      prompt> ./apachectl start
      
      
    7. Restart the Oracle Internet File System as the root user using the ifsstart script.

    You have completed configuring Oracle Internet File System.

  • Enter an Oracle database username and password for a new schema, and click Next.

    Figure A-18 Create New iFS Schema Screen


    Text description of ifs4.gif follows.
    Text description of the illustration ifs4.gif

    Create New iFS Schema screen allows you to specify an Oracle database username and password for the new schema.

    If you choose to create a new schema with the same name as an existing schema, a warning message appears. Creating a new schema with the same name as an existing schema will drop the existing schema.

  • Set the necessary Oracle Internet File System options, and click Next.

    Figure A-19 Set iFS Options Screen


    Text description of ifs6.gif follows.
    Text description of the illustration ifs6.gif

    Set iFS Options screen allows you to set certain schema options and to select a service size for your Oracle Internet File System server. There are two choices for the Oracle Internet File System server size:

    If you are creating a new Oracle Internet File System schema, then you can choose whether to use standard tablespace parameters, or to specify custom tablespace parameters.

    If you have chosen to use interMedia Text, the Configuration Assistant will verify the interMedia configuration when you click the Next button. If an error occurs. then you will not be able to choose the interMedia Text option unless you rectify the error.

  • Enter the Protocol Instance Name, and click Next.

    Figure A-20 Server Manager Options Screen


    Text description of ifs7.gif follows.
    Text description of the illustration ifs7.gif

    Server Manager Options screen allows you to enter a name for the Protocols Server Manager Instance that will run on this Oracle Internet File System server.

  • Select the default character set and indexing language, and click Next.

    Figure A-21 Language Options Screen


    Text description of ifs8.gif follows.
    Text description of the illustration ifs8.gif

    Language Options screen allows you to select the Character set and indexing language for this Oracle Internet File System server.

  • Select the required Oracle Internet File System protocol serves, and click Next.

    Figure A-22 Select iFS Protocol Servers Screen


    Text description of ifs9.gif follows.
    Text description of the illustration ifs9.gif

    Select iFS Protocol Servers screen allows you to select the protocol servers to configure for this Oracle Internet File System server. The following protocol servers are available:

  • Select the port numbers for the Oracle Internet File System protocol servers, and click Next.

    Figure A-23 Set iFS Protocol Server Ports Screen


    Text description of ifs10.gif follows.
    Text description of the illustration ifs10.gif

    Set iFS Protocol Server Ports screen allows you to set port numbers for the protocol servers you selected in the previous screen. The following is a list of protocol servers and their default port numbers:

    When you click the Next button, the port availability on your computer is tested. If a port is already in use, a warning screen appears. A common port conflict can arise because the standard UNIX installation includes a FTP server on port 21, which conflicts with the Oracle Internet File System FTP server. You must resolve such conflicts before starting the Oracle Internet File System protocol servers.

  • Enter your Oracle Internet File System Email Domain, and click Next.

    Figure A-24 Configure iFS Email Screen


    Text description of ifs12.gif follows.
    Text description of the illustration ifs12.gif

    Configure iFS Email screen allows you to enter the iFS Email domain.

  • Review the screen and click Configure to begin the Oracle Internet File System configuration process.

    Figure A-25 Begin iFS Configuration Screen


    Text description of ifs13.gif follows.
    Text description of the illustration ifs13.gif

    Begin iFS Configuration screen informs the users of the configuration process, and displays the location for the log files.

    Once you have started the configuration process, a progress window appears. indicating the progress of the Oracle Internet File System configuration. If an error occurs, check the log files that are displayed on the Begin iFS Configuration screen.

  • A dialog box appears noting that the configuration was successfully completed. Run the ifssetup script as a root user.

    The script is located in the ORACLE_HOME/ifs1.1/bin directory. This script will configure your system for Oracle Internet File System email, if this option was selected.

  • Perform the following steps to configure Oracle HTTP Server:

    1. Stop Oracle HTTP Server.

      prompt> ./apachectl stop
      
      
    2. Run the following script:

      prompt> ORACLE_HOME/ifs1.1/bin/ifsapachesetup
      
      

    Be sure to run this script as the user who owns the Oracle software.


    See Also:

    "UNIX Account to Own Oracle Software" for more information. 


  • Restart Oracle HTTP Server.

    prompt> ./apachectl start
    
    
  • Start the Oracle Internet File System as root using the ifsstart script.

    You have completed configuring Oracle Internet File System.

    Oracle Management Server Configuration Assistant

    The following command launches the Oracle Enterprise Manager Configuration Assistant:

    prompt> ORACLE_HOME/bin/emca
    
    

    The following steps guide you through the Oracle Enterprise Manager Configuration Assistant:

    1. Select "Create a new repository" and click Next.

    Figure A-26 Configuration Operation


    Text description of emca1.gif follows.
    Text description of the illustration emca1.gif

    Configuration Operation Screen allows you to create, drop, or upgrade a repository. It also enables you to edit your configuration parameters.

  • Enter the host name, password, and service information, and click Next.

    Figure A-27 Select Database for Repository Screen


    Text description of emca2.gif follows.
    Text description of the illustration emca2.gif

    Select Database for Repository screen allows you to enter database information for the management server's repository. Be sure to log in as a user with DBA privileges.

  • Enter the repository login information, and click Next.

    Figure A-28 Repository Login Information Screen


    Text description of emca3.gif follows.
    Text description of the illustration emca3.gif

    Repository Login Information screen allows you to enter the login username and password for the database user.

  • Select to either create a new OEM_REPOSITORY tablespace, or use an existing tablespace, and click Next.

    Figure A-29 Select Repository User Tablespaces Screen


    Text description of new_oem.gif follows.
    Text description of the illustration new_oem.gif

    Select Repository User Tablespaces screen allows you to choose between creating a new OEM_REPOSITORY tablespace, or using an existing one.

  • Review the repository summary, and click Finish.

    Figure A-30 Create Repository Summary


    Text description of new_oem1.gif follows.
    Text description of the illustration new_oem1.gif

    Create Repository Summary screen displays all your repository settings. Be sure to verify them for accuracy.

  • Monitor the repository creation process, and click Close when it finishes.

    Figure A-31 Configuration Screen


    Text description of emca6.gif follows.
    Text description of the illustration emca6.gif

    Configuration screen indicates the progress the configuration assistant has made as it creates the repository. Click on Show Details if you get an error.


  • Go to previous page Go to next page
    Oracle
    Copyright © 2001 Oracle Corporation.

    All Rights Reserved.
    Go To Table Of Contents
    Contents
    Go To Index
    Index