Installation
The Open Source UML tool Papyrus is a plug-in for the Open Source integrated development environment (IDE) Eclipse. GenDoc is the associated tool that allows you to output a model in Papyrus into a word document. The artifacts in the output (diagrams, classes, datatypes, etc.) can be copy/pasted directly into a model project's wiki page.
Applied tool versions:
- Eclipse: version 4.7.2 "Oxygen"
- Papyrus: version 3.3.0
- GenDoc: version 0.6.0
Installing Eclipse
- Eclipse “Oxygen” Modeling Tools package version 4.7.2 can be downloaded from here:
https://www.eclipse.org/downloads/packages/eclipse-modeling-tools/oxygen2 - Select the download link that is appropriate for the machine on which you will be making the install, i.e. "Windows 64-bit"
- This results in the download of a zip file.
- Note that Eclipse Oxygen requires a 1.8 compatible JVM
- Extract the contents of the zip file to wherever you would like to install Eclipse. On a PC, "Program Files" is always a good option.
- The content of the extracted files should look something like this:
- To launch eclipse, double-click on the "eclipse.exe" file
- When Eclipse starts coming up, it will prompt you for a "Workspace", providing a default that you can override.
- This is where the Eclipse projects, with associated models, will be stored.
- When Eclipse fully comes up, you can close the Welcome tab
- To verify you have the correct installation of the product, go to "Help" → "About Eclipse"
- You should see something that looks like this:
- You have now successfully installed Eclipse
Installing Papyrus
- Papyrus version 3.3.0 can be downloaded from here:
https://www.eclipse.org/papyrus/ - Scroll down on the right side of the page and select: "Papyrus 3.3.0 Oxygen" Posted March 20th, 2018 and select "Download Page"
- This takes you to "Papyrus Update Sites". Scroll down and select the "Papyrus Oxygen (3.X.0) Release Update Site
- Copy the URL of the update site to which it takes you. Should be something like: http://download.eclipse.org/modeling/mdt/papyrus/updates/releases/oxygen/
- Now you go back into Eclipse and select "Help"→ "Install new software"
- An "Available Software" screen comes up. Paste your URL into the "Work with:" box and hit enter
- There should be multiple "Papyrus" related packages available to install. Select only the box: "Papyrus" and make sure the others are not selected.
- Then click on "Next" to install the product. The installation will check for dependencies and requirement, and next prompt you to "Accept" the license agreement
- Once accepted, you can select "Finish" and the installation process continues.
- When the installation is finished, restart Eclipse to begin to use Papyrus.
- Go to "Window"→ "Perspective"→"Open Perspective"→ "Other" and select Papyrus.
- You will now be in the Papyrus Perspective where you can begin to use Papyrus.