Deploying Java EE assets for a partial application
The partial application option provides you with the ability to deploy several files into the Java EE application at the same time. You can use this option when you want to delete any number of files that are in the Java EE application.
Do not use this option if the single file is a Java EE module. Java EE modules must be deployed as an entire module.
- Logic JAR files
- JSP files
- Configuration XML files
Consider the following scenario: a problem is found in a JSP file and a controller command. The developer changes and tested it in the development environment. The functional tester validates the change in the quality assurance environment. It is now time to deploy the changed assets to your production site. Regardless of whether you use the graphical or scripting tools, always back up your Java EE assets before you deploy.
In the packaging phase, you build a single compressed file that contains:
- The entire logic JAR file that includes all existing code that is part of that JAR file, including your changed controller command class file
- The JSP file
The structure of the compressed file would look similar to the following structure:
- WebSphereCommerceServerExtensionsLogic.jar
- Stores.war/myStore/myPage.jsp
Before you begin
If you are deploying a partial application that contains deleted assets, you can use the WebSphere administrative console to either add or update assets. However, if you want to delete application files when you deploy a partial application update, you must first supply a special metadata file called META-INF/ibm-partialapp-delete.props in the partial application compressed file before you continue with the following procedure.
Procedure
- Back up your Java EE assets.
- Place the compressed file containing your changed files either on the machine that is running WebSphere administrative console or the machine that is running the web browser that you are using to access the WebSphere administrative console.
- Starting and stopping quick reference.
- Open the WebSphere Integrated Solutions Console.
- In the WebSphere administration console, expand .
-
From the Enterprise Applications list, select the check box next to the Java EE application for
your instance, such as,
WC_instance_name
For example,WC_demo
. Click Update. -
On the Preparing for Application Update page, under the
Application update options section:
- The Updating Application page displays with a confirmation message, indicating your file is updated. Click OK.
- WebSphere Application Server saves the updates and deploys the file. On the Updating page, click Save directly to the master configuration to save your changes.
Results
Deploying using the wsadmin tool
- Back up your changed assets before you deploy your changed files.
- Place the compressed file containing your changed files on the file system of the machine that is running the wsadmin tool.
- Start the wsadmin tool.
- Run the following commands. The command that you need to use depends on the language you
selected:
- Jacl
$AdminApp update WC_ instance_name partialapp {-contents path to partial compressed file}
$AdminConfig save
For example:
$AdminApp update WC_prod partialapp {-contents /deployments/2007-01-01a/partialApp.zip}
$AdminConfig save
-
Jython
AdminApp.update('WC_ instance_name', 'partialapp', '[-contents path to partial compressed file]')
AdminConfig.save()
For example:
AdminApp.update('WC_prod', 'partialapp', '[-contents /deployments/2007-01-01a/partialApp.zip]')
AdminConfig.save()
- Jacl