Enabling the Flowchart Macro

Installation

This plugin must be installed by a System Administrator.

1. Install GraphViz.
   
   
2. Install Apache Ant.
   
   
3. If running on Windows, restart your computer.
   
   
4. Instructions to insert the GraphViz installation directory path into the PATH environment variable depend on your operating system.
   
   Windows Users
   1. Open the directory GraphViz is installed under and confirm the path. An example path is C:\Program Files\ATT\Graphviz\bin
   2. Go to Start > Control Panel > System.
   3. Select the 'Advanced' tab, then 'Environment Variables'.
   4. Under 'System Variables', select the 'Path' variable.
   5. Select 'Edit' and view the 'Variable value' text.
   6. Confirm that path to the bin directory of GraphViz is appended to this string in the MS-DOS 8.3 standard and separated by a semicolon. An example might be ;C:\PROGRA~1\ATT\Graphviz\bin
      
      Linux, OS X or Unix Users:
      i. Open the directory GraphViz is installed under and confirm the path.
      ii. Login as the user who runs Confluence or starts the Confluence service.
      iii. Append the path to the bin directory of GraphViz to the 'Path' environment variable.
      
      
5. Build the GraphViz plugin from source.
   
   
   1. Stop Confluence.
   2. Open a command window in your Confluence install directory and go to the plugins directory.
   3. From the plugins directory, compile the GraphViz by running ant -Dlibrary=graphviz install
   4. Start Confluence.

Usage

See the Flowchart Macro documentation in the User Guide.

Troubleshooting

Error Message

flowchart: No useable executable name defined in graphviz.properties
graphviz: No useable executable name defined in graphviz.properties
spacegraph: No useable executable name defined in graphviz.properties

Solution

1. Check that the system 'Path' variable includes a path to dot.exe, the executable file contained in the Graphviz bin directory.
2. Restart Confluence server