Fix a typo and add troubleshooting in tools README
It was discovered that the example paths included in the README.rst used monasca-persister rather than monasca_persister. Also added a footnote with two error messages that occur when the contact_points is not specified correctly. Story: 2005305 Task: 30611 Change-Id: I0c53af817504e638bd82401ca0b62874cb591f36
This commit is contained in:
parent
f37811fdef
commit
5e1823de06
|
@ -24,13 +24,19 @@ Usage
|
||||||
Steps to use this tool:
|
Steps to use this tool:
|
||||||
|
|
||||||
- Log in to one node where monasca-persister is deployed.
|
- Log in to one node where monasca-persister is deployed.
|
||||||
|
|
||||||
- Identify installation path to monasca-persister. This may be a
|
- Identify installation path to monasca-persister. This may be a
|
||||||
virtual environment such as
|
virtual environment such as
|
||||||
`/opt/stack/venv/monasca-<version>/lib/python2.7/site-packages/monasca-persister`
|
`/opt/stack/venv/monasca-<version>/lib/python2.7/site-packages/monasca_persister`
|
||||||
or as in devstack `/opt/stack/monasca-persister/monasca_persister/`.
|
or as in devstack
|
||||||
|
`/opt/stack/monasca-persister/monasca_persister/`.
|
||||||
|
|
||||||
- Identify the existing configuration for monasca-persister. If using a
|
- Identify the existing configuration for monasca-persister. If using a
|
||||||
java deployment, it may be in `/opt/stack/service/monasca/etc/persister-config.yml`
|
java deployment, it may be in
|
||||||
or in devstack `/etc/monasca/persister.conf`
|
`/opt/stack/service/monasca/etc/persister-config.yml`
|
||||||
|
or in devstack
|
||||||
|
`/etc/monasca/persister.conf`
|
||||||
|
|
||||||
- Copy and modify the config template file.
|
- Copy and modify the config template file.
|
||||||
|
|
||||||
::
|
::
|
||||||
|
@ -39,18 +45,22 @@ Steps to use this tool:
|
||||||
vi /opt/stack/service/monasca/etc/persister-recreate.ini
|
vi /opt/stack/service/monasca/etc/persister-recreate.ini
|
||||||
|
|
||||||
- Copy the values from the monasca-persister config in to the new .ini,
|
- Copy the values from the monasca-persister config in to the new .ini,
|
||||||
particularly the password. In some cases, the single IP for the
|
particularly the password.
|
||||||
management network of one of the Cassandra nodes may need to be given,
|
|
||||||
rather than the list of hostnames as specified in the .yml.
|
- The single IP for the management network of one of the Cassandra nodes
|
||||||
|
should be given for the contact_points value, rather than the list of
|
||||||
|
hostnames as specified in the .yml. [#f1]_
|
||||||
|
|
||||||
- Copy the `persister-recreate-metric-id.py` and `persister-check-missing-metric-id.py`
|
- Copy the `persister-recreate-metric-id.py` and `persister-check-missing-metric-id.py`
|
||||||
files in to place with the monasca-persister code.
|
files in to place with the monasca-persister code.
|
||||||
|
|
||||||
::
|
::
|
||||||
|
|
||||||
cp persister-*-metric-id.py /opt/stack/venv/monasca-<version>/lib/python2.7/site-packages/monasca-persister
|
cp persister-*-metric-id.py /opt/stack/venv/monasca-<version>/lib/python2.7/site-packages/monasca_persister
|
||||||
|
|
||||||
- Ensure the `mon-persister` user has permission to access both
|
- Ensure the `mon-persister` user has permission to access both
|
||||||
`persister-recreate.ini` and `persister-recreate-metric-id.py`.
|
`persister-recreate.ini` and `persister-recreate-metric-id.py`.
|
||||||
|
|
||||||
- Invoke the tool to generate a log of rows needing repair.
|
- Invoke the tool to generate a log of rows needing repair.
|
||||||
|
|
||||||
::
|
::
|
||||||
|
@ -68,6 +78,18 @@ Steps to use this tool:
|
||||||
may be deleted.
|
may be deleted.
|
||||||
|
|
||||||
|
|
||||||
|
.. [#f1] Using the wrong format locator for the contact_points may result in errors:
|
||||||
|
|
||||||
|
- Giving the wrong IP address:
|
||||||
|
::
|
||||||
|
|
||||||
|
NoHostAvailable: ('Unable to connect to any servers', {'192.168.0.0': error(111, "Tried connecting to [('192.168.0.0', 9042)]. Last error: Connection refused")})
|
||||||
|
|
||||||
|
- Giving a hostname rather than IP:
|
||||||
|
::
|
||||||
|
|
||||||
|
gaierror: [Errno -2] Name or service not known
|
||||||
|
|
||||||
License
|
License
|
||||||
=======
|
=======
|
||||||
|
|
||||||
|
@ -85,4 +107,4 @@ Unless required by applicable law or agreed to in writing, software
|
||||||
distributed under the License is distributed on an “AS IS” BASIS,
|
distributed under the License is distributed on an “AS IS” BASIS,
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
See the License for the specific language governing permissions and
|
See the License for the specific language governing permissions and
|
||||||
limitations under the License.
|
limitations under the License.
|
||||||
|
|
Loading…
Reference in New Issue