The first time you sign into developerWorks, a profile is created for you. Select information in your profile (name, country/region, and company) is displayed to the public and will accompany any content you post. You may update your IBM account at any time.

All information submitted is secure.

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

All information submitted is secure.

My developerWorks:

My notifications:

Sign out

Select a language:

IBM Systems Director VMControl resource lifecycle management: part 4

Remote server system pool lifecycle management using the VMControl REST APIs

Piyush Jain (piyushjain@in.ibm.com), Staff Software Engineer, IBM　　

Piyush Jain is a Staff Software Engineer at IBM currently working on VMControl under IBM Systems Director, a critical product in IBM's product portfolio. He has an overall experience of around 6 years and holds a bachelor's degree in Information Technology Engineering from IET Alwar, Rajasthan India. You can contact him at piyushjain@in.ibm.com
(An IBM developerWorks Contributing Author)

Nicholas Schambureck (nschambu@us.ibm.com), Advisory Software Engineer, IBM

Nick Schambureck is an Advisory Software Engineer and Team Leader for the IBM Systems Director VMControl command-line interface and REST API team. He has been working with the project since its inception.

Poornima Soundararajan (poornima.s@in.ibm.com), Staff Software Engineer, IBM

Poornima Soundararajan is working as a Staff Software Engineer for the IBM Systems Director VMControl advanced manager. Poornima has more than 7 years of experience in Java/J2EE technologies.

Aparna Khare (apakhare@in.ibm.com), System Software Engineer, IBM

Aparna Khare is working as a System Software Engineer for the IBM Systems Director VMControl advanced manager. Aparna has 4 years of experience in Java/J2EE technologies.

Summary: IBM® Systems Director is a platform management solution that is used to manage physical and virtual systems in a multisystem environment. It supports various virtualization technologies and multiple operating systems across IBM and non-IBM platforms. IBM Systems Director VMControl™ is an advanced manager of IBM Systems Director, a free-to-own set of platform management tools. This tutorial is part of a series on VMControl resource lifecycle management. This tutorial explains about server system pool lifecycle using the VMControl Representational State Transfer (REST) application programming interfaces (APIs).

View more content in this series

Date: 04 Feb 2013
Level: Intermediate
PDF: A4 and Letter (500 KB | 29 pages)Get Adobe® Reader®

Activity: 13536 views
Comments:

Delete a server system pool

List server system pools

The first step in deleting a server system pool is to retrieve a list of available server system pools. From there, you can choose the server system pool that you need to delete.

URL
- https://myserver:port/ibm/director/rest/VMControl/systemPools/{systemPoolOID}
HTTP method
- GET

Sample request

Get the list of all server system pools:

GET https://myserver:port/ibm/director/rest/VMControl/systemPools

Listing 32. Sample response representation

        
{
    "systemPools":[{
            "state":{
                "label":"Active",
                "id":20
            },
            "status":{
                "label":"Healthy",
                "id":0
            },
            "type":"KVM",
            "oid":19362,
            "name":"systempool233",
            "uri":"/ibm/director/rest/VMControl/systemPools/19362"
        }
    ],
    "uri":"/ibm/director/rest/VMControl/systemPools"
}

Delete a server system pool

The delete server system pool request deletes the server system pool, but does not delete any of its members. The member virtual servers are simply updated to state that they are no longer managed by a server system pool. Deleting a server system pool is an asynchronous operation.

The response contains two copies of the same URL. The URL in the location header and in the response message point to the job activation record for the delete server system pool task. The job activation record contains the status of the delete server system pool request, including percentage complete and any status or error messages.

URL
- https://myserver:port/ibm/director/rest/VMControl/systemPools/{systemPoolOID}
HTTP method
- DELETE

Sample request

Delete the server system pool with a unique ID of 19362:

DELETE https://myserver:port/ibm/director/rest/VMControl/systemPools/19362

Listing 33. Sample response representation

        
HTTP/1.1 202 OK
Cache-Control: no-store
Set-Cookie: JSESSIONID_ibm_console_80=0000ZdJty7E5NW6uYO97y-KlOrI;Path=/; Secure; 
								HTTPOnly
Expires: Thu, 01 Dec 1994 16:00:00 GMT
Content-Type: application/octet-stream; charset=UTF-8
Content-Length: 193
Date: Mon, 14 May 2012 08:57:47 GMT
Location: https://9.9.9.9:8422/ibm/director/rest/jobs/1964/activations/1
Accept-Ranges: bytes
Server: Noelios-Restlet-Engine/1.1.4
Content-Language: en-US

{
  "MessageText": "DNZEMW051I New \"Delete Server System Pool\" job [1] started.
\n Refer to the following URI for 
status: /ibm/director/rest/jobs/1964/activations/1 ",
  "MessageID": "DNZEMW051I"
}

Monitor the delete server system pool job

The final step in deleting a server system pool is to monitor its progress to completion. The recommended method to monitor server system pool deletion is through the job activation record. As shown above, this URL is returned in response to the DELETE request. The job activation record can be monitored by polling the URL, but the recommended method is to use the JMS provider.

IBM Systems Director server includes a JMS provider to communicate events and other important messages with interested client applications. It allows for asynchronous communication between two or more applications. Job activation records can be monitored asynchronously through the Director.jobs.activation JMS topic.

For more information on JMS, refer to the JMS Messaging Overview page of the IBM Systems Director 6.3.x SDK information center.