x/steth
Code Issues Proposed changes

Merge "Correct instructions for using Steth"

Browse Source
This commit is contained in:
Jenkins 2016-04-19 14:12:54 +00:00 committed by Gerrit Code Review
commit 7486d30dc1
3 changed files with 46 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
docs/index.rst
View File

@ -11,6 +11,7 @@ A network inspection tool for OpenStack.
* Wiki: https://wiki.openstack.org/wiki/Steth
* Docs: http://steth.readthedocs.org/
-----------
Description
-----------

4
multi-node-architecture.rst → docs/multi-node-architecture.rst
View File

@ -3,7 +3,7 @@ Multi-node Architecture
-----------------------
::
note that steth does not save
any state, it acts as a rpc
client which makes requests to steth
@ -41,7 +41,7 @@ Multi-node Architecture
In a scenario using multiple nodes, Steth is a stateless CLI and controller.
It knows each steth agent and will read config files, interact with OpenStack,
and sending instructions to agents when needed.
and sending instructions to agents when needed.
Steth Agent is introduced to manage processes or run commands. It should be
installed in each compute and network node, and their IPs should be specified

89
docs/quickstart.rst
View File

@ -1,78 +1,75 @@
..
Copyright 2011-2016 OpenStack Foundation
All Rights Reserved.
===============================
Steth's developer documentation
===============================
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
Welcome to Steth's developer documentation!
===========================================
Steth is an inspection tool that can aid in pinpointing issues before deployment and during operation of an OpenStack environment.
Steth is an inspection tool that can aid in pinpointing issues before deployment
and during operation of an OpenStack environment.
-----------
Quick start
===========
-----------
Steth is a network inspection tool for OpenStack.
It is modelled as agent(s)/client in which a controller interacts with
agents deployed in your environment. Let me introduce how to use steth.
-------------
Download code
-------------
Download the latest code from git repository. And run ``python setup.py install``
to install steth. After running that, you can ``steth - -help`` to confirm Steth
is installed correctly.
Download the latest code from git repository. And run
``python setup.py install`` to install steth. After running that, you can
``steth --help`` to confirm Steth is installed correctly.
------------------
Deploy Steth Agent
------------------
Steth Agent listens in 0.0.0.0:9698 on any node you want. It will wait for
RPC request. Currently we support CentOS 6.5, CentOS 7.0 and CentOS 7.1 only.
In CentOS 6.5, you should run ``service steth-agent start`` to start steth-agent.
In CentOS 7.0 and 7.1, you should run ``systemctl start steth`` to start steth-agent.
In CentOS 6.5, you should run ``service steth-agent start`` to start
steth-agent. In CentOS 7.0 and 7.1, you should run ``systemctl start steth``
to start steth-agent.
-------------------
Deploy Steth Client
-------------------
Steth Client is a stateless program. You can run ``steth - -help`` to show all steth
commands that you can run.
Steth Client is a stateless program. You can run ``steth --help`` to show all
steth commands that you can run.
------------------
Configuration File
---------------------
------------------
On start the client will read a configuration file. By default the configuration file is located at `/etc/steth/steth.conf`.
Here is an example about the configuration file: ::
On start the client will read a configuration file. By default the configuration
file is located at ``/etc/steth/steth.conf``.
# (ListOpt) list of networks types.
# We may have multi network types in one node, such as mgmt, net and stroage.
# so this value should be a list.
# We seperate each item by ":". Treat first item as network type.
# The second is physical nic name. And the third is network_prefix.
# Example: "mgmt:eth0:1.1.1.,net:eth1:2.2.2.,storage:eth2:3.3.3."
network_types=mgmt:eth0:1.1.1.,net:eth1:2.2.2.,storage:eth2:3.3.3.
Here is an example of the configuration file
# (ListOpt) All nodes info. Just need sequence number.
# Example: 64, 65, 66
nodes_id=39,233,64,65,66
::
# (StrOpt) Name prefix of every node. By default, this value
# is "server". We combine "node_name_prefix" with
# "nodes_id", to define nodes. Such as "server-64", "server-68"
# and so on. In every region, we give every node a specific name.
# Ensure that DNS can resolve the nodes.
node_name_prefix=server-
# (ListOpt) list of networks types.
# We may have multi network types in one node, such as mgmt, net and stroage.
# so this value should be a list.
# We seperate each item by ":". Treat first item as network type.
# The second is physical nic name. And the third is network_prefix.
# Example: "mgmt:eth0:1.1.1.,net:eth1:2.2.2.,storage:eth2:3.3.3."
network_types=mgmt:eth0:1.1.1.,net:eth1:2.2.2.,storage:eth2:3.3.3.
# (ListOpt) All nodes info. Just need sequence number.
# Example: 64, 65, 66
nodes_id=39,233,64,65,66
# (StrOpt) Name prefix of every node. By default, this value
# is "server". We combine "node_name_prefix" with
# "nodes_id", to define nodes. Such as "server-64", "server-68"
# and so on. In every region, we give every node a specific name.
# Ensure that DNS can resolve the nodes.
node_name_prefix=server-