package-appclient(1M) Application Server Utility package-appclient(1M)NAME
package-appclient - packs the application client container libraries and jar files
SYNOPSIS
package-appclient
Use the package-appclient command to pack the application client container libraries and jar files into an appclient.jar file. The created
file is located at appserver_install_dir/lib/appclient/appclient.jar. The appclient.jar file provides an application client container
package targeted at remote hosts that do not contain a server installation.
The appclient.jar archive contains native code and can be used on a target machine that is of similar architecture as the machine where it
was produced. So, for example, an appclient.jar produced on a Solaris SPARC platform cannot be used on a Windows client machine.
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
After unjarring on the client machine, modify appclient_install_dir/config/asenv.conf (asenv.bat for Windows) as follows:
o set AS_WEBSERVICES_LIB to appclient_install_dir/lib
o set AS_NSS to appclient_install_dir/lib (appclient_install_dirin for Windows)
o set AS_IMQ_LIB to appclient_install_dir/imq/lib
o set AS_INSTALL to appclient_install_dir
o set AS_JAVA to your JDK 1.4 home directory
o set AS_ACC_CONFIG to appclient_install_dir/config/sun-acc.xml
Modify appclient_install_dir/config/sun-acc.xml as follows:
o Ensure the DOCTYPE file references appclient_install_dir/lib/dtds
o Ensure that target-server address attribute refrences the server machine.
o Ensure that target-server port attribute refrences the ORB port on the remote machine.
o Ensure that log-service references a log file; if the user wants to put log messages to a log file.
Modify appclient_install_dir/bin/appclient (appclient.bat for Windows) as follows:
o change token %CONFIG_HOME% to appclient_install_dir/config
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Unstable |
+-----------------------------+-----------------------------+
appclient(1M)Sun Java System Application Server March 2004 package-appclient(1M)
Check Out this Related Man Page
appclient(1M) Application Server Utility appclient(1M)NAME
appclient - launches the Application Client Container and invokes the client application packaged in the application JAR file
SYNOPSIS
appclient -client client_application_jar [-mainclass client_application_main_classname|-name display_name] [-xml sun-acc.xml file] [-tex-
tauth] [-user username] [-password password]
Use the appclient command to launch the application client container and invoke a client application that is packaged in an application JAR
file. The application client jar file is psecified and created during deployment either by the deploytool or by using the asadmin deploy
command.
The application client container is a set of java classes, libraries and other files that are required to execute a first-tier application
client program on a Java Virtual Machine (JVM). The application client container communicates with the Application Server using RMI-IIOP.
The client.jar that is retrieved after deploying an application , should be passed with the -client option while running the appclient
utility. The -mainclass and -name options are optional for a single client application. For multiple client applications use either the
-classname option or the- name option.
-client required; the name and location for the client application jar file. The application client JAR file is specified
and created during deployment, either by the deploytool or by the asadmin deploy command.
-mainclass optional; the full classname of the main client application main() method that will be invoked by the Application
Client Container. Used for a single client application. By default, uses the class specified in the client jar. The
class name must be the full name. For example, com.sun.test.AppClient
-name optional; the display name for the client application. Used for multiple client applications. By default, the dis-
play name is specified in the client jar application-client.xml file which is identified by the display-name
attribute.
-xml optional if using the default domain and instance, otherwise it is required; identifies the name and location of
the client configuration XML file. If not specified, defaults to the value of $AS_ACC_CONFIG identified in
asenv.conf file.
-textauth optional; used to specify using text format authentication when authentication is needed.
Example 1: Using the appclient command
appclient -client appserv/bin/myclientapp.jar
-mainclass com.sun.test.TestAppClient -xml sun-acc.xml scott sample
Where: appserv/bin/myclientapp.jar is the full path for the client application .jar file, com.sun.text.TestAppClient is the full Java pack-
age name of the main client application, scott and sample are arguments to pass to the application, and sun-acc.xml is the name of the
client configuration XML file. If sun-acc.xml is not in the current directory, you must give the absolute path location; otherwise the rel-
ative path is used. The relative path is relative to the directory where the command is being executed.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Unstable |
+-----------------------------+-----------------------------+
package-appclient(1M), asadmin(1M)Sun Java System Application Server March 2004 appclient(1M)