usr/src/lib/wiseman/wise.1
author Cyril Plisko <cyril.plisko@grigale.com>
Tue, 06 Apr 2010 16:00:14 +0300
changeset 11 87960ed158f9
parent 0 b34509ac961f
permissions -rw-r--r--
Import sfw build 137 Bugs Fixed ---------- 6926835 Wireshark cannot open files typed into the location bar 6930214 CVE-2010-0624: Heap-based buffer overflow in GNU Tar 6933424 Various sfw manual pages need to be adjusted to use the new OpenSolaris package names. 6937764 upgrade OpenSSL to 0.9.8n (and fix CVE-2010-0740)

'\" t
.TH "wise" "1" "" "" ""
.SH NAME
wise - a command line tool for sending requests to WS-Management Web services.
.SH SYNOPSIS
.B wise
[OPTIONS]
.SH DESCRIPTION
The WisemanCmdLine command line tool provides a simple method for sending requests to WS-Management Web services for testing. Get, Put, Create, Delete, and optimized Enumeration are currently supported. The script 'wise' located at /usr/bin can be used to call the WisemanCmdLine class with the necessary classpath. The tools usage follows. 
.P
.B
Usage: wise -a -d -r [ -s | -b | -x | -m | -u | -p ]

.P
.B
[OPTIONS]
-a WS-MAN action to perform (get, put, create, delete, enumeration).  This argument is required.

-d URL destination for the Wiseman request.   This argument is required.

-r Resource URI value of the Wiseman request.   This argument is required.

-s Name and value for the item requested.  The first value is the name of the "key" field, the second is the value of the "key" field.

-b File name of the XML body of the request.  The file must contain valid XML.  This argument is required for Create and Put requests.

-x XPATH expression to apply to result set.  This argument is used for a fragment transfer request.

-m Maximum number of items to return.  This argument is valid only for Enumeration requests.

-u User name to connect to the web service.

-p Password to connect to the web service.

.P
.B
Sample usage

Create
wise  -a create -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -d "http://localhost:8080/traffic/" -b "C:\Documents and Settings\nabee\My Documents\create.txt"  -u wsman -p wsman

Get
wise  -a get -d "http://localhost
:8080/traffic/"  -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -s name
 Light1

Get (with fragment transfer)
wise -a get -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -d "http://localhost:8080/traffic/" -s name Light1 -x "//*[local-name()='color']"  -u wsman -p wsman

Put
wise  -a put -d "http://localhost
:8080/traffic/"  -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -s name
 Light1 -b "c:\putbody.xml"

Delete
wise -a delete -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -d "http://localhost:8080/traffic/" -s name Light1  -u wsman -p wsman

Enumerate
wise -a enumerate -r "urn:resources.wiseman.dev.java.net/traffic/1/light" -d "http://localhost:8080/traffic/" -m 10  -u wsman -p wsman

.PP
For more details about Wiseman, please see
.br
.B https://wiseman.dev.java.net web page.

.SH FILES
By default, all wise tool is installed into /usr/bin directory.

.SH ENVIRONMENT
JAVA_HOME variable must point to the directory where Java is installed.

.RE
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE
=
Availability	library/java/wiseman
=
Interface Stability	Uncommitted
.TE
.PP
.SH SEE ALSO
.LP
wiseman(3)
.SH NOTES
Source for wiseman is available on http://opensolaris.org.