./appclient.sh --host=10.0.0.1 myear.ear#appClient.jar arg1
As a Java EE6 compliant server JBoss AS 7.1 contains an application client. An application client is essentially a cut down server instance, that allow you to use EE features such as injection in a client side program.
This article is not a tutorial on application client development, rather it covers the specifics of the AS 7.1 application client. There are tutorials available elsewhere that cover application client basics, such as this one.
Note that the application client is different to the EJB client libraries, it is perfectly possible to write client application that do not use the application client, but instead use the jboss-ejb-client library directly.
To launch the application client use the appclient.sh or appclient.bat script in the bin directory. For example:
./appclient.sh --host=10.0.0.1 myear.ear#appClient.jar arg1
The --host argument tells the appclient the server to connect to. The next argument is the application client deployment to use, application clients can only run a single deployment, and this deployment must also be deployed on the full server instance that the client is connecting to.
Any arguments after the deployment to use are passed directly through to the application clients main function.
If you want to connect to more than one host or make use of the clustering functionality then you need to specify a jboss-ejb-client.properties file rather than a host:
./appclient.sh --ejb-client-properties=my-jboss-ejb-client.properties myear.ear#appClient.jar arg1