Oracle Application Server Quick Installation and Upgrade Guide 10g (9.0.4) Part Number B10936-01 |
|
Quick Installation and Upgrade Guide
10g (9.0.4) for Solaris Operating System (SPARC)
Part No. B10936-01
December 2003
Oracle Corporation recommends reviewing the Oracle Application Server 10g Installation Guide and the Oracle Application Server 10g Release Notes before installing Oracle Application Server in a production environment or if there is an existing Oracle software installation on the computer
This Oracle Application Server Quick Installation Guide describes procedures for installing the following Oracle Application Server installation types:
Table 1 shows the contents of the Oracle Application Server Quick Installation Guide:
If you are installing on a computer with an existing Oracle home, Oracle recommends that you read the Oracle Application Server 10g Installation Guide and the Oracle Application Server 10g Release Notes before installation. To determine whether an Oracle installation exists, check whether the
Note:
/var/opt/oracle/oraInst.loc
file exists.
This section describes pre-installation requirements for installation of Oracle Application Server. Oracle recommends that you review and complete the tasks listed in the following sections:
Check that your computer meets the following disk space and memory requirements:
Java Developer Topology | Portal and Wireless Middle Tier | OracleAS Infrastructure 10g | |
---|---|---|---|
Operating system |
Solaris 8, Solaris 9 |
Solaris 8, Solaris 9 |
Solaris 8, Solaris 9 |
To determine the amount of memory, use the
|
(524288 kb) |
(1048576 kb) |
(1048576 kb) |
Disk spaceFootref 1
To determine the amount of free disk space, use the
|
(460800 kb) |
(998400 kb) |
(2726298 kb) |
Space in |
(153600 kb) |
(153600 kb) |
(153600 kb) |
Swap spaceFootref 2
To determine the amount of available swap space, use the The value in the "free" column indicates the number of free blocks, where a block is 512 bytes. To convert blocks to KB, divide the number by 2. For example, 2,000,000 free blocks is equivalent to 1,000,000 KB. |
(1572864 KB) |
(1572864 KB) |
(1572864 KB) |
dir
with the Oracle Application Server destination directory or with the parent directory if the destination directory does not exist yet. For example, if you plan to install Oracle Application Server in /opt/oracle/infra, you can replace dir with opt/oracle or /opt/oracle/infra.
prompt> su Password: root_user_password prompt> mkfile sizem swap_file_name
Append an "m" to the size to specify the size in megabytes (example: 600m
). The minimum size of this file must be greater than the difference between the currently available swap space and required swap space. For example, if you have 100 MB of free swap space, then this swap file must be at least 640 MB for a Java Developer topology consisting of a J2EE and Web Cache installation.
prompt> /usr/sbin/swap -a swap_file_name
/etc/vfstab
file. If you do not add this line, the new swap space will not persist when you reboot the computer.
/path/to/swap/file - - swap - no -
Replace /path/to/swap/file
with the location of the swap file.
prompt> /usr/sbin/swap -s
See Also:
Oracle Application Server 10g Installation Guide for additional system hardware requirements. |
Check that your computer has the operating system patches (or later versions of these patches) listed in the following sections:
To get a list of patches installed on your computer:
showrev
command with the -p
option. The following command saves the sorted output to a file called patchList
.
prompt> showrev -p | sort > patchList
If you need patches, you can download them from:
http://sunsolve.sun.com
You can fulfil all the patch requirements by installing the J2SE patch cluster along with the domain name patch (112138-01 or greater).
Check that your computer has these required operating system packages:
|
|
|
|
|
|
|
|
|
|
|
|
To check if an operating system package is installed on your computer, run the pkginfo
command with the name of the package. The syntax for running pkginfo
is:
pkginfo package_name1 package_name2 ...
For example, to check if all of the listed operating system packages are installed on your computer, run the following command:
prompt> pkginfo SUNWarc SUNWbtool SUNWhea SUNWlibm
SUNWlibms SUNWsprot SUNWsprox SUNWtoo SUNWi1of
SUNWxwfnt SUNWi1cs SUNWi15cs
If your computer is missing a package, contact your system administrator.
To create a local operating system group, use the Solaris Management Console:
hostname:display_number.screen_number
Example (C shell):
% setenv DISPLAY test.mydomain.com:0.0
Example (Bourne or Korn shell):
$ DISPLAY=test.mydomain.com:0.0; export DISPLAY
prompt> /usr/sadm/bin/smc
oinstall
as the group name.
For more information about operating system users and groups, see your operating system documentation or contact your system administrator.
This section applies only if you are installing the Portal and Wireless Developer Topology.
Create two groups dba
and osoper
using the steps shown in Section 2.4.
To create a local operating system user, use the Solaris Management Console:
Example (C shell):
% setenv DISPLAY test.mydomain.com:0.0
Example (Bourne or Korn shell):
$ DISPLAY=test.mydomain.com:0.0; export DISPLAY
prompt> /usr/sadm/bin/
smc
root
. In Password, enter the root password.
oracle
). The Full Name and Description fields are optional. Click Next.
To check which groups an operating system user belongs to, run the groups
command with the name of the user. For example:
prompt> groups oracle
For more information about operating system users and groups, see your operating system documentation or contact your system administrator.
Check the values of the environment variables shown in Table 2 when logged in as the oracle
user.
This section is applicable only if you are installing a Portal and Wireless Developer topology.
Check that the kernel parameters are set to the minimum values as shown in Table 3. You will be installing a database for the OracleAS Metadata Repository.
Notes: If you update kernel parameter values, you need to reboot your computer for the new values to take effect. |
To add or update kernel parameter values:
/etc/system
file. For example, the following command makes a backup copy called system.back
:
prompt> cp /etc/system /etc/system.back
/etc/system
file as necessary. For example, the following lines show sample values for the parameters:
set semsys:seminfo_semmni=300 set semsys:seminfo_semmns=800 set semsys:seminfo_semmsl=256 set shmsys:shminfo_shmmax=4294967295 set shmsys:shminfo_shmmin=1 set shmsys:shminfo_shmmni=512 set shmsys:shminfo_shmseg=150
This section is applicable only if you are installing a Portal and Wireless Developer topology.
If you have other applications listening on port 1521, you may need to configure them so that they listen on a different port.
Verify if port 1521 is in use by an application on your computer with the following command:
prompt> netstat -an | grep 1521
Review the output to verify if port 1521 is in use.
If port 1521 is in use by your OracleAS Metadata Repository, then you may share the port with your installation of Portal and Wireless. Refer to the Oracle Application Server 10g Installation Guide for documentation on sharing ports.
If port 1521 is in use by a third-party application, you need to configure the application to use a different port. Refer to the Oracle Application Server 10g Installation Guide or third-party documentation for information on sharing ports.
Oracle CD-ROMs are in ISO 9660 format with Rockridge extensions. The DVD is in DVD-ROM format.
When you use volume management software, the CD-ROM or DVD mounts automatically when you insert the disk into the drive. If your CD-ROM or DVD does not automount, read this section for manual mounting instructions.
On UNIX systems, mounting or unmounting the CD-ROM or DVD manually requires root
privileges. Unmount the CD-ROM or DVD before removing it from the drive, using the unmount
command.
In the following instructions, the CD-ROM or DVD mount point is referred to as cdrom
. If your mount point is different, substitute the correct mount point name for all references to cdrom
.
Follow these steps to mount the CD-ROM or DVD manually:
root
user and create a CD-ROM or DVD mount point directory accessible by all users:
% su Password: # mkdir /cdrom # chmod 777 /cdrom
# mount options device_name /cdrom # exit
Note:
On Solaris (Sun SPARC), if you are using Volume Manager, the CD-ROM mounts automatically. The mount point is usually |
oracle
user. If you switched to the oracle
user using the "su -oracle
" command, check the values of the environment variables again because the variables might not be passed to the oracle
user.
DVD users: Insert the Oracle Application Server DVD into the DVD drive.
CD-ROM:
prompt> cd prompt> mount_point/904disk1/runInstaller
DVD:
prompt> cd prompt> mount_point/application_server/runInstaller
This section describes how to install these two Oracle Application Server topologies:
These topologies are intended for development environments. See the Oracle Application Server 10g Installation Guide for additional topologies, including deployment topologies. Oracle recommends reviewing the Oracle Application Server 10g Installation Guide to verify coexistence of Oracle Application Server components for your deployment topology.
A Java Developer topology consists of a J2EE and Web Cache instance, on which you can deploy and run J2EE applications.
Perform the following procedure to install a J2EE and Web Cache instance:
Enter the full destination path for the inventory directory: Enter the full destination path for the directory where you want the installer to store its files. Enter a directory that is different from the Oracle home directory.
Example: /opt/oracle/oraInventory
Click OK.
Enter the name of the operating system group to have write permission for the inventory directory.
Example: oinstall
Click Next.
oraInventory
directory.
Click OK.
Name: Enter a name to identify this Oracle home.
Example: OH_J2EE_904
Destination Path: Enter the full path to the destination directory. This is the Oracle home directory.
Example: /opt/oracle/OraJ2EE_904
If the destination directory does not exist, Oracle Universal Installer creates it.
If you want to create the destination directory beforehand, create it as the oracle
user; do not create it as the root
user.
Click Next.
Select OracleAS Web Cache if you want to use caching capabilities with this Oracle Application Server instance.
Do not select Identity Management Access.
Do not select OracleAS Database-Based Cluster.
Do not select OracleAS File-Based Cluster.
Click Next.
Instance Name: Enter a name for this instance. If you have more than one Oracle Application Server instance on a computer, the instance names must be unique.
Example: J2EE
_904
ias_admin Password and Confirm Password: Enter and confirm the password for the ias_admin user. This is the administrative user for this instance.
Passwords must consist of at least five characters, and one of the characters must be a number.
Click Next.
Verify your selections and click Install.
Oracle Universal Installer is now installing the files and configuring Oracle Application Server components. This may take a while.
Do not run
Note:
root.sh
until prompted. Oracle Universal Installer will display a screen prompting you to run root.sh.
In a different window, login as the root user and run the root.sh
script. The script is located in this instance's Oracle home directory.
The Configuration Assistants screen display shows the progress of the configuration assistants. The Configuration Assistants configure Oracle Application Server components.
Click Exit to quit the installer.
In this topology, you install a Portal and Wireless middle tier, which enables you to deploy applications that use components such as OracleAS Portal and OracleAS Wireless. The Portal and Wireless middle tier requires an OracleAS Infrastructure 10g, which you will install before installing the Portal and Wireless middle tier.
This procedure installs an infrastructure with a new database and a new Oracle Internet Directory.
Enter the full destination path for the inventory directory: Enter the full destination path to the directory where you want the installer to store its files. Enter a directory that is different from the Oracle home directory.
Example: /opt/oracle/oraInventory
Click OK.
Enter the name of the operating system group to have write permission for the inventory directory.
Example: oinstall
Click Next.
oraInventory
directory.
Click OK.
Name: Enter a name to identify this Oracle home.
Example: OH_INFRA_904
Destination Path: Enter the full destination path to the Oracle home directory.
Example: /opt/oracle/OraInfra_904
If the destination directory does not exist, Oracle Universal Installer creates it.
If you want to create the destination directory beforehand, create it as the oracle
user; do not create it as the root
user.
Click Next.
If you want to install a High Availability environment refer to the Oracle Application Server 10g Installation Guide and the Oracle Application Server 10g High Availability Guide.
Select Single Node Installation and click Next.
Refer to Section 2.9, "Check Port Use" to verify availability of port 1521.
Select Oracle Internet Directory.
Select OracleAS Single Sign-On.
Select Delegated Administration Service.
Select Oracle Directory Integration and Provisioning.
Do not select OracleAS Certificate Authority.
Do not select High Availability Addressing.
Click Next.
This screen appears if you are running the installer as a user who is not in the dba
operating system groups.
Database Administrator (OSDBA) Group: Enter the name of an operating system group that you belong to.
Example: dbadmin
Database Operator (OSOPER) Group: Enter the name of an operating system group that you belong to.
Example: dbadmin
Click Next.
Global Database Name: Enter a name for the OracleAS Metadata Repository database, and append the domain name of your computer to the database name.
Example: asdb.acme.com
SID: Enter the system identifier for the OracleAS Metadata Repository database. Typically this is the unique global database name, but without the domain name. The SID must be unique across all databases.
Example: asdb
Click Next.
Click Next.
Enter or select a directory for database files: Enter the directory where you want the installer to create data files for the OracleAS Metadata Repository database.
Example: /data_partition/ias_dbfiles/
Click Next.
Click Next.
Instance Name: Enter a name for this instance. If you have more than one Oracle Application Server instance on a computer, the instance names must be unique.
Example: INFRA_904
ias_admin Password and Confirm Password: Enter and confirm the password for the ias_admin user. This is the administrative user for this instance.
Passwords must consist of at least five characters, and one of the characters must be a number.
Click Next.
Verify your selections and click Install.
Oracle Universal Installer is now installing the files and configuring Oracle Application Server components. This may take a while.
Do not run
Note:
root.sh
until prompted. Oracle Universal Installer will display a screen prompting you to run root.sh.
In a different window, login as the root user and run the root.sh
script. The script is located in this instance's Oracle home directory.
Click Exit to quit the installer.
This procedure installs a Portal and Wireless instance and configures it to use the infrastructure installed in Section 3.2.1, "Installing an OracleAS Infrastructure 10g".
Name: Enter a name to identify this Oracle home.
Example: OH_PORTAL_904
Destination Path: Enter the full destination path to the Oracle home directory.
Example: /opt/oracle/OraPortal_904
If the destination directory does not exist, Oracle Universal Installer creates it.
If you want to create the destination directory beforehand, create it as the oracle
user; do not create it as the root
user.
Click Next.
If you want to install a High Availability environment refer to the Oracle Application Server 10g Installation Guide and the Oracle Application Server 10g High Availability Guide.
Select OracleAS Portal.
Select OracleAS Wireless.
Click Next
Hostname: Enter the name of the computer where Oracle Internet Directory is running.
Port: Enter the port number at which Oracle Internet Directory is listening. To determine Oracle Internet Directory's port number, look in the portlist.ini
file located in the ORACLE_HOME
/install
directory of the infrastructure.
If you select Use only SSL connections with this Oracle Internet Directory, then you must obtain the port number from Oracle Internet Directory (SSL) parameter in the portlist.ini
file.
Click Next.
Username: Enter orcladmin
. This is the name of the Oracle Internet Directory administrator.
Password: The password for orcladmin
is the same as the password for the ias_admin user in the infrastructure. You entered this password when you installed the infrastructure (see step 13 in Section 3.2.1, "Installing an OracleAS Infrastructure 10g").
Click Next.
Repository: Select the OracleAS Metadata Repository that you want to use for this middle tier instance and click Next.
Instance Name: Enter a name for this instance. If you have more than one Oracle Application Server instance on a computer, the instance names must be unique.
Example: PORTAL
_904
ias_admin Password and Confirm Password: Enter and confirm the password for the ias_admin user. This is the administrative user for this instance.
Passwords must consist of at least five characters, and one of the characters must be a number.
Click Next.
Verify your selections and click Install.
Oracle Universal Installer is now installing the files and configuring Oracle Application Server components. This may take a while.
Do not run
Note:
root.sh
until prompted. Oracle Universal Installer will display a screen prompting you to run root.sh.
In a different window, login as the root user and run the root.sh
script. The script is located in this instance's Oracle home directory.
Click OK.
Click Exit to quit the installer.
After installation, access the Oracle Application Server Welcome page to verify that the installation was successful. The URL for the Welcome page is:
http://hostname.domainname:http_port
Determine the http_port by looking in the portlist.ini
file, located in the ORACLE_HOME
/install
directory. The http_port is listed on the "Oracle HTTP Server listen port
" line.
The Welcome page provides links to these useful pages:
If you want to install the OracleAS Metadata Repository in an existing Oracle database, you can run a tool called the Oracle Application Server Repository Creation Assistant (OracleAS RepCA). This tool loads the OracleAS Metadata Repository data into an existing database.
You can find the OracleAS RepCA and associated documentation in the Installing the Oracle Application Server Metadata Repository into an Existing Database document on the "OracleAS RepCA and Utilities" CD-ROM.
This section describes how to upgrade the J2EE and Web Cache installation type, and the OracleAS Portal component of the Portal and Wireless installation type from Release 2 (9.0.2) or Release 2 (9.0.3) to 10g (9.0.4).
This section does not explain how to upgrade the OracleAS Portal schema in the Infrastructure.
This section also includes instructions for using the Oracle Application Server Upgrade Assistant (OracleAS Upgrade Assistant), a tool that automates much of the upgrade process.
This section features the following topics:
In Section 5, references to Oracle homes use the following conventions:
<source_MT_OH>.
<desination_MT_OH>
.
Before upgrading, perform the tasks in the following sections:
Before upgrading, you must install Oracle Application Server 10g (9.0.4). Select the J2EE and Web Cache or Portal and Wireless installation type during Oracle Application Server 10g (9.0.4) installation. The upgrade cannot take place unless there is a destination Oracle Application Server instance. (Do not install a new infrastructure.)
The installation type of the source instance must match the installation type of the destination instance. The source and destination Oracle Application Server instance must exist on the same computer. If the source instance uses an infrastructure, the destination instance must use the same Oracle Internet Directory and Metadata Repository. (Do not install a new infrastructure.)
Note: During installation, the OracleAS Wireless schema in the OracleAS Metadata Repository is upgraded. |
This procedure enables you to upgrade a J2EE and Web Cache instance:
<source_MT_OH>
/bin/emctl stop
<destination_MT_OH>
/bin/emctl stop iasconsole
<source_MT_OH>
/opmn/bin/opmnctl stopall
<destination_MT_OH>
/opmn/bin/opmnctl stopall
<destination_MT_OH>
/upgrade/iasua.sh
Select the source J2EE and Web Cache Oracle home from the drop-down list and click Next.
Click OK.
Ensure that all the requirements are met, and check all checkboxes and click Next.
Click Finish to start the upgrade processing.
Click OK.
Follow the steps below to upgrade the Portal and Wireless middle tier.
<source_MT_OH>
/bin/emctl stop
<destination_MT_OH>
/bin/emctl stop iasconsole
<source_MT_OH>
/opmn/bin/opmnctl stopall
<destination_MT_OH>
/opmn/bin/opmnctl stopall
<destination_MT_OH>
/upgrade/iasua.sh
Click Next.
Select the Portal and Wireless source Oracle home from the drop-down list and click Next.
Click OK.
Ensure that all the requirements are met, and check all checkboxes. Click Next.
Click Finish to start the upgrade processing.
Click OK.
For more information, see these Oracle resources:
Printed documentation is available for sale in the Oracle Store at:
http://oraclestore.oracle.com/
You can also contact your Oracle representative to purchase printed documentation.
To download free release notes, installation documentation, white papers, or other collateral, please visit the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at
http://otn.oracle
.com/membership/index.htm
If you already have a username and password for OTN, then you can go directly to the documentation section of the OTN Web site at
http://otn.oracle
.com/docs/index.htm
If you purchased Oracle Product Support, you can call Oracle Support Services for assistance. Oracle Support Services include phone assistance, version updates and access to our service offerings. You have access to phone support 24 hours a day, 7 days a week. In the U.S.A., you can call Product Support at 1-800-223-1711.
Make sure you have your CSI (CPU Support Identifier) number ready when you call. (Keep the CSI number for your records, because it is your key to Oracle Support Services.) The Oracle Store sends the CSI number to you in an e-mail alert when it processes your order. If you do not have your CSI number and you are in the U.S.A., you can look up your CSI number by accessing our online Order Tracker which provides detailed order information. Go to the Oracle Store and click on Order Tracker located above the top navigation bar.
For Oracle Support Services locations outside the U.S.A., call your local support center for information on how to access support. To find the local support center in your country, visit the Support Web Center at:
http://www.oracle.com/support
.
At the Support Web Center you will find information on Oracle Support Services, such as:
With Oracle Product Support, you have round-the-clock access to MetaLink, Oracle Support Services premier Web support offering. MetaLink offers you access to installation assistance, product documentation, and a technical solution knowledge base.
It has technical forums, where you can post questions about your Oracle products and receive answers from Oracle Technical Support Analysts and other Oracle users. The questions and answers remain posted for the benefit of all users.
MetaLink options include:
You can access MetaLink at:
If you do not have a currently supported license, you can purchase the most recent version of an Oracle product from the Oracle Store (http://oraclestore.oracle.com
).
If you do have a currently supported license, you can place non-urgent requests for version update shipments through the iTAR feature on MetaLink. You will need to log the iTAR type as a U.S. Client Relations/Non-Technical Request.
You can also request Version Update shipments in the U.S.A. by calling Client Relations. When requesting a Version Update, please provide the following information to the Client Relations Analyst:
Outside the U.S.A., please call your local Oracle Support Center.
For information on our Premium Services, including onsite support, OracleGOLD, remote services, and upgrade packages, visit the Support Web Center at http://www.oracle.com/support
or call your Support Sales Representative in the U.S.A at 1-800-833-3536.
Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at:
http://www.oracle.com/accessibility/
JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.
Copyright © 2003 Oracle Corporation. All Rights Reserved.
Oracle is a registered trademark, and Oracle9i, Oracle Discoverer, OracleMetaLink, and SQL*Net are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners
|
![]() Copyright © 2003 Oracle Corporation. All Rights Reserved. |
|