Re: Troubleshooting and Diagnostic tools for Gluster

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Friday 23 October 2015 04:16 PM, Aravinda wrote:
Hi Gluster developers,

In this mail I am proposing troubleshooting documentation and
Gluster Tools infrastructure.

Tool to search in documentation
===============================
We recently added message Ids to each error messages in Gluster. Some
of the error messages are self explanatory. But some error messages
requires manual intervention to fix the issue. How about identifying
the error messages which requires more explanation and creating
documentation for the same. Even though the information about some
errors available in documentation, it is very difficult to search and
relate to the error message. It will be very useful if we create a
tool which looks for documentation and tells us exactly what to do.

For example,(Illustrativepurpose only)
glusterdoc --explain GEOREP0003

     SSH configuration issue. This error is seen when Pem keys from all
     master nodes are not distributed properly to Slave
     nodes. Use Geo-replication create command with force option to
     redistribute the keys. If issue stillpersists, look for any errors
     while running hook scripts inGlusterd log file.


Note: Inspired from rustc --explain command
https://twitter.com/jaredforsyth/status/626960244707606528

If we don't know the message id, we can still search from the
available documentation like,

     glusterdoc --search <SEARCH_KEY_WORD>

These commands can be programmatically consumed, for example
`--json` will return the output in JSON format. This enables UI
developers to automatically show help messages when they display
errors.

Gluster Tools infrastructure
============================
Are our Gluster log files sufficient for root causing the issues? Is
that error caused due to miss configuration? Geo-replication status is
showing faulty. Where to find the reason for Faulty?

Sac(surs AT redhat.com) mentioned that heis working on gdeploy and many
developers
are using their owntools. How about providing common infrastructure(say
gtool/glustertool) to host all these tools.


Would this be a repository with individual tools being git submodules or something similar? Is there also a plan to bundle the set of tools into a binary package?

Looks like a good idea to me.

-Vijay

_______________________________________________
Gluster-devel mailing list
Gluster-devel@xxxxxxxxxxx
http://www.gluster.org/mailman/listinfo/gluster-devel



[Index of Archives]     [Gluster Users]     [Ceph Users]     [Linux ARM Kernel]     [Linux ARM]     [Linux Omap]     [Fedora ARM]     [IETF Annouce]     [Security]     [Bugtraq]     [Linux]     [Linux OMAP]     [Linux MIPS]     [eCos]     [Asterisk Internet PBX]     [Linux API]

  Powered by Linux