Metadata-Version: 1.1
Name: smipyping
Version: 0.6.0
Summary: A pure Python client for SNIA SMI test support.
Home-page: https://bitbucket.com
Author: Karl Schopmeyer
Author-email: k.schopmeyer@swbell.net
License: Apache License, Version 2.0
Description: smipyping: Python SMI Laboratory Test Tools
        ===========================================
        
        About this project
        ------------------
        
        smipyping is a set of WBEM server test tools based on the pywbem WBEM
        client implementation. The goal is to provide a variety of tools to be
        able to test the current status of WBEM servers both superically and by
        analyzing the details of the server code using the SNIA smi profiles to
        define the details of the server.
        
        Installation Requirements
        -------------------------
        
        1. Python 2.7. At this point, this package will only run with Python 2.7 because
           one of the core packages (scapy) is Python 2 only.
        
        2. smipyping - Installed as part of the smipyping installation
        
        3. Linux - Including linux tools like make, etc.
        
        We do NOT support python 3 right now primarily because one required package
        (scapy) does not support python 3. Plans are to remove this requirement and
        then smipyping will support python 3.
        
        Installation
        ------------
        
        See INSTALL.md
        
        Usage
        -----
        
        smipyping consists of a number of scripts that provide tests of WBEM Servers.
        
        These are documented in the smipyping documentation.
        
        This includes:
        
        smicli
        ^^^^^^
        
        This is a multilevel cli program that will include all the functionality
        in the following commands: This tool incorporates a number of subcommands
        including the following subcommands:
        
        ::
        
            cimping   Command group to do simpleping.
            explorer  Command group for general provider explore.
            help      Show help message for interactive mode.
            provider  Command group for simple provider operations.
            repl      Enter interactive (REPL) mode (default).
            sweep     Command group to sweep for servers.
            targets   Command group for managing targets data.
        
        The smicli command structure is described in detail in the documentation.
        It includes built-in help at every level of the command to define the arguments
        and options for that level. Thus, for example, you can request help as follows:
        
        .. code-block:: bash
        
            smicli --help                   - Top level help
            smicli cimping --help           - Tells you what options/cmds exist under
                                              cimping
            smicli cimping providers --help - Parameters for this subcommand that
                                              executes a simple ping against a host.
        
        smicli has replaced all other separate scripts with subcommands in smicli and
        these scripts are being removed from the code base.
        
        simpleping
        ^^^^^^^^^^
        
        This tool has been obsoleted after integration into smicli.
        
        
        serversweep
        ^^^^^^^^^^^
        
        This tool has been obsoleted after integration into smicli.
        
        
        explore
        ^^^^^^^
        
        This tool has been obsoleted after integration into smicli.
        
        
        
        Targets databases
        -----------------
        
        smipyping depends heavily on some form of database for the following
        information:
        
        * target wbem server connection information  including ip addresses,
          passwords, user names, ports, and https/http. In addition the current
          databases include information on ports,  profiles, etc. which is being
          weaned out of the database requirements.
        
        * Information on users, etc. to supplement reports on the status of the
          wbem server environment.
        
        No database is supplied with the clone or pip of smipyping because the
        database of targets can contain sensitive information such as names and
        passwords.
        
        
        smipyping allows for multiple types of databases:
        
        * sql (mysql). Addition of sqlite is in process but incomplete today
        * csv (comma-separated-values) file as a database for at least the the
          definitions of the target WBEM servers to be tested.
        
        mysql database
        ^^^^^^^^^^^^^^
        
        The Mysql database defines a number of tables.
        
        
        csv database
        ^^^^^^^^^^^^
        A simple csv file that is in the root directory serves as the current definition
        of servers as an alternative to the mysql database.
        
        smicli configuration file
        -------------------------
        
        smipyping uses a configuration file (default smicli.ini) as the basis for
        much of the configuration to simplify command line parameters.  This file is
        in standard ini format with sections and name/value pairs.
        
        The file allows the user to define the database used, logging configuration,
        and other information about the configuration for smicli.
        
        This configuration file is defined in detail in the example and a sample
        file is included as smicli-example.ini.  This can be used as the configuration
        file by completing the values concerning database configuration and changing
        the name to smicli.ini.
        
        
        Status
        ------
        
        This code is under development and is provided today in as-is status.
        
        
        License
        -------
        
        smipyping is provided under the Apache-2 license.
        
        Examples:
        ---------
        
        Running a serversweep
        
        .. code-block:: bash
        
            smicli sweep all
        
        ::
        
            Open WBEMServers:subnet(s)=['10.1.132,134,136', '10.2.100:117.1:50']
            port(s)=[5988, 5989] range 1:254, time 3.11 min
                total pings=3324 pings answered=66
             IPAddress          CompanyName      Product              SMIVersion
            ──────────────────────────────────────────────────────────────────────
             10.1.132.135:5989  Unknown
             10.1.132.176:5988  Unknown
             10.1.132.177:5988  Unknown
             10.1.132.178:5988  Unknown
             10.1.132.179:5988  Unknown
             10.1.132.22:5989   Unknown
             10.1.132.24:5989   EMC              VNXe (Unified)       1.4/1.5/1.6
             10.1.132.53:5988   Unknown
             10.1.132.53:5989   Unknown
             10.1.132.70:5989   Unknown
             10.1.132.86:5988   Unknown
             10.1.132.86:5989   Tintri           VMStore              0
             10.1.132.87:5988   Unknown
             10.1.132.87:5989   Unknown
             10.1.134.116:5989  Dot Hill         Assured SAN 5720     1.5
             10.1.134.117:5989  Dot Hill         Assured SAN 5720     1.5
             10.1.134.136:5988  Fujitsu          DX200S3              1.6
             10.1.134.136:5989  Unknown
             10.1.134.137:5989  Hewlett Packard  HP P9500 (Embedded)  1.3.0/1.5.0
             10.1.134.143:5988  Unknown
             10.1.134.143:5989  Unknown
             10.1.134.144:5988  Unknown
             10.1.134.144:5989  Unknown
             10.1.134.146:5989  Hewlett Packard  P2000 G3 MSA         1.5
             10.1.134.147:5989  Hewlett Packard  P2000 G3 MSA         1.5
             10.1.134.148:5989  Hewlett Packard  P2000 G3 MSA         1.5
             10.1.134.163:5989  Brocade          BRCD1 Fabric
             10.1.134.167:5988  Unknown
             10.1.134.167:5989  Unknown
             10.1.134.182:5989  Unknown
             10.1.134.185:5988  Unknown
             10.1.134.186:5988  Unknown
             10.1.134.186:5989  EMC              FC HBA               1.4
             10.1.134.187:5988  Unknown
             10.1.134.187:5989  Unknown
             10.1.134.188:5988  Unknown
             10.1.134.188:5989  Unknown
             10.1.134.190:5989  Unknown
             10.1.134.219:5989  Unknown
             10.1.134.38:5989   Unknown
             10.1.134.75:5988   Unknown
             10.1.134.75:5989   EMC              VNX Storage Array    1.6
             10.1.134.91:5988   Unknown
             10.1.134.91:5989   Fujitsu          DX200S3              1.6
             10.1.134.96:5988   Unknown
             10.1.134.96:5989   Dell/Compellent  Storage Center       1.5
             10.1.134.98:5988   Unknown
             10.1.134.98:5989   Fujitsu          DX80S2               1.4
        
             . . .
        
        Running smicli cimping
        ----------------------
        
        .. code-block:: bash
        
            smicli cimping id 4
        
        ::
        
            SimplePing server None, target_id 4
            cimping url=https://10.1.134.96, ns=root/compellent, principal=******, cred=********
            Running
        
        A running server reports 'Running'
        
        A failed server reports errors as follows:
        
        .. code-block:: bash
        
            smicli cimping id 3
        
        ::
        
            SimplePing server None, target_id 3
            cimping url=https://10.1.137.211, ns=cimv2, principal=smilab6, cred=F00sb4ll
            https://10.1.137.211 Error Response, Exit code 4 TimeoutError The client timed out and closed the socket after 11s.
        
        
        Running smicli explorer
        -----------------------
        
        .. code-block:: bash
        
            smicli explorer id 4
        
        ::
        
             Server Basic Information
             Id  Url                  Brand  Company          Product         Vers  SMI Profiles  Interop_ns  Status   time
            ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────
             04  https://10.1.134.96         Dell/Compellent  Storage Center                                  PyWBMEr  0.40 s
        
        
        .. code-block:: bash
        
            smicli explorer id 3
        
        ::
        
            Server Basic Information
             Id  Url                   Brand  Company  Product  Vers  SMI Profiles  Interop_ns  Status   time
            ────────────────────────────────────────────────────────────────────────────────────────────────────
             03  https://10.1.137.211         Cisco    DCNM                                     PyWBMEr  7.60 s
        
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
