Package: satori
Satori provides configuration discovery for existing infrastructure. It is
arelated OpenStack project.The charter for the project is to focus narrowly on discovering pre-existing
infrastructure and installed or running software. For example, given a URL and
some credentials, discover which resources (load balancer and servers) the URL
is hosted on and what software is running on those servers.Configuration discovery output could be used for:Configuration analysis (ex. compared against a library of best practices)Configuration monitoring (ex. has the configuration changed?)TroubleshootingHeat Template generationSolum Application creation/importCreation of Chef recipes/cookbooks, Puppet modules, Ansible playbooks, setup
scripts, etc..Getting StartedRun discovery on the local system:$ pip install satori

$ satori localhost --system-info=ohai-solo -F json
# Installs and runs ohai-solo, outputs the data as JSONRun against a URL with OpenStack credentials:$ pip install satori

$ satori https://www.foo.com
 Address:
     www.foo.com resolves to IPv4 address 192.0.2.24
 Domain: foo.com
     Registrar: TUCOWS, INC.
 Nameservers: NS1.DIGIMEDIA.COM, NS2.DIGIMEDIA.COM
     Expires: 457 days
 Host not foundDeeper discovery is available if the network location (IP or hostname) is
hosted on an OpenStack cloud tenant that Satori can access.Cloud settings can be passed in on the command line or viaOpenStack tenant environment
variables.Run with OpenStack credentials:$ satori 192.0.2.24 --os-username yourname --os-password yadayadayada --os-tenant-name myproject --os-auth-url http://...Or:$ export OS_USERNAME=yourname
$ export OS_PASSWORD=yadayadayada
$ export OS_TENANT_NAME=myproject
$ export OS_AUTH_URL=http://...
$ satori foo.comNotice the discovery result now contains aHostsection:$ satori 192.0.2.24 --os-username yourname --os-password yadayadayada --os-tenant-name myproject --os-auth-url http://...
Host:
  192.0.2.24 is hosted on a Nova Instance
  Instance Information:
      URI: https://nova.api.somecloud.com/v2/111222/servers/d9119040-f767-414
           1-95a4-d4dbf452363a
      Name: sampleserver01.foo.com
      ID: d9119040-f767-4141-95a4-d4dbf452363a
  ip-addresses:
      public:
          ::ffff:404:404
          192.0.2.24
      private:
          10.1.1.156
  System Information:
      Ubuntu 12.04 installed
      Server was rebooted 11 days, 22 hours ago
      /dev/xvda1 is using 9% of its inodes.
  Running Services:
      httpd on 127.0.0.1:8080
      varnishd on 0.0.0.0:80
      sshd on 0.0.0.0:22
  httpd:
      Using 7 of 100 MaxClientsDocumentationAdditional documentation is located in thedoc/directory and is hosted athttp://satori.readthedocs.org/.Start HackingWe recommend using a virtualenv to install the client. This description
uses theinstall virtualenvscript to create the virtualenv:$ python tools/install_venv.py
$ source .venv/bin/activate
$ python setup.py developUnit tests can be ran simply by running:$ tox

# or, just style checks
$ tox -e pep8

# or, just python 2.7 checks
$ tox -e py27Checking test coverage:# Run tests with coverage
$ tox -ecover

# generate the report
$ coverage html -d covhtml -i

# open it in a broweser
$ open covhtml/index.htmlLinksOpenStack  WikiDocumentationCodeLaunchpad ProjectFeaturesIssues