The ServerReleaseVersion Tool

Edit online

The ServerReleaseVersion tool retrieves the release versions for a list of Universal Messaging servers or for servers that are part of a Horizontal Scalability (HS) RNAME. The tool returns the release version of each server to which a client can establish a session at the moment. The release version is in a major.minor format, for example 10.7. If a session to any of the servers cannot be established, the tool lists the server as unknown and displays the reason for the unsuccessful connection to the server .

When you specify an HS RNAME as input, the ServerReleaseVersion tool generates a valid HS RNAME that contains the hsReleaseVersion attribute. If the servers that are part of the HS RNAME are different versions, the hsReleaseVersion attribute contains the highest release version supported by all servers.

For a list of servers, the tool returns information about each server.

In addition, the tool returns the release version of the client.

Syntax

  • On Windows:
    runUMTool.bat ServerReleaseVersion -rname=rname [username=username] [password=password]
  • On Unix:
    runUMTool.sh ServerReleaseVersion -rname=rname [username=username] [password=password]

Arguments and Options

-rname=rname
Required. String. The URLs of the servers for which you want to retrieve the release version. The URL of each server is in the form protocol://hostname:port. The -rname parameter must have the following values:
  • An HS RNAME in the form of (protocol://hostname:port,protocol://hostname:port,...) for a cluster or (protocol://hostname:port) for a standalone server.
  • A list of server URLs separated by a comma or a semicolon without any white spaces in the form of protocol://hostname:port,protocol://hostname:port,protocol://hostname:port,... or protocol://hostname:port;protocol://hostname:port;protocol://hostname:port;...
username=username
Optional. Typically set by an administrator to establish server resource access levels.
password=password
Optional. Typically set by an administrator to establish server resource access levels.

Examples

  • To retrieve the release versions for a list of servers with URLs "nsp//:localhost:9000", "nsp//:localhost:9001", and "nsp//:localhost:9002" on Windows:
    runUMTool.bat ServerReleaseVersion
-rname=nsp://localhost:9000,nsp://localhost:9001,nsp://localhost:9002

    The command prints the following output:

    We have initialised ServerReleaseVersion with:
{rname=nsp://localhost:9000,nsp://localhost:9001,nsp://localhost:9002} 
Server URLs and version of each one:

nsp://localhost:9000 -> 10.11
nsp://localhost:9001 -> 10.11
nsp://localhost:9002 -> 10.11

Client version -> 10.11

Tool execution has finished successfully.
  • To retrieve the release versions for two clusters of two servers each, where the servers are different versions and the server with URL nsp://localhost:9001 is a lower version than the rest, as part of an HS RNAME on Windows:
    runUMTool.bat ServerReleaseVersion
-rname=(nsp//:localhost:9000,nsp//:localhost:9001)(nsp//:localhost:9002,nsp//:localhost:9003)

    The command prints the following output:

    
We have initialised ServerReleaseVersion with:
{rname=(nsp://localhost:9000,nsp://localhost:9001)(nsp://localhost:9002,nsp://localhost:9003)}
Server URLs and version of each one:

nsp://localhost:9000 -> 10.11
nsp://localhost:9001 -> 10.7
nsp://localhost:9002 -> 10.11
nsp://localhost:9003 -> 10.11

Client version -> 10.11

Correct HS url to be used is:
(nsp://localhost:9000,nsp://localhost:9001)(nsp://localhost:9002,nsp://localhost:9003)
?hsReleaseVersion=10.7
Tool execution has finished successfully.