How to Install JInitiator

1. What is JInitiator?

JInitiator is an Oracle implementation of Sun’s JavaSoft Plug-in for Solaris. It is used for connectivity between a Windows based client and Oracle Application Forms. Oracle redesigned the JavaSoft code to function specifically for Oracle Applications Forms. The primary difference is that Oracle JInitiator includes the various stability and performance enhancements that Oracle implemented prior to it being added into the reference JVM. The context of this document explains JInitiator as it is used with Oracle financial applications (E – Business Suite), not as it is used in the standalone mode in reference to Forms development. JInitiator is only for Windows based client machines

2. Why is JInitiator required?

JInitiator is used to run Java applets on a desktop client, and it provides a delivery mechanism that enables Oracle Developer applications to be run from within a browser in a stable and supported manner. In addition to addressing critical bug fixes, Oracle JInitiator provides a number of additional features to enhance application performance, such as JAR file caching, incremental JAR file loading and applet caching.

3. Certification Matrix for Microsoft Internet Explorer

The table below outlines the currently certified Browser, Operating System, JRE and JInitiator streams and minimum versions, where applicable:

Browser Version	Plug-in	Windows Vista & Vista SP1	Windows XP SP2 & SP3	Windows XP	Windows 2000
MSIE 7	JInitiator	Not Certified	JInitiator 1.3.1.18 or later	Not Certified	Not Certified
MSIE 6	JInitiator	Not Certified	JInitiator 1.3.1.18 or later	JInitiator 1.3.1.x	JInitiator 1.3.1.x
				JInitiator 1.1.8.x	JInitiator 1.1.8.x

4. Pre-requisites before downloading JInitiator

1. You must have administrator privileges on the local workstation to install the new Jinitiator.

2. Recommended MSIE Browser Settings

Security Zones

Microsoft Internet Explorer offers four different security zones to run your application through. The zone is used is dependent on how you are accessing your site (Internet

or Local Intranet) and set up within the zones themselves (Trusted sites & Restricted sites).

Each zone has its own default security level that may need to be adjusted when accessing Oracle E-Business Suite through them. The defaults are as follows;

Zone	Usage	Default
Internet	Web sites not placed in other zones	IE 6 - Medium IE 7 - Medium-high
Local intranet	Web sites on your organization's intranet	Medium-low
Trusted sites	Web sites you trust not to damage your computer	IE 6 - Low IE 7 - Medium
Restricted sites	Web sites that could potentially damage your computer	High

It is recommended that Oracle E-Business Suite is run through the 'Trusted Sites' zone, with a 'Medium' Security Setting.

Oracle E-Business Suite can be set to run through the 'Trusted Sites' zone, with a 'Medium' security setting as follows;

1. Select Tools -> Internet Options -> Security tab -> Trusted Sites icon.
2. Set the 'Security Level for this Zone' to 'Medium' if it is not set already.
3. Select Tools -> Internet Options -> Security tab -> Trusted Sites icon -> Sites button.
4. In the 'Add this Web site to the zone:' field, enter the 'hostname and domain' of the environment you are running Oracle E-Business Suite from, i.e. https://., then click the 'Add' button. Alternatively you can simply add the domain name preceded by '*', so that all sites under that domain go through this zone. i.e. *.

(If you are entering an 'http://...' or '*.' domain address, you must ensure that the 'Require server verification (https:) for all sites in this zone' is not checked).

JInitiator 1.1.8.x (Supported For MSIE 6 Only)

To download and install versions of JInitiator 1.1.8.x from the webserver, the Security setting must be reduced to Low. If you are using Custom Settings then ensure that 'Download Unsigned ActiveX Controls' and 'Run ActiveX controls and plug-ins' are set to 'Prompt' or 'Enable'. You may use any setting up to 'Medium' for runtime use. If you are using custom settings ensure that 'Run ActiveX controls and plug-ins' is set to 'Prompt' or 'Enable'.

JInitiator 1.3.1.x (Supported For MSIE 6 & 7)

JInitiator 1.3.1.x versions will download and install from the webserver on any security setting except High, therefore the security setting should not need any adjustments at download and install time.

5. Installing Jinitiator

On the Oracle Applications sign on screen enter your username and password. The Oracle Applications E-Business Suite Home page appears. Select a responsibility, and then choose an Oracle Forms-based function. Follow the instructions for the type of browser you are using — JInitiator is implemented as an ActiveX component for Microsoft Internet Explorer.

According to the security settings of your browser, JInitiator may begin downloading

automatically, or a Security Warning window may appear, prompting you to install

Oracle JInitiator. If the Security Warning window appears, click Yes.

1. InstallShield runs to install Oracle JInitiator. When prompted, click Yes and follow

the instructions. (You can use the default location for installing Oracle JInitiator)

2. After the installation is complete, exit from all web browser sessions to allow

Microsoft Internet Explorer to load the Oracle Applications certificate that is

needed for proper operation of Oracle Applications.

Technical Information for System Administrators

1. Jinitiator is installed to the \Program Files\Oracle folder. You will need to set permissions on the \Program Files\Oracle folder to grant Full Control to Users.

2. When downloading and installing the JInitiator it may take quite some time. It may seem like the screen is frozen but it is downloading the Java Application. Please be patient.

3. If the server name is not in your DNS (Domain Name Server), then an entry must be made in the desktop’s "hosts" file on their PC. The “hosts” file is located in the /…/System32/Drivers/etc/hosts folder. Contact your systems administrator if you have connection problems.

4. Multiple versions of Jinitiator may be installed on the same desktop. The Oracle application will map to the version automatically, even if other versions are present.