Installing Oracle Configurator

This chapter contains an overview of the Oracle Configurator installation process and things to consider if you are implementing Multiple Language Support (MLS).

This chapter covers the following topics:

Overview

Oracle Configurator consists of the following:

If you are installing Oracle Applications Release 12 for the first time, the CZ schema, Oracle Configurator Developer, and the runtime Oracle Configurator are installed by running Oracle Rapid Install. For details, see Oracle Rapid Install.

If you are upgrading an existing Oracle Configurator installation, see Upgrading to this Release.

Warning: Before beginning to implement your configurator project, attend Oracle Configurator Developer training, read the Oracle Configurator Developer User’s Guide and review the current release or patch information for Oracle Configurator on MetaLink, Oracle’s technical support Web site.

Oracle Rapid Install

Oracle Rapid Install is an automated process that installs Oracle Applications Release 12 and Oracle Application Server 10g (Fusion Middleware). Oracle Application Server 10g contains the Apache Web server and supporting software. When running Rapid Install, an installation wizard guides you through the Oracle Applications installation process. You select the product(s) you want to install and Rapid Install automatically selects and installs any dependent products.

The information you supply in the Rapid Install wizard is captured in a configuration file, which you store for use during the various stages of your installation or upgrade.

Rapid Install provides default values for some profile options and Oracle Configurator Servlet properties. After running Rapid Install, be sure all profile options and system properties that have default values are set correctly for your installation, and set up any that do not have default values. For details, see Additional Setup Tasks.

For more information about Oracle Rapid Install, see Oracle E-Business Suite Installation Guide: Using Rapid Install.

Note: If you are implementing Multiple Language Support (MLS), read Installation and Setup Considerations for Multiple Language Support before running Rapid Install.

Additional Setup Tasks

After running Oracle Rapid Install or upgrading to the latest version of Oracle Configurator, perform the following, if applicable:

  1. Review all Oracle Configurator and Configurator Developer profile options and, if necessary, modify them for your installation.

    See Overview of Profile Options.

  2. Verify that Oracle Rapid Install has set up the server correctly (new installations only).

    See Verifying Apache and OC4J Setup.

  3. Define users in Oracle Applications and assign them to at least one of the predefined responsibilities that provides access to Oracle Configurator Developer. This task is typically performed by the System Administrator.

    For details about defining users and general information about responsibilities, see the Oracle E-Business Suite System Administrator’s Guide.

    The predefined Oracle Configurator Developer responsibilities are described in the Oracle Configurator Implementation Guide.

  4. If required, create custom Oracle Applications responsibilities. Only the System Administrator can create new responsibilities.

    Creating responsibilities is described in the Oracle E-Business Suite System Administrator’s Guide.

  5. Verify that Oracle Configurator and Oracle Configurator Developer were installed successfully and are set up correctly.

    See Test Your Oracle Configurator and Oracle Configurator Developer Installation.

  6. If you are implementing Multiple Language Support (MLS), see Installation and Setup Considerations for Multiple Language Support.

Test Your Oracle Configurator and Oracle Configurator Developer Installation

This section describes how to access Oracle Configurator Developer, verify that you can perform basic functions, and launch the runtime Oracle Configurator to test your installation and connectivity.

Before performing the steps below, review Web Browser Requirements.

For details about building Model structure, defining rules, generating a User Interface, and unit testing, see the Oracle Configurator Developer User’s Guide.

To test your Oracle Configurator and Oracle Configurator Developer installation:

  1. Log in to Oracle Applications.

  2. From the Oracle E-Business Suite Home page, select one of the predefined Oracle Configurator Developer responsibilities, and then select Oracle Configurator Developer from the list of available applications.

  3. If your installation was successful, the Main area of the Repository appears.

    If you receive an error, set the profile option FND: Diagnostics to Yes. When you launch Configurator Developer again, the error message will contain more detailed information to help you resolve the issue.

  4. Create a Model or open an existing Model for editing.

    For details about this step and the remaining steps in this section, see the Oracle Configurator Developer User’s Guide.

  5. Build Model structure. For example, create Components, Features, Feature Options, and so on.

  6. Navigate to the Rules area of the Workbench, and then define one or more rules.

  7. Generate Model logic.

  8. Navigate to the User Interface area of the Workbench, and then generate a User Interface.

  9. Verify that you can unit test the configuration model by launching the User Interface. To do this:

    1. From the Structure, Rules, or User Interface area of the Workbench, click Test Model.

    2. Select User Interface, and then select the User Interface you want to test.

    3. Click Finish. If your system is set up correctly, the User Interface you selected appears in a runtime Oracle Configurator window.

      If you receive an error, contact Oracle Support Services. For details, see Product Support.

Web Browser Requirements

Any Web browser running a generated Oracle Configurator User Interface must be set to display and use JavaScript and Cascading Stylesheets, and must be able to accept cookies. These requirements are met by Netscape 4.06 or later and Internet Explorer 4.0 with Service Pack 2 or later.

For more information, see the Oracle Application Framework Documentation Resources, Release 12, on MetaLink.

Installation and Setup Considerations for Multiple Language Support

Multiple Language Support (MLS) enables you to create a Model and one or more user interfaces in your base language and then display the runtime UI in any language in which you do business.

Before running Oracle Rapid Install, review Oracle E-Business Suite Concepts for background information on language support in Oracle Applications, including how to select languages, character sets, and territory values.

For information about Rapid Install and National Language Support (NLS), refer to Oracle E-Business Suite Installation Guide: Using Rapid Install.

Configuring Oracle Configurator Developer for Multiple Language Support

If you are implementing Multiple Language Support (MLS), you may want to change the language in which all prompts, menus, instructional text, and so on appear in Configurator Developer. To access the setting that enables you to do this, log into Oracle Applications, and then click the global Preferences link.

For more information, see the MLS appendix in the Oracle Configurator Developer User’s Guide.

Setting Up the Runtime Oracle Configurator for MLS

To set up the runtime Oracle Configurator to support MLS, set the profile option ICX: CLIENT_IANA_ENCODING to "UTF-8". This is the default method used to display the Oracle Configurator session character set. This enables you to display more than one language in the same UI page at runtime.

Configuring Browsers for MLS

The following procedures configure your browser for using fonts compatible with MLS.

Internet Explorer

If your browser is Microsoft Internet Explorer 5.0 or higher, begin by visiting a Web site that uses the fonts appropriate to the language you want to use. Before you reach this site, a message box will appear, asking you whether you want to download a font driver for the language. Click Yes to download and install the font driver automatically. When the download is complete, close and then restart Internet Explorer. Then choose View > Encoding > More, and select the character set you want to use for the language that you specified.

Netscape Navigator

If your browser is Netscape Navigator 4.6 or higher, and is an English language version with foreign language fonts installed, use the following procedure:

  1. Choose Edit > Preferences > Navigator > Languages, and the languages that you want to use at runtime.

  2. Choose View > Character Set and the specific character set you want to use.

  3. Choose View > Character Set > Set Default Character Set.

  4. Choose Edit > Preferences > Appearance > Fonts and select the desired code set from the For the Encoding list (for example, Japanese).

  5. In the option group for respecting document-specified fonts, choose the option that uses your default font setting, and ignores the document-specified fonts.

Required Patches

After installing Oracle Applications, you must run adpatch to apply the latest patches to your Oracle Applications Release 12 environment. For the latest required patches, contact Oracle Support or go to MetaLink, Oracle’s technical support Web site.

See Maintaining Oracle E-Business Suite for information about applying patches.