This document guides you through installing the server
components of Oracle Forms & Reports for Sun SPARC Solaris,
Release 6i, on the Solaris 8 operating system. The installation
is performed using Oracle's Oracle Universal Installer (OUI), a
GUI-based tool similar to the OUI for Oracle9i and other Oracle
products. This guide takes you through the pre-installation,
installation, and post-installation tasks referenced in the
Oracle Forms Developer and Reports Developer Installation Guide
dated March 2000 (Oracle Part No. A82817-01). Oracle Forms
Server and Reports Server Installation Guide dated March 2000
(Oracle Part No. A82818-01) can also be used.
The following conventions are used in this installation guide:
CPU that is SPARC-based
Swap space two to four times the size of physical RAM
Sun OpenWindows to display GUI tools
2.62GB of hard disk space
No Sun Motif patches are necessary for Solaris 8
Files edited or modified by the UNIX
may have been created for installation of Oracle9i. You can
use the same Oracle user for both 9i and 6i, but separating
the users is a practical safeguard related to configuration
issues and preventing the overwriting of important files.
1. Create a user called
who is a member of the
file and enter the following line:
is the name of the Oracle user
is related to a password value
is the userid of this UNIX account
is the primary group ID to which
is the home directory (where
is the default startup shell.
file and add the user
to the list of users under the
group. For example, the entries for the
groups line could look like
3. When all changes have been made, execute
at a UNIX prompt. Create the mount point and assign
by entering the following commands:
mkdir -p /opt1/ora6i
chown oradev6:dba /opt1/ora6i
file and add the following environment variables:
setenv ORACLE_HOME <ex: /opt1/ora6i/app/oracle/product/6.0>
setenv ORACLE_SID <name of a database>
environment variable should match the path you will be
value does not have to be the name of an actual database.
5. Login as
Check to see that your home directory is automatically set
Copy a generic
cp /etc/skel/local.cshrc .cshrc
6. Using a text editor such as vi, edit the
Modify the file so that the following settings and
environment variables are set, and source the file (source
when finished with the editing.
setenv DISPLAY <machinename>:0.0
setenv ORACLE_TERM sun5
setenv ORACLE_SID <database name>
setenv ORACLE_BASE /<mount point>/app/oracle
setenv ORACLE_HOME $ORACLE_BASE/product/6.0
setenv TNS_ADMIN <as stated in the previous step>
setenv LD_LIBRARY_PATH $ORACLE_HOME/lib: <img src="/img/return.gif"
width=14 height=9 border=0 alt="">
setenv ORACLE_AUTOREG $ORACLE_HOME/guicommon6/tk60/admin
setenv TK_PRINT_STATUS 'echo %n is valid'
setenv TK_PRINTER <enter printer name>
setenv PATH <should include $ORACLE_PATH, /usr/ccs/bin,
/usr/bin, /etc, /usr/openwin, /usr/local/bin and .>
at the beginning of
Otherwise, the patch installation will fail.
You are now ready to install the CD-ROM and begin using the
Oracle Universal Installer.
Performing the installation
Insert the CD-ROM. Solaris Volume Management should
automatically mount the CD-ROM for you. Minimize the "File
Manager - oracle" window after the CD-ROM is mounted. Refer
to the table below for actions to take in each window
displayed by the Oracle Universal Installer. As the UNIX
start the installation by typing
You may encounter other windows during the installation
process for a variety of reasons (improper system setup,
lack of file permissions, non-existent paths, etc.). The OUI
windows are fairly self-explanatory as to what needs to be
done to correct a problem.
In the windows that appear below, take the action(s)
Action to take
Select Default Install. Click OK.
Installation Activity Choice
Select Install, Upgrade, or De-Install Software (the
first button). Click OK.
Select Install New Product - Do Not Create DB Objects
(second item in the list). Click OK.
Confirm the paths for ORACLE_BASE and ORACLE_HOME.
Software Asset Manager
Highlight/select the following in the "Products
available" list box on the left side of the window:
Oracle Forms Server and Forms Developer
Oracle Reports Server and Reports Developer
Single-click on each item. After BOTH have been
selected, Click Install.
Verify the path for the files shown. Click OK.
Verify the path for the file shown. Click OK.
Select Motif Bitmapped Interface. Click OK.
De-select Forms Server for Web deployment and select
Motif Bitmapped Interface. Click OK.
(same title appears again)
De-select Reports Multitier
Server for Web deployment and select Motif Bitmapped
Interface. Click OK.
Progress bar appears. Wait for next window to appear
Installer Actions Completed
Ignore instructions to run root.sh (you will do this
later). Click OK.
Software Asset Manager
Installed components appear in the right pane. Click
The command line in the UNIX window where you initiated
1. Forms and Reports executables need a
file, or you can use the
environment variable to point to a directory where the Oracle
Net Services (or Net8) configuration files are located. If you
already configured this file for an Oracle9i installation, set
to the directory where the
file for Oracle9i is located. Otherwise, Oracle products will
look for the
file in the following order:
in the user's home directory (note the dot
before the file name)
(you can set this in the
(this is the default location)
2. As oradev6,
edit the spoolcmd.sh
file. Change the working directory to
3. Beginning at line 36 in the file, where it says
if test $3 = "delete"
make the changes shown below (you are replacing the "then" and
"else" statements with what is shown below):
/usr/bin/lp d<printer name> n $4 $1
/usr/bin/lp d<printer name> n $4 $1
Without these changes, you will see error messages related to
REP-3300/UI-9 and REP-1809 when trying to print reports from
forms. Oracle documentation refers to adding a printer
definition in the
file. This file does not need to be modified.
4. Log in as
and change your working directory to
at the UNIX prompt. If the settings are correct, press Enter.
Otherwise, exit and reset the variables to the appropriate
values and run
5. Enter the pathname for the local bin directory (use
and press Enter.
6. Type Y to continue at the warning about
not matching the home directory for the Oracle user
(these values do not have to match).
7. If your group ID is
press Enter at the line prompting for the UNIX group that has
8. You can now eject/un-mount the CD-ROM.
Installing Patch 12 (Oracle patch
1. Log in as
2. Insert the Forms & Reports 6i Patch 12 CD-ROM.
3. Navigate to the
4. Copy the patch file to the
cp p* $ORACLE_HOME
5. Navigate to
Unzip the patch file with
This step will create the patch directory under the
6. Navigate to the
7. As oradev6 at a UNIX prompt, start the patch installation
process by executing
If you want a log file of the installation, execute
./patch_install.sh | & tee patch_install_p12.log
8. As the patch is installed, you will see an Oracle
installation window. No action on your part is required.
9. When the installation finishes, re-link the following:
make -f ins_procbuilder.mk install
make -f ins_forms60w.mk install
make -f ins_graphics60w.mk install
make -f ins_reports60w.mk install
This completes the patch installation process. You can delete
the patch zip file to recover some disk space.
10. As the user
you can test the installation by typing
at the UNIX command line and then see the "Forms Runtime
Options" window. If the "Forms Runtime Options" window does
not appear, check the path statement in the
The path should include