| Table of Contents | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
The Confluence server must have the Graph Visualization Software (Graphviz) package installed in order for the Graphviz Diagrams for Confluence macros to work. The Graphviz package is free and supports a variety of operating systems including those supported by Confluence.
| Tip | ||
|---|---|---|
| ||
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 ... |
Downloading Graphviz
Before you can use Graphviz Diagrams for Confluence you will need to download and install Graph Visualization Software (Graphviz) on the system where you are running Confluence. Download the correct version of the software that matches your environment. You can find the available versions on the Graphviz Downloads page. Once the download is complete then following the instructions below for your operating system.
Graphviz on Windows
- Download the installer from this link
- The default installation path will be C:\Program Files (x86)\GraphvizX.XX\bin (Example: GraphvizX.XX → Graphviz2.38)
Open cmd window as administrator and
run the Windows installerDefaults to install ingo the location C:\Program Files (x86)\GraphvizX.XX\bin and run the below command
No Format dot.exeExit the command window.
Go to the Control Panel → System and Security → System and on the right side navigation panel you will see the link Advanced systems settings.
Once there in advance settings, a dialogue box will open which will show the button Environment Variables. Click on the button Environment Variables.
Select the entry "Path" on system variables section and add C:\Program Files (x86)\
Graphviz2.16 or similar- Automatically adds this to your Windows path Confirm that you can run dot.exe from a newly opened command line
- Click on Ok Button.
- Restart Confluence from a new cmd window.
- Go to system information page on confluence instance.
- Verify if you are able to see C:\Program Files (x86)\GraphvizX.XX\bin on "Path" attribute on system information page in confluence.
- If the path is available that means that the configuration changes are successful.
- Go the page where you have used the macro and verify if the add-ons works.
- Restart Confluence
Verify it works by creating a page with a simple flowchart macro like:
No Format {flowchart} A -> B {flowchart}
GraphvizX.XX\bin to the existing path. Please see the below screenshot for reference. 
Note: Please make sure you add ";" at the PATH which is already existing under User Variables and mention the path C:\Program Files (x86)\GraphvizX.XX\bin. Also please add a New path on the system variables section and add the Path C:\Program Files (x86)\GraphvizX.XX\bin
...
- Follow the instructions mentioned here.
- The installer should set up everything so that dot is found on the path
Graphviz on Linux and Unix
- Install the graphviz.rpm, the graphviz-graphs.rpm, and the graphviz-gd.rpm packages
- Open the directory GraphViz is installed under and confirm the path
- Login as the user who runs Confluence or starts the Confluence service
- Append the path to the
bindirectory of GraphViz to the 'Path' variable
Last resort
This should not be needed and 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 | ||
|---|---|---|
| ||
|
):...