This page last changed on Mar 01, 2007 by david.soul@atlassian.com.

Installation

This plugin must be installed by a Confluence 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 PATH 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
    1. Open the directory GraphViz is installed under and confirm the path
    2. Login as the user who runs Confluence or starts the Confluence service
    3. Append the path to the bin directory of GraphViz to the 'Path' variable

  5. Build the GraphViz plugin from source.

    2. Stop Confluence
    3. Open a command window in your Confluence install directory and go to the plugins directory
    4. From the plugins directory, compile the GraphViz by running ant -Dlibrary=graphviz install
    5. Start Confluence

Usage

See the Enable The Flowchart Macro 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

plugins-graphviz.jar (application/x-java-archive)
plugins-graphviz.jar (application/x-java-archive)
plugins-graphviz.jar (application/x-java-archive)

correcting myself
"ant install -Dlibrary=graphviz" is even easier...

Posted by phil at May 26, 2005 01:57

It seems to take a very very long time to do

Unknown macro: {spacegraphs}
for larger spaces (actually mine has been running for a few minutes now with no signs of coming back). If this does come back eventually, will the spacegraph be cached or will it be recomputed every time?

Posted by pwolpe at May 26, 2005 16:10

Sorry, I didn't realize I could used spacegraph in a comment ...

It seems to take a very very long time to do {spacegraph} for larger spaces (actually mine has been running for a few minutes now with no signs of coming back). If this does come back eventually, will the spacegraph be cached or will it be recomputed every time?

Posted by pwolpe at May 26, 2005 16:11

Would the IMAP output work within Confluence? This would be fanbloodytastic!!

Posted by stuart@leadiant.com at Jun 13, 2005 14:01

The cmapx output is used for the spacegraph macro. It should be possible to provide it as an option for the other graphviz macros. Please file an enhancement request.

Posted by tom@atlassian.com at Jun 13, 2005 19:14

http://jira.atlassian.com/browse/CONF-3399

Thanks

Posted by stuart@leadiant.com at Jun 13, 2005 19:25

This is a very cool feature. It generated a map of the demo space on my laptop in no time. Nice!!!!

Posted by bpatters7 at Jun 26, 2005 20:25

It's very Excellent, but when I use the language other than English, It seem works not very well.

Maybe it the problem of GraphViz? I don't know.

Posted by at Jul 28, 2005 06:08

My GraphViz plugin used to work. However, I now get a red box where I would expect the graph to be (on all pages which have graphs), but without any error message. Has anyone ever seen this type of an error? Any thoughts on how to fix it?

Posted by pwolpe at Sep 07, 2005 17:10

I'm trying to get the linking of shapes running, using the graphviz macro inside confluence, but it does not work:

Unknown macro: {graphviz}

digraph G {
C -> "C++" -> Java [URL="http://www.sun.com/java/"]
}

The sequence of the tree shapes is drawn correctly. If you try to click on the Java-shape, there's no hyperlink/URL assigned to it. Within mediaWiki (wikipedia.org) this works fine. Any ideas to get it running?

Posted by at Sep 15, 2005 04:17

Image maps aren't supported in the graphviz macro (except when it is being used in its spacegraph form)

This would be a useful enhancement – I've raised a JIRA tak for it here: http://jira.atlassian.com/browse/CONF-4037

Posted by at Sep 15, 2005 09:16

Image maps are supported in Confluence 1.5DR2 (and later).

Posted by tom@atlassian.com at Sep 16, 2005 01:55

I am a windows user. How do I install the plugin? You indicate to run "ant -Dlibrary=graphviz install". From where? From a dos prompt? I can't figure this out. Sorry but I'm not very familiar with java, but this being said, Confluence is GREAT!

Posted by mv@acea.be at Dec 13, 2005 01:34

Is there any particular reason that the example macros aren't in CONFEXT and in the contrib section of Subversion? Particularly with the more complex macros it would be nice to have them distributed in a similar fashion to the CONFEXT plugins, a process with which more people are familiar...

Just a thought.

Posted by david@randombits.org at Dec 13, 2005 01:46

We're working on that, David. Look for an annoucement soon.

Posted by jnolen at Dec 13, 2005 12:35

We're using Confluence inside a standalone Jira config. I, for the life of me, can't figure out how to install this macro. After trying the 'ant build' thing I get this:

Buildfile: build.xml

checklibrary:

build:
    [mkdir] Created dir: /services/sec-wiki/files/expand/confluence-2.0.3/plugins/graphviz/classes
    [javac] Compiling 8 source files to /services/sec-wiki/files/expand/confluence-2.0.3/plugins/graphviz/classes
    [javac] javac: target release 1.3 conflicts with default source release 1.5

BUILD FAILED
file:/services/sec-wiki/files/expand/confluence-2.0.3/plugins/build.xml:46: Compile failed; see the compiler error output for details.

Total time: 0 seconds

 

How do I get this installed in our configuration?

Posted by wraquel@uiuc.edu at Dec 13, 2005 16:43
<javac destdir="${library}/classes" target="1.5" debug="${debug}" deprecation="false" optimize="false" failonerror="true">
                        <src path="${library}/src/java"/>
                        <classpath refid="all-libs"/>
                </javac>

 

Just had the same problem, edited the build.xml, changed the marked word from target="1.3" to target="1.5" and up to now, it works

Posted by dietmar@krausenet.de at Jan 04, 2006 08:34

I can't understand why this macro is not already built.

The production system where we installed Confluence is not supposed to be a development one.

The "ant -Dlibrary=graphviz install" is not going to work and ant not supposed to be installed.

Can't you post this plugin as usual?

Thanks 

 

Posted by christian.barthelemy@airbus.com at Jan 25, 2006 15:01

I don't know why either. I attached a built version for convenience. You still need to install graphviz.

Posted by bob.swift@charter.net at Jan 25, 2006 20:36

Thank you Bob,

I now have the GraphViz pluiging with all five macros enabled.

However, I get the same error that a few people already experienced:
flowchart: No useable executable name defined in graphviz.properties.

I did installed graphviz-2.6.exe on our Windows 2003 Server and the system variable Path has the link to C:\Program Files\ATT\Graphviz\bin where it has been installed.

Has anyone solved this problem?

Posted by christian.barthelemy@airbus.com at Jan 26, 2006 05:48

I have it installed and working on Windows. I would double check the path variable is working - can you run the dot executable from the command line (say from c:) ?

Posted by bob.swift@charter.net at Jan 26, 2006 06:14

Yes, it works from the command line on the server.
I restarted the server also but it didn't solve the issue.

What version of GraphViz have you installed?

Posted by christian.barthelemy@airbus.com at Jan 26, 2006 06:25

2.6 - same version. Hmmm. Are you sure your app server is using the same path variable? Check the startup script and see what path is being used or explicitly add graphviz bin dir.

Posted by bob.swift@charter.net at Jan 26, 2006 10:04

Thank you Bob, I will check this: what startup script are you talking about?
Is it .\conf\bin\startup.bat ?

Posted by christian.barthelemy@airbus.com at Jan 26, 2006 10:13

Yes, something like that. If that doesn't work, you can unpack the jar and play with the graphviz.properties file. It should work as is, but, that is how it tries to find the dot.exe file.

Posted by bob.swift@charter.net at Jan 26, 2006 12:14

Sure is a drag how difficult it appears to be to get this graphviz app to compile on Solaris 9. I'd so love to be able to embed various equipment map drawings into a Wiki page instead of our folks having to always use tools like Visio, but so far hitting a wall getting either 2.6 or a 2.7 snapshot to function. (The 2.7 snapshot compiles, but dumps core when dot is called at the end of the install.) Oh well, haven't given up all hope yet. Will continue to plug along with it as I can....

Posted by amos at Jan 28, 2006 22:33

I have attached a compiled version based on 2.1.2:

  1. Unmodified - attachment version 2
  2. Modified to use gif instead of png (for some Linux installations)- attachment version 3
Posted by bob.swift@charter.net at Feb 12, 2006 23:28

I installed this plugin but it didn't work for me although I did all the steps as required, also make sure the dot is on the path, when I use flowchart macro it do not display the picture.any idea what's wrong? is ther eany log that I can see ?

Posted by meiriv at Aug 22, 2006 02:07

Please open a support request at http://support.atlassian.com, and attach the log files from your confluence logs directory.

Posted by tom@atlassian.com at Aug 23, 2006 21:58

anyone with a valid version of binaries of graphviz for solaris 9?  I'm dieing on how to compile the source as it goes bezerk with the cpp forking 400+ cpp processes on the ./configure....

Posted by cp226 at Sep 26, 2006 14:06

I installed this plugin on confluence 2.0. I don't see any error message, but the flow charts does not generate. I see a missing image instead.
I checked the generated HTML code, and i can see the url /confluence/download/temp/graphviz2144.png?contentType=image/png&delete=true
This url does not lead to anything...

What should i do to see my flowchart?

Posted by blaiseac at Oct 19, 2006 03:57

By the way, I was getting an error that the macros could not find the dot executable. What I did to fix this, on Fedora Core 4, was:

1. In the config file /opt/confluence/plugins/graphviz/src/etc/graphviz.properties, specify the path to dot, which in my case was /usr/bin/dot

2. Recompile the plugin using Ant, from the plugins directory

3. Restart confluence and test

Works just fine.

FYI,
Rick Cogley
Tokyo Japan

Posted by rick.cogley@esolia.co.jp at Dec 19, 2006 22:59

Is there any way to prevent Confluence from messing up graphviz markup when it is doing automatic page updates for space renames? For instance:

edge [style=bold] 

gets converted to

edge [NEW-SPACE-KEY:style=bold]
Posted by bob.swift@lakeviewtech.com at Jan 10, 2007 09:10

Hi Bob,

I don't think there is. Hopefully we will be able to fit this into a fix for CONF-3623.

Posted by don.willis@atlassian.com at Jan 11, 2007 19:13
Document generated by Confluence on Mar 22, 2007 20:54