Releasing a License (Deconfiguring) on a Client Using the Command Line Interface

You can release a license on a specific agent or on a client.

Procedure

Download the release_client_license_template.xml file and save it on the computer from where the command will be executed.
Open the XML file and update the parameters as needed using the table below as reference.

Parameter

Description

Element

clientName

The name of the client.

clientEntity

hostName

The long name of the client, for example, client.domain.company.com.

clientEntity

appTypeId

The agent types associated with the client. To release a license on all the agents, valid value is 0.

Valid values are:

41, Active Directory
21, AIX File System
64, Big Data Apps
134, Cloud Apps
37, DB2
103, DB2 MultiNode
62, DB2 on Unix
128, Documentum
90, Domino Mailbox Archiver
91, DPM
67, Exchange Compliance Archiver
53, Exchange Database
45, Exchange Mailbox
54, Exchange Mailbox (Classic)
56, Exchange Mailbox Archiver
82, Exchange PF Archiver
35, Exchange Public Folder
73, File Share Archiver

33, File System
74, FreeBSD
71, GroupWise DB
17, HP-UX Files System
65, Image Level
75, Image Level On Unix
76, Image Level ProxyHost
87, Image Level ProxyHost on Unix
3, Informix Database
29, Linux File System
89, MS SharePoint Archiver
104, MySQL
13, NAS
83, Netware File Archiver
12, Netware File System
10, Novell Directory Services
124, Object Link
131, Object Store

86, OES File System on Linux
22, Oracle
80, Oracle RAC
130, Other External Agent
125, PostgreSQL
38, Proxy Client File System
87, ProxyHost on Unix
61, SAP for Oracle
135, SAP HANA
78, SharePoint Server
20, Solaris 64bit File System
19, Solaris File System
81, SQL Server
5, Sybase Database
66, Unix File Archiver
36, Unix Tru64 64-bit File System
106, Virtual Server
58, Windows File Archiver

appTypes

Save the changes to the XML file.
From the command line, go to software_installation_directory/Base and type the following command:
```
 
qlogin -cs commserve_host_name -u user_name
    
```
From software_installation_directory/Base type the following command:
```
 
qoperation execute -af xml_path\release_client_license_template.xml
    
```
If the XML file is saved in the software_installation_directory/Base directory, the file path (xml_path in the example above) does not need to be included on the command line.

Examples

Releasing a license on a client.

To release a license on a client, use the following XML.

<TMMsg_ReleaseLicenseReq isClientLevelOperation="1">
  <clientEntity _type_="CLIENT_ENTITY" clientName="dcube" hostName="mydomain" />
  <licenseTypes appType="0" licenseType="0" licenseName="0" />
</TMMsg_ReleaseLicenseReq>

Releasing a license on a specific agent.

To release a license on a specific agent, use the following XML.

<TMMsg_ReleaseLicenseReq isClientLevelOperation="1">
  <clientEntity _type_="CLIENT_ENTITY" clientName="dcube" hostName="mydomain" />
  <licenseTypes appType="33" licenseType="0" licenseName="Window File System" />
</TMMsg_ReleaseLicenseReq>