After you install and configure Application Engine, you must deploy your client
application, Workplace,
on your JBoss Application Server.
Procedure
- Stop
the JBoss Application Server instance,
if it is running.
- Deploy the Workplace application: To deploy from exploded directory
- On the JBoss Application Server,
copy the /Workplace folder from:
AE_install_path
to:
JBOSS_home/server/servername/deploy/
- Append the extension .war to the Workplace folder:
JBOSS_home/server/servername/deploy/Workplace.war
To deploy from a WAR file
On the JBoss Application Server, copy the app_engine.war file
from:
AE_install_path/deploy
to:
JBOSS_home/server/servername/deploy/
To deploy from an EAR file
On the JBoss Application Server, copy the app_engine.ear file
from:
AE_install_path/deploy
to:
JBOSS_home/server/servername/deploy/
- Set permissions for the user running the application server.
If the user that will be running the application server
is different from the user that installed Application Engine, you must give the user
read/write permissions on the following folders:
JBOSS_home/server/default/deploy/app_engine.war/
.ear
AE_install_path
For Windows this
is only required for NTFS
formatted partitions.
- (For JBoss Application Server 5.0.1 only) Navigate
to each custom copied Workplace jboss-classloading.xml instance
and update the path for the name and domain. For example,
in the install_path/FileNet/AE/Workplace1/WEB-INF/jboss-classloading.xml,
make the following changes to the name and domain values:
<classloading xmlns="urn:jboss:classloading:1.0"
name="Workplace1.war"
domain="Workplace1.war"
export-all="NON_EMPTY"
import-all="false">
</classloading>
- Start the JBoss Application Server instance.
- Verify that the application deployed successfully.
Verify that the server.log file located
in JBOSS_home/server/servername/log lists
deployment of the WAR or EAR file you used.
In
a high availability environment, by using the application server administration
tool, verify that the Application Engine application
is running. - Open a Web browser and type in the URL for the Application Engine application.
- If you are using a load-balancer or proxy server the URL has the
form:
- Application Engine
- http://virtual_name:port_number/Workplace
- If connecting to an individual cluster node the URL would have
the form:
- Application Engine
- http://clustered_server_name:port_number/Workplace/
Sign-in by using the virtual name to properly set the base Application Engine URL. If it is not set correctly
you must change it in Site Preferences.
- Verify that the sign-in page displays, and log in as
a user.
- Fail one of the nodes.
- Verify that you can reload the sign-in page, and log
in as the same user.