Example: Installing the PlantsByWebSphere application

The Plants1_artifacts.zip file contains an example IBM® UrbanCode™ Deploy application that creates and configures a WebSphere cluster, and then installs the PlantsByWebSphere application on the cluster. The processes in the UrbanCode Deploy application use the multiplicity feature to create the cluster.

Note: This example requires IBM UrbanCode Deploy version 6.2.1 or later.

1. Download the example archive.
2. In IBM UrbanCode Deploy, click Applications > Import Applications, and then import the example application archive. Select Import with Snapshots. For the Upgrade Type lists for application template, component, generic process, and resource template, select to upgrade if the object exists, as shown in the following screen capture: 
   
3. Create a top-level resource directory, and then add the agent that is running on the WebSphere Deployment Manager to the new top-level directory. The automatic discovery process runs.
4. Edit the new WebSphereCell object to add the user ID, password, and port information, and then run topology discovery on the cell.
5. Click Show > Resource Roles, and then drag a WebSphereCluster object from the roles pane to the ServerClusters directory in the resource tree. Give the WebSphereCluster object a name such as PlantsCluster. 
6. Add the PlantsByWebSphere and PlantsClusterConfig components under the PlantsCluster cluster. When you add the PlantsClusterConfig component, you must specify values for the SERVER_COUNT and NODELIST role properties. Specify 1 for the SERVER_COUNT property and one or more application server node names in the NODELIST property. Change the value of the WC_defaulthost endpoint in the ENDPOINTPORTMAPPINGS field from 50700 to 9080. To use a value other than 9080, you might need to add the value to the Virtual Hosts->default_hosts->Host Aliases section of your WebSphere environment. Check that the other default values that are specified for the ENDPOINTPORTMAPPINGS field do not conflict with any existing ports in use in your WebSphere environment. After you add the components, the resource tree looks similar to the following example screen capture:
   
7. Go to the Test environment of the PlantsByWebSphere application, and then click Add Base Resources to add the new resource tree as the base resource of the Test environment, as shown in the following example screen capture: 
   
8. You can now run the ConfigureClusterAndInstallPlants application process on the Test environment. Select the Release1 snapshot in the Run Process window, as shown in the following screen capture.
   

The process runs and installs the PlantsByWebSphere application installed into the new cluster. Access the PlantsByWebSphere application by opening http://node_name:port_number/PlantsByWebSphere in a web browser. For node_name, use the host name of one of the application server nodes that you specified in the NODELIST field in step 6. For port_number, use the value of the WC_defaulthost endpoint in ENDPOINTPORTMAPPINGS field from step 6.
#UrbanCodeDeploy