Release 10.1A: OpenEdge Development:
Java Open Clients

> ## Deploying an Open Client application that uses a Java proxy

> To deploy a client application that uses a Java proxy, you must first perform the following steps in the specified order, on the system where you plan to run the application.

> | To deploy a client application that uses a Java proxy:

> 1. Install a Java Virtual Machine (JVM). Many platforms already come with a JVM. For more information on the available Java run-time environment (JRE) for your platform, see the sections on Java requirements in OpenEdge Getting Started: Installation and Configuration .

> 2. Copy the required files for the client application and proxy to the deployment system:

> 1. Copy the client application.
> 2. Copy the proxy `.class` files to a directory that mirrors the package hierarchy specified on the Java tab of the Generate dialog box in ProxyGen during the generation of the proxy. The package name implies a directory structure that you must maintain when you copy the proxy. You also can put the class files into a `.zip` or `.jar` file, as with any other Java classes.
> 3. Copy the same Java Open Client Runtime package that you used to build the application to any directory on your system. See the "Building an Open Client application that uses a Java proxy" section.
> 4. Copy the following third-party Eclipse jar files to the same directory where you copied the Java Open Client Runtime package in Step c, above. These files reside in the specified OpenEdge installation directory:

>     OpenEdge-install-directory/java/ext/
>         common.jar
>         commonj.sdo.jar
>         ecore.jar
>         ecore.change.jar
>         ecore.sdo.jar
>         ecore.resources.jar
>         ecore.xmi.jar

> 3. Update the `CLASSPATH` setting for the Java environment that will run the client application to include the following:

> 1. The client application classes.
> 2. The directory containing the proxy (`.class` files) or the `.zip` or `.jar` file from
>    Step 2. For class files, this is the directory above the package hierarchy.
> 3. The Open Client Runtime package and Eclipse jar files you copied in Step 2.
> Note: The mechanism to update the `CLASSPATH` setting depends on the Java environment you are using. For instructions on updating `CLASSPATH`, see the documentation for your Java environment.

> 4. If you use HTTPS (SSL), copy your digital certificates to the location required by your application. The Open Client Toolkit includes the certificate management tool (`procertm` utility), which provides a way to import, export and remove certificates to and from `.jar` and `.zip` files. See Appendix B "Java Open Client Certificate Management Utility."

> 5. Run your Java Open Client application as designed.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095