[PlantUML] IntelliJ plugin 실행 오류 | Graphviz Window10

서론

인터넷에 검색해보면 Mac OS 환경에서 명령어 하나로 쉽게 Graphviz를 설치하는 것을 보고 미래에 나와 같은 오류를 맞닥뜨릴 어떤 사람을 위해 글을 작성한다.

 

본론

intelliJ에서 PlantUML integration 플러그인을 설치하고나면 시퀀스 다이어그램은 잘 나오기 때문에 아무 이상없이 잘 동작하는 것 처럼 보인다. 하지만, 시쿼스 다이어 그램이라든지 다른 다이어그램을 작성하려고만 하면 아래와 같은 에러메시지가 출력된다.

Error message #1

Cannot find Graphviz, You should try

@startuml
testdot
@emduml

or

java -jar plantuml.jar -testdot

이 경우에는 Graphviz를 설치하면 된다.

Graphviz 설치

Download

위의 사이트에서 Stable Windows install packages/10/cmake/Relase/x64 경로로 들어가서 exe파일을 다운받으면 된다.

 

환경변수

설치하고 나면, 환경변수를 설정해주어야 하는데, 위의 exe 파일로 설치했다면, 기본 경로로 잘 설치가 되어있을 것이다.

User variable - `C:\Program Files\Graphviz 2.44.1\bin`
System variable - `C:\Program Files\Graphviz 2.44.1\bin\dot.exe`

사용자 변수, 시스템 변수 Path에 각각의 내용을 추가해준다.

그리고 cmd를 열어서 "set"을 입력해주면 설정해둔 환경변수들이 컴퓨터 다시시작 없이도 적용된다고 한다.

cmd에 set 명령어 입력

Path 맨 뒤에 추가된 모습

 

Error message #2

이렇게 모두 끝났나 싶어서 다시 intellij로 돌아와 PlantUML을 실행해보면 아래와 같은 에러 메시지를 만나게 된다.

...
Error: dot generates empty file. Check you dot installation.

진짜 모든 방법을 동원해서 다 해봤는데도 안돼서 plantUML에 메일을 보냈다.
그런데, 메일을 보내자마자 혹시나 하고 그냥 해봤던 방법이 성공해서 이 글을 작성한다 ^^.. 또 다른 삽질하는 사람들이 없길

그 방법은 "dot -c"를 입력하는 것이다.
관리자권한으로 cmd를 실행시켜서 "dot -c"를 하니 몇 초 뒤에 바로 PlantUML이 잘 동작했다.

dot -c

 

 

답변

이렇게 해결하고나서 답변도 굉장히 빠르게 왔다.(하루는 걸릴 줄 알았는데 신속해서 놀랐다😱)

그렇지만, 답장온대로 해당위치에서 "dot -c"를 입력하더라도

아래와 같은 에러 메시지를 뱉으며 종료되고, 반드시 관리자 권한으로 cmd를 실행하면 어느 위치에서든 "dot -c"명령어가 잘 작동하니 관리자 권한으로 cmd실행하는 것을 잊지 않았으면 한다.

분명히 구글링하면서 관리자 권한이 아닌 cmd로 파일위치까지 가서 "dot -c"를 했었는데 안돼서 낙담했었는데 정답은 관리자 권한으로 실행하는 거였다니 허탈하기 짝이 없다^^.

 

정리

• PlantUML을 쓰기 위해서는 Graphviz를 설치해야한다.
• Graphviz 환경변수 등록이 잘 되어있는지 확인해야 한다.
• Window에서는 "dot -c"명령어를 실행해야한다. (아마 리눅스도)
• cmd에서 "dot -c"명령어를 실행할 때는 관리자 권한으로 cmd를 실행시켜야 한다.

위의 4가지를 모두 했다면 당신은 성공적으로 PlantUML을 쓸 수 있을 것이다!! ✨👏💯

답변 메일에 같이 온 링크를 첨부하며 마치도록 하겠습니다.

Test your GraphViz installation