2
Installing as a New Customer

If you do not already have a version of Forms Developer on your system, follow these installation instructions.

Remember that you need to install product components both in the design-time environment (in which applications will be built) and in the runtime environment (in which the finished applications will be used).

2.1 Installing the Design-Time Components

Perform the following steps to install the design-time components of Forms Developer.

(Note that installing the design-time components will also install runtime support modules, so that your designers can test the applications they build.)

2.1.1 Step 1: Start the Oracle Installer

The autorun feature

The Oracle Installer for Windows has an autorun feature that executes setup.exe and automatically launches the Oracle Installer when you insert the CD-ROM. Most users prefer to install using this automatic feature.

However, if you want to disable the autorun feature, hold down the shift key while inserting the CD.

Then take the following steps to start the Oracle Installer without autorun. (Note that not all CD-ROM drives support the autorun feature.)

To start the Oracle Installer without autorun:

1. Shut down any active Windows applications.

2. Choose Start'RunStart->Run to display the Run dialog.

3. In the Run dialog box, type the following (where x is the letter of your CD-ROM drive):

   x:\SETUP.EXE

4. Click OK to start the Oracle Installer.

Choose Installation Settings: Company Name, ORACLE_HOME, and Language

Before the actual product installation begins, the Oracle Installation Settings dialog box is displayed. In this box:

• Enter your company name.

• The ORACLE_HOME has been pre-set to DEFAULT_HOME. Keep this default setting.

• In the Language dialog box, select the language in which you wish to run Oracle Developer.

Choose the Product

The Installer presents you with a list of product sets on the CD. Choose Oracle Forms Developer.

2.1.2 Step 2: Choose an Install Method

The Oracle Installer will next offer you two choices for setting up the design-time environment:

• Typical Installation

• Custom Installation

The simplest and safest choice is Typical Installation. Selecting this option will give you an automatic installation of an appropriate, workable set of the Forms Developer components most commonly used.

After you select Typical Installation on this screen and click OK, the Oracle Installer will handle the design-time environment installation process for you.

As the installation progresses, the installer may prompt you for instructions or product locations. We recommend that you accept the default product locations.

A Custom Installation (explained in the next section) is more complex and requires greater product knowledge. Choose this option only if you require this higher level of control, and you have a good understanding of the Forms Developer components.

2.1.2.1 Custom installation

When you select a custom installation, the Software Asset Manager dialog box is displayed.

The products that are available for installation are listed under Products Available. The plus sign (+) to the left of a product's name indicates that this is the name of a software package, which consists of a main application and its supporting software. You can select the entire package by clicking the line with the plus icon, or you can double-click that line to display the pieces of the package, which can be selected individually.

The products that are already installed on your machine are listed under Products Installed. Some of these may also be software packages, and they behave as described in the previous paragraph.

The disk space required for your selection and the disk space currently available on your machine are displayed in the Space Required area below the product lists.

The Software Asset Manager dialog box also contains the following buttons:

Button	Description
Exit	Closes the Software Asset Manager and exits the Oracle Installer.
Options . . .	Allows you to do the following: Request confirmations before removing or installing products Receive detailed messages and prompts during various phases of the Oracle Installer's function Record the Oracle Installer's actions in a log file
View Log . . .	Displays the Event Log. The Event Log displays installation and configuration events in the Description Level you choose: Summary, Brief, and Detail. You can store and retrieve logs and save them to files. By default, log files are stored in %ORACLE_HOME%\ORAINST\ORAINST.LOG. If a log file from a previous installation exists, it is renamed to ORAINST.OLG. If you want to keep more than two log files (.LOG and .OLG), rename the .OLG file so that it is not overwritten.
Restore Icons	Restores Oracle product icons that were deleted.
Help	Displays the online Help system.

Steps for Using the Software Asset Manager to Custom Install:

1. Select the product or products you want to install in the Products Available list.

   As with other Windows-based applications, you can Shift+click to select a series of products from the list, or you can Ctrl+click to select multiple, discontinuous products.

2. Click Install.

   The installation begins. We recommend that you accept the default product locations.

3. When installation is complete, each product you have installed is listed in the Products Installed list.

4. Exit the Oracle Installer and restart your system.

2.2 Installing the Runtime Components

If you are setting up a runtime environment that will operate on the web (or any 3-tier environment), then you need to also install the Forms Developer Server component. Instructions for doing so are in the manual Oracle Forms Server: Deploying Forms Applications to the Web, A73071.

On the other hand, if you will be running your applications on client machines in a client/server setup, follow the instructions below.

1. Start the Oracle Installer

   You start the Oracle Installer in the same way as in Step One above.

2. Choose the Custom Installation Method

   When the Installer gives you the choice between Typical and Custom, choose Custom.

3. Select the Runtime Component

   After you select Custom, the Installer will list all the available components. Choose the Runtime component.

   The Installer will then use the Software Asset Manager to install the Forms Developer runtime components.

When installation is complete, exit the Oracle Installer and shut down and restart Windows.

2.3 Connecting to the Oracle Server

Follow these instructions to install Oracle 8 or 8i on the same physical machine as Forms Developer in a Windows NT environment. Oracle 8 or 8i must be in a separate ORACLE_HOME.

The following instructions assume that you have installed Forms Developer in DEFAULT_HOME in the ORANT directory on the D drive.

Step One: Install the Server

Insert the Oracle 8 or 8i product CD and start up the Oracle Installer.

When prompted for the Oracle Home and Full Path, specify the same name. For example, you might specify:

ORACLE_HOME = ora8i

Full Path = d:\orant\ora8i

When asked to choose an install type, choose "typical."

As the product installs, you are shown a summary indicating the parts installed and the space requirements.

When the installation is complete, the following type of information is shown (and then the Installer exits):

Oracle Database Configuration Assistant Alert

Database Creation Completed.

Database Information

Global Database Name ora8i.us.oracle.com

SID ORA8I

Sys password change_on_install

System passwd manager

Step Two: Connect the TNS Names

Note: If you do not want to set up the connection manually using the following instructions, you can use the SQL*Net Easy Configuration tool (supplied on this product CD).

Create a TNSNAMES entry in the tnsnames.ora file. You can find the file in:

d:\orant\net80\admin\tnsnames.ora

A default entry will look like this:

alias.world =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS =
(PROTOCOL = TCP)
(Host = )
(Port = )
)
)

(CONNECT_DATA = (SID = )
)
)

For example, if you installed on a machine with a HOSTNAME of TEST, a SID named ORA8I, on TCP/IP with port 1521, and an alias of NEW, then you would create the following entry:

NEW.world =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS =
(PROTOCOL = TCP)
(Host = TEST)
(Port = 1521)
)
)
(CONNECT_DATA = (SID = ORA8I)
)

)

If you manually created the entry, save and close the tnsnames.ora file.

The TNS listener must be up and running from the Oracle Server ORACLE_HOME.

You can now connect from Forms Developer to the local database instance of the server using the DBSTRING as NEW. For example, you can connect as scott/tiger@NEW.