diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..6c091b9 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +/wsmancli-2.6.0.tar.gz diff --git a/AUTHORS b/AUTHORS new file mode 100644 index 0000000..eb90a4e --- /dev/null +++ b/AUTHORS @@ -0,0 +1,17 @@ + +Maintainer: + Anas Nashif, Intel Corp. + +Developers: + Anas Nashif, Intel Corp. + Hou Liang, Intel Corp. + +Code originally from: + Eugene Yarmosh, Intel Corp. + +Contributions and Patches by: + Viktor Mihajlovski, IBM + Klaus Kaempf, Novell + + +If you think you name should be here and I forgot it, please let me know. diff --git a/COPYING b/COPYING new file mode 100644 index 0000000..696121a --- /dev/null +++ b/COPYING @@ -0,0 +1,27 @@ +Copyright (C) 2004-2006 Intel Corp. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + - Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + + - Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + + - Neither the name of Intel Corp. nor the names of its + contributors may be used to endorse or promote products derived from this + software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL Intel Corp. OR THE CONTRIBUTORS +BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. diff --git a/EMPTY b/EMPTY deleted file mode 100644 index 0519ecb..0000000 --- a/EMPTY +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/README b/README new file mode 100644 index 0000000..1cddbac --- /dev/null +++ b/README @@ -0,0 +1,195 @@ +How to compile and run openwsman from Subversion? +=============================== + +After checking out the project from subversion run ./autoconfiscate in the TOP directory and +follow that by running ./configure . +If you download a packaged version, then there is no need to run ./autoconfiscate and you will +be able to run ./configure directly. + +Most likely you will need to install some of the packages, depending on the distribution +you are running. + +Packages and other software needed: + +- libxml2 +- sfcc (from the sblim project) +- swig and python for python binding support +- other development packages like autoconf, automake etc. + +After all packages are installed, compile everything and install. The server can run as +a daemon, which would require root access; But it can be run in the foreground with debugging +messages printed to stdout as well. This the help output when you run: + +% /usr/local/sbin/openwsmand --help +Usage: + openwsmand [OPTION...] WS-Management Server + +Help Options: + -?, --help Show help options + +Application Options: + -n, --no-plugins Do not load any plugins + -d, --debug Start daemon in foreground and turn on debugging + -s, --syslog=0-6 Set the verbosity of syslog output. + -c, --config-file= Alternate configuration file + + +Starting from version 0.1.1 a configuration file is needed. you can find an example in the +./etc directory. The configuration file has the following syntax: + +[server] +port = 8889 +#ssl_port = 8888 +ssl_cert_file = /etc/openwsman/servercert.pem +ssl_key_file = /etc/openwsman/serverkey.pem +#digest_password_file = /etc/openwsman/digest_auth.passwd +basic_password_file = /etc/openwsman/simple_auth.passwd +enum_idle_timeout = 5000 + +min_threads = 1 +max_threads = 1 + +#use_digest is OBSOLETED, see below. + +# +# Authentication backend for BASIC authentication. Default is to read a configuration file defined with 'basic_password_file' +# + +#basic_authenticator = libwsman_pam_auth.so +#basic_authenticator_arg = openwsman + + +[client] +port = 8889 +agent = openwsman 1.5.9 + +[cim] +default_cim_namespace = root/cimv2 + +# The following are in part fake namespaces for some publicly available CIM implementations. +vendor_namespaces = OpenWBEM=http://schema.openwbem.org/wbem/wscim/1/cim-schema/2,Linux=http://sblim.sf.net/wbem/wscim/1/cim-schema/2,OMC=http://schema.omc-project.org/wbem/wscim/1/cim-schema/2,Reef=http://reef.sblim.sf.net/wbem/wscim/1/cim-schema/2,CWS=http://cws.sblim.sf.net/wbem/wscim/1/cim-schema/2 + + +To be able to put the configuration files under /etc/openwsman, run the configure script +with the --sysconfdir option using the value /etc. If this option is not used, the default will +be under PREFIX (/usr/local/etc ). + +To run in SSL mode you need to enable the SSL port and create certificates and adapt the configuration +with the correct path to the files. + +To start the server in the foreground, run: + +% /usr/local/sbin/openwsmand -d + +You can also specify the configuration file to be used on the command line using the -c option. + + +On the client side, which has the following options + + % /usr/local/bin/wsman --help-all + +Usage: + wsman [Option...] + +Usage: + wsman [Option...] + +Help Options + -?, --help + --help-all Show help options + --help-enumeration Enumeration Options + --help-tests Test Cases + --help-cim CIM Options + --help-flags Request Flags + --help-event Subscription Options + +Enumeration + -m, --max-elements= Max Elements Per Pull/Optimized Enumeration + -o, --optimize Optimize enumeration results + -E, --estimate-count Return estimation of total items + -M, --enum-mode=epr|objepr Enumeration Mode + -U, --enum-context= Enumeration Context (For use with Pull and Release) + +Tests + -f, --from-file= Send request from file + -R, --print-request print request on stdout + -Q, --request Only output reqest. Not send it. + -S, --step Do not perform multiple operations (do not pull data when enumerating) + +CIM + -N, --namespace= CIM Namespace (default is root/cimv2) + -B, --binding-enum-mode=none|include|exclude CIM binding Enumeration Mode + -T, --cim-extensions Show CIM Extensions + -W, --references CIM References + -w, --associators CIM Associators + +Flags + -x, --filter= Filter + -D, --dialect= Filter Dialect + -t, --operation-timeout=