z/OS Management Facility plug-in
Discovering Mainframe Software Services Instances
- Install the current version of the z/OS Management Facility plug-in.
- Install an UrbanCode Deploy agent on the LPAR where z/OSMF is running.
- Verify that the Cloud Provisioning function in z/OSMF is installed and software services instances have already been provisioned.
On the IBM UrbanCode Deploy server user interface, click Resources > Agents. Open the z/OS agent to be used to run discovery. Add an agent property named zosmf.url and set the value to the URL of z/OSMF. For example:
Create a top-level resource group and add the agent as an agent resource under the top-level resource group. Wait for a few seconds and refresh the Resource Tree. Eventually, another resource is displayed under the agent resource. This resource is named zOSMFService.
Open zOSMFService resource and click Configuration > Basic Settings. The resource has the zOSMFService role, which includes several properties that are related to z/OSMF. In the Role Properties table, specify the user ID and password to be used to run discovery and click Save.
Note: The ID is an MVS user ID with proper permissions setup. To ensure the user ID is working properly, use it to log into the z/OSMF web interface and list the software services instances.
Go back to the Resource Tree view, click the Actions button that is associated with the zOSMFService resource, and then click Configure using Software Services Instance Discovery. The discovery step runs. A log displays to show progress. When the discovery process completes, close the log window, and refresh the resource tree. Resources that represent the software services instances are displayed in the resource tree. The new resources are organized in structure
plex\system\software type\instance name.
You may add components to the resources and add these resources to an environment to start application deployment. The resource properties contain information of the instance which can be used in a deploy process. The properties are retrieved from the z/OSMF software services instance variables.
Tips: Sometimes the name of the property is not what is expected by the deploy process. You can define the expected property name in the top-level folder and have it reference the value of an instance property. See following graphic for an example.