administration-tool.sh utility usage explained

Products

• VMware Smart Assurance

Issue/Introduction

administration-tool.sh utility in MnR/Watch4net can be used to:

• create documentation
• delete documentation
• list documentation
• get documentation
• update documentation
• module
• profile
• reportpack
• role
• user
• etc.

Environment

Watch4Net/M&R - 10.1.x

Resolution

Syntax to get list of users from remote MnR server using administration-tool.sh :

./administration-tool.sh https://<Username>:<Password>@<Remote IP or host>:48443/Tools/Administration-Tool/Default/listUser?disableSSLValidation=false

This query will throw an error on console/putty if remote server certificate is not added to server from where utility is executed.
Log snippet:
com.sun.xml.internal.ws.client.ClientTransportException: HTTP transport error: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Caused by: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
        at sun.security.ssl.Alert.createSSLException(Alert.java:131)

Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
        at sun.security.validator.PKIXValidator.doBuild(PKIXValidator.java:439)

In such scenarios, SSLValidation can be disabled and run as: 
./administration-tool.sh https://<Username>:<Password>@<Remote IP or host>:48443/Tools/Administration-Tool/Default/listUser?disableSSLValidation=true

Sample output from lab:


NOTE: It is necessary to open port 48443 between remote server and server from where utility is executed.