Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxlevel3
minlevel2
typeflat
separatorpipe

...

The Confluence server must have the Graph Visualization Software (Graphviz) package installed in order for the Graphviz Plugin Diagrams for Confluence macros to work. The Graphviz package is free and supports a variety of operating systems including those supported by Confluence. 

Tip
titleTest your Graphviz installation

After you have installed Graphviz, make sure the dot executable is able to be run from a command line using the same environment (especially the path) used to startup Confluence.

If Confluence cannot find the executable, you will get macro errors in Confluence like: No useable executable name ...

...

  1. Download and run the installer.
  2. The installer should set up everything so that dot is found on the path 

Graphviz on Linux and Unix

  1. Install the graphviz.rpm, the graphviz-graphs.rpm, and the graphviz-gd.rpm packages
  2. Open the directory GraphViz is installed under and confirm the path
  3. Login as the user who runs Confluence or starts the Confluence service
  4. Append the path to the bin directory of GraphViz to the 'Path' variable

Last resort

This is not recommended, but, if you just can't get your path set correctly to find the dot executable, then this is an alternative. 

Info
titleIf you get errors about not finding dot.exe
  1. Download the plugin jar file
  2. Unzip the jar to a temporary directory
  3. Edit the graphviz.properties file
    • Replace dot.candidate.paths setting with something like (yes, use forward slashes (smile)):

      No Format
      dot.candidate.paths=c:/PROGRA~1/Graphviz2.16/bin/dot.exe
      
  4. Zip all files in the temporary directory to create a new jar file
  5. Uninstall the graphviz plugin and re-install your customized version
  6. GVIZ-1 will make this easier

...