283/461

## package-appclient

packs the application client container libraries and jar files

Synopsis

    package-appclient

Description

Use the `package-appclient` command to pack the application client container libraries and jar files into an `appclient.jar` file, which is created in the as-install`/lib` directory on the machine on which GlassFish Server is installed. The `appclient.jar` file provides an application client container package targeted at remote hosts that do not contain a server installation.

After copying the `appclient.jar` file to a remote location, unjar it to get a set of libraries and jar files in the `appclient` directory under the current directory.

After unjarring on the client machine, modify `appclient/glassfish/config/asenv.conf` (`asenv.bat` for Windows) as follows:

- set `AS_WEBSERVICES_LIB` to path-to-appclient`/appclient/lib`

- set `AS_IMQ_LIB` to path-to-appclient`/appclient/mq/lib`

- set `AS_INSTALL` to path-to-appclient`/appclient`

- set `AS_JAVA` to your JDK 1.6 home directory

- set `AS_ACC_CONFIG` to path-to-appclient`/appclient/glassfish/domains/domain1/config/sun-acc.xml`

Modify `appclient/glassfish/domains/domain1/config/sun-acc.xml` as follows:

- Ensure the `DOCTYPE` file references path-to-appclient`/appclient/glassfish/lib/dtds`

- Ensure that `target-server` address attribute references the server machine.

- Ensure that `target-server` port attribute references the ORB port on the remote machine.

- Ensure that `log-service` references a log file; if the user wants to put log messages to a log file.

To use the newly installed application client container, you must do the following:

- Obtain the application client files for your target application, including the generated yourAppClient.jar file.

- Execute the `appclient` utility: `appclient -`client yourAppClient.jar

Attributes

See `attributes`(5) for descriptions of the following attributes:

ATTRIBUTE TYPE | ATTRIBUTE VALUE
--- | ---
Interface Stability | Unstable

See Also

appclient(1M)