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 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 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 defined in graphviz.properties...

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

  1. Download the installer from this link
  2. The default installation path will be C:\Program Files (x86)\GraphvizX.XX\bin (Example: GraphvizX.XX → Graphviz2.38)
  3. Open cmd window as administrator and go the location C:\Program Files (x86)\GraphvizX.XX\bin and run the below command:

    No Format
    dot.exe


  4. Exit the command window.

  5. Go to the Control Panel →  System and Security → System, and on the right side navigation panel, you will see the link Advanced systems settings.

  6. Once there in advance settings, a dialogue box will open which will show the button Environment Variables. Click on the button Environment Variables.

  7. Anchor
    gviz_install_step7
    gviz_install_step7
    Select the entry "Path" on the system variables section and add C:\Program Files (x86)\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

  8. Click on Ok Button. 
  9.  Restart Confluence from a new cmd window.
  10. Go to the system information page on confluence instance.
  11. Verify if you can see C:\Program Files (x86)\GraphvizX.XX\bin on "Path" attribute on system information page in confluence.
  12. If the path is available, that means that the configuration changes are successful. 
  13. Go the page where you have used the macro and verify if the add-ons work.
  14. Restart Confluence
  15. Verify it works by creating a page with a simple flowchart macro like:


    No Format
    {flowchart} 
    A -> B
    {flowchart}


Graphviz on Windows for

...

v2.38 or later

In the Graphviz download link

...

, it shows 2.38 as the latest version, but as of today, 2.43.x is the latest version for Windows.

...

Graphviz team

...

intends to make it available on the web as per the

...

this reference and this other reference.

  1. As per Graphviz team's suggestion, use the latest executable and missing config, that is, graphviz-2.43 file in this available on their page.
  2. So, you need You must to install the .exe and copy the config6 file in the bin folder after successful installation.
  3. After the installation is completed complete, follow the steps 7-15 mentioned above in the previous section with the latest 2.43.x version of the graphvizGraphviz.
  4. Check with dot -V at the command prompt whether you your changes are reflected.As we are finding some
Note

Due to some performance issues with 2.38 version of the Graphviz for Windows,

...

this section

...

has been added temporarily until the latest version installation instructions are made available on Graphviz Downloads location.

Graphviz on Mac OSX

  1. Follow the instructions mentioned here.
  2. The installer should set up everything so that the dot  appears under 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. Log in 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

The method mentioned in this section is not required and not recommended in most cases, but, if you 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 add-on 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 App and re-install your customized version
  6. GVIZ-1 will make this easier

...