![background image](http://html1.mh-extra.com/html/quantum/dxi4500/dxi4500_manual_3756124015.webp)
Quantum DXi-Series Command Line Interface (CLI) Guide
6-67081-02 Rev A
July 2011
Web Services Support (Optional)
15
Note:
Possible error codes are listed at the end of each major section below.
Web Services Support (Optional)
By default, each CLI is executed directly on the DXi system it is running.
However, it is possible to send the command to another DXi system for
execution and display the result on the local DXi system. The syscli program in
DXi 2.0.1 Software has the capability of running the command remotely using
Web Services WSDL protocol version 2.0, provided that the remote DXi system is
also running DXi 2.0.1 Software as well.
Starting with DXi 2.0 Software, every DXi system runs a Web Services (WS)
server (specifically, axis2 server), which listens at port 9090 for all Web Services
requests from WS clients and then sends the result back to the clients.
Note:
It is strongly recommended that all CLI commands not be run in Web
Services mode when both the server and the client are on the same
system. It is much faster to run the commands directly without using
Web Services. Running a CLI command over Web Services protocol is a
complex process involving two distinct programs (client-server) and
network communication, thus having more points for failure.
Web Services Syntax
To use Web Services for any CLI, one has to specify an additional option as
follows:
syscli --<cmd> <subcmd> . . . . . --ws [<ws_server>[:<port>]]
where:
•
ws_server
is the hostname or IP address of the system that runs the WS
server. If not specified, it is assumed to be
localhost
.
•
port
is the port number to which the server is listening for client requests. If
not specified, it is assumed to be port 9090.
The presence of the
–ws
option makes the syscli program work in client-server
mode; it will not execute the command on the local DXi system anymore.
Rather, it will send the command to the axis2 server on the specified remote
system. This server will then invoke the syscli program on the system it is
running to execute the requested command and then send the result back to
the syscli client to display.
To get more help on Web Services, type “
syscli help ws
”.
Example: The following commands are equivalent:
• syscli --list share ... --ws
• syscli --list share ... --ws localhost:9090
• syscli --list share ... --ws localhost