Manual Application Deployment

About this task

To install an enterprise application in WebSphere Application Server for z/OS, the Administration Console can be used. The steps below describe how to install an application, EJB component, or web module using the Administrative Console.

Note: Once the install has been started, the Cancel button must be used to exit if the installation of the application is aborted. It is not sufficient to simply move to another Administrative Console page without first clicking Cancel on an application installation page.

Procedure

Navigate to Applications > New Application;
Select New Enterprise Application;
Click the appropriate radio button and specify the full path name of the source application file or .ear file, optionally via the Browse button, in the Path to the new application panel and click Next;
The default locations for the application .ear files is:

$SERVER_DIR/ear/WAS/
Select the Fast Path - Prompt only when additional information is required radio button in the How do you want to install the application? panel and click Next;
Leave the defaults as they are for step 1, Select installation options and click Next;
In step 2, Map modules to servers, for every module listed, select a target server or a cluster from the Clusters and Servers list. To do this, tick the check box beside the particular module(s) and then select the server or cluster and click Apply.
Click Next and then Finish to complete the installation. This step may take a few minutes and should finish with the message Application Curam installed successfully.
Save the changes to the Master Configuration. (See Save the Master Configuration for more details.)
Navigate to Applications > Application Types > WebSphere enterprise applications and select the newly installed application.
Select the Class loading and update detection option from the Detail Properties section.
Set the Class loader order to be Classes loaded with application class loader first.
Set the WAR class loader policy to be Single class loader for application.
Click OK.
Navigate to Users and Groups -> Manage Users. Click Create... and enter a User ID, Password, First Name and Last Name. Then click on Create.
See Change SYSTEM Username for information regarding the credentials expected here by the application and changing them.
Return back to the enterprise application (Applications > Application Types > WebSphere enterprise applications, select the newly installed application) and select the Security role to user/group mapping option from the Detail Properties section and map the mdbuser role to a username and password as per these steps:
Note:
The username you use to map to the mdbuser role must already be defined in your user registry.
1. Check Select for the mdbuser role and click Map Users...;
2. Enter an appropriate username in the Search String field and click Search;
3. Select the ID from the Available: list and click >> to add it to the Selected: list and click OK.
4. Click OK.
Having mapped the mdbuser role you can now update the user RunAs role by selecting the User RunAs roles option from the Detail Properties section.
Enter the appropriate username and password in the username and password fields, respectively. Check Select for the mdbuser role and click Apply.
Click OK.
Save the changes to the master configuration.
After deployment it is necessary to start the application before it can be used. Navigate to Applications > Application Types > WebSphere enterprise applications, tick the check box for the newly installed application, and click the Start button. This step may take a few minutes and should finish with the application status changing to indicate it has been started.
Finally, test the application deployment. For example, point a web browser at the URL for the deployed application e.g.:
```
https://<Your WebSphere host>:<CuramClientEndPoint>/Curam
```
Where:

<Your WebSphere host> identifies the host name or IP address where your WebSphere Application Server for z/OS system is running and <CuramClientEndPoint> identifies the port assigned (as in Set up the Port Access).