Wiki code for cluster2dot

Hide Line numbers
1: == Utility to visualize Resource Group and Resource Dependencies and Affinities
2: 
3:  The Open HA Cluster utilities available from this project page are released under the [[Common Development and Distribution License (CDDL) Version 1.0>>Main.opensolaris_license]].
4: 
5: [[Solaris Cluster Express>>Community Group ha-clusters.SCX]] did improve a lot with the [[new command line interface>>http://dlc-cdn.sun.com/pdf/819-6811/819-6811.pdf]] and the updated [[Solaris Cluster Manager Browser User Interface (BUI)>>http://docs.sun.com/app/docs/doc/820-2558/x-4n6hc?a=view]]. The BUI has a Topology view for resource groups and resources in order to visualize the various dependencies and affinities the cluster framework offers.
6: 
7: It is also a good idea to document a cluster configuration carefully. For that purpose an online view within a BUI is not always helping. And sometimes you want to see all dependencies/affinities within one graph.
8: 
9: Fortunately the cluster framework does offer the [[scha_cmds(1HA) API>>http://docs.sun.com/app/docs/doc/820-2559/reference-3?a=view]], which makes it possible to retrieve all informations out of the cluster and use them e.g. in shell scripts. And there are already tools available as open source which do a great job in visualizing graphs. One tool I selected is [[Graphviz>>http://www.graphviz.org/]], which is available for a lot of platforms, including Solaris. The [[Companion  Software CD for Solaris>>http://www.sun.com/software/solaris/freeware/]] does provide a ready to install package for SPARC and x86.
10: 
11: The [[cluster2dot>>http://opensolaris.org/sc/src/ha-utilities/ha-utilities/cluster2dot/cluster2dot.ksh]] shell script extracts the necessary informations out of the cluster framework and creates two files, one for the resource groups with dependencies and various affinities, and one for the resouces with the various dependencies. The files contain the output ready for the dot language consumed by Graphviz.
12: 
13: You can [[browse the source>>http://src.opensolaris.org/source/xref/ha-utilities/ha-utilities/cluster2dot/cluster2dot.ksh]] online, presented through OpenGrok.
14: 
15: The script will create two files for further use:
16: 
17: 1. {{code}}/tmp/${CLUSTERNAME}-resourcegroups.dot{{/code}}
18: 1. {{code}}/tmp/${CLUSTERNAME}-resources.dot{{/code}}
19: 
20: Both files can then be used as input files for the dot command within the graphviz tools, e.g.:
21: 
22: {{{
23: 
24: $ dot -Tps /tmp/${CLUSTERNAME}-resources.dot -o ${CLUSTERNAME}-resources.ps
25: 
26: }}}
27: 
28: to create a postscript file to visualize the dependencies.
29: 
30: 1. is creating a directed graph for resource group dependencies and affinities.
31: 1* black solid arrow = RG dependency
32: 1* green solid arrow = strong positive affinity with failover delegation
33: 1* blue solid arrow = strong positive affinity
34: 1* brown dotted arrow = weak positive affinity
35: 1* red solid arrow = strong negative affinity
36: 1* orange dotted arrow = weak negative affinity
37: 1. is creating a directed graph for the various resource dependencies.
38: 1* black solid arrow = resource dependency
39: 1* black dotted arrow = weak resource dependency
40: 1* red solid arrow = restart dependency
41: 1* orange solid arrow = offline restart dependencies
42: 1* yellow solid arrow = implicit dependency on network resources
43: 
44: Here you can see some example outputs, in this case converted into png files. You can click on the images to enlarge them for better view.
45: 
46: [[[[image:evans-resourcegroups.png||alt="evans-resourcegroups.png"]]
47: Figure 1>>Project ha-utilities.evans-resourcegroups.png]]: Resource dependencies graph for the evans cluster. View the corresponding [[dot file>>attach:evans-resourcegroups.dot.txt]].
48: 
49: [[[[image:evans-resources.png||alt="evans-resources.png"]]
50: Figure 2>>Project ha-utilities.evans-resources.png]]: Resource dependencies graph for the evans cluster. View the corresponding [[dot file>>attach:evans-resources.dot.txt]].
51: 
52: [[[[image:geo-muc1-resourcegroups.png||alt="Resource dependencies graph for the geo-muc1 cluster"]]
53: Figure 3>>Project ha-utilities.geo-muc1-resourcegroups.png]]: Resource group dependencies graph for the geo-muc1 cluster. View the corresponding [[dot file>>attach:geo-muc1-resourcegroups.dot.txt]].
54: 
55: [[[[image:geo-muc1-resources.png||alt="geo-muc1-resources.png"]]
56: Figure 4>>Project ha-utilities.geo-muc1-resources.png]]: Resource dependencies graph for the geo-muc1 cluster. View the corresponding [[dot file>>attach:geo-muc1-resources.dot.txt]].
OpenSolaris

Top Menu

Wiki code for cluster2dot

Search

Collectives

Community Group

Project

User Group

Subsites

Project ha-utilities Pages
