Packaging an Application Client Using the ACC

The package-appclient script, located in the install-dir/bin directory, is used to package a client application into a single appclient.jar file. Packaging an application client involves the following main steps:

• Editing the Configuration File

• Editing the appclient Script

• Editing the sun-acc.xml File

• Setting Security Options

• To use the package-appclient script bundled with the Application Server

Editing the Configuration File

Modify the environment variables in asenv.conf file located in the install-dir/config directory as shown below:

• $AS_INSTALL to reference the location where the package was un-jared plus /appclient. For example: $AS_INSTALL=/install-dir/appclient.

• $AS_NSS to reference the location of the NSS libraries. For example:

  UNIX:

  $AS_NSS=/install-dir/appclient/lib

  WINDOWS:

  %AS_NSS%=\install-dir\appclient\bin

• $AS_JAVA to reference the location where the JDK is installed.

• $AS_ACC_CONFIG to reference the configuration XML file (sun-acc.xml). The sun-acc.xml is located at install-dir/config.

• $AS_IMQ_LIB to reference the imq home. Use domain-dir/imq/lib.

Editing the appclient Script

Modify the appclient script file as follows:

UNIX:

Change $CONFIG_HOME/asenv.conf to your-ACC-dir/config/asenv.conf.

Windows:

Change %CONFIG_HOME%\config\asenv.bat to your-ACC-dir\config\asenv.bat

Editing the sun-acc.xml File

Modify sun-acc.xml file to set the following attributes:

• Ensure that the DOCTYPE references install-dir/lib/dtds to your-ACC-dir/lib/dtds.

• Ensure that the <target-server> address attribute references the remote server machine.

• Ensure that the <target-server> port attribute references the ORB port on the remote server.

• To log the messages in a file, specify a file name for the log-service element’s file attribute. You can also set the log level. For example:

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE client-container SYSTEM 
  "file:install-dir/lib/dtds/sun-application-client-container_1_0.dtd">
  <client-container>
      <target-server name="qasol-e1" address="qasol-e1" port="3700">
      <log-service level="WARNING"/>
  </client-container>

For more information on the sun-acc.xml file, see The sun-acc.xml File.

Setting Security Options

You can run the application client using SSL with certificate authentication. To set the security options, modify the sun-acc.xml file as shown in the code illustration below. For more information on the sun-acc.xml file, see The sun-acc.xml File.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE client-container SYSTEM 
"file:install-dir/lib/dtds/sun-application-client-container_1_0.dtd">
<client-container>
  <target-server name="qasol-e1" address="qasol-e1" port="3700">
    <security>
      <ssl cert-nickname="cts"
        ssl2-enabled="false"
        ssl2-ciphers="-rc4,-rc4export,-rc2,-rc2export,-des,-desede3"
        ssl3-enabled="true"
        ssl3-tls-ciphers="+rsa_rc4_128_md5,-rsa_rc4_40_md5,+rsa3_des_sha,
            +rsa_des_sha,-rsa_rc2_40_md5,-rsa_null_md5,-rsa_des_56_sha,
            -rsa_rc4_56_sha"
        tls-enabled="true"
        tls-rollback-enabled="true"/>
      <cert-db path="ignored" password="ignored"/> <!-- not used -->
    </security>
  </target-server>
  <client-credential user-name="j2ee" password="j2ee"/>
  <log-service level="WARNING"/>
</client-container>

To use the package-appclient script bundled with the Application Server

1. Under install-dir /bin directory, run the package-appclient script.

   For details, see the Sun Java System Application Server Platform Edition 8.2 Reference Manual.

   This creates an appclient.jar file and stores it under install-dir/lib/appclient/ directory.

   ---

   Note –

   The appclient.jar file provides an application client container package targeted at remote hosts and does not contain a server installation. You can run this file from a remote machine with the same operating system as where it is created. That is, appclient.jar created on a Solaris platform does not function on Windows.

   ---

2. Copy the install-dir /lib/appclient/appclient.jar file to the desired location.

   The appclient.jar file contains the following files:

   • appclient/bin - contains the appclient script used to launch the ACC.

   • appclient/lib - contains the JAR and runtime shared library files.

   • appclient/lib/appclient - contains the following files:

     • sun-acc.xml - the ACC configuration file.

     • client.policy file- the security manager policy file for the ACC.

     • appclientlogin.conf file - the login configuration file.

     • client.jar file - created during the deployment of the client application.

   • appclient/lib/dtds - contains sun-application_client-container_1_0.dtd, which is the DTD corresponding to sun-acc.xml.