Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Papyrus-RT/User/User Guide/Eclipse Installer"

m (Set up the Papyrus-RT configuration)
(Updated Java version prereq)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<span style="font-size:36px; margin-bottom: 25px; font-weight: 300; color: #2C2255; line-height: 1.1; margin: 0.67em 0px;
+
[[File:PapyrusForRealTime-Logo-Icon.png|left|bottom-align|]]<br/><span style="font-family: Helvetica,Arial,sans-serif; font-size: 48px;"><b>Installing Papyrus for Real Time using the Eclipse Installer</b></span><br/><br/><br/>
">Installing Papyrus for Real Time using the Eclipse Installer</span>
+
  
 
__TOC__
 
__TOC__
  
== Introduction ==
+
= Introduction =
  
 
This tutorial will show you how to install Papyrus for Real Time using the Oomph-based Eclipse Installer.
 
This tutorial will show you how to install Papyrus for Real Time using the Oomph-based Eclipse Installer.
  
'''Note''': You will need Java 1.7 installed.
 
  
'''Note''': The instructions in this tutorial are illustrated using screen captures from multiple operating systems. Steps and images may differ slightly if the installation is done on a different operating system (both Windows and Mac OS are supported for developing models). Some of these differences have been indicated when known, but some may also be missing.
+
{{ note | Prerequisites | You need to install Java 8 (64 bits). You can obtain it [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html here].
  
== Install the Eclipse Installer ==
+
Note that Papyrus-RT '''will not''' work with Java 9 or with a 32-bit version of Java 8, or Java 7 and below.
 +
}}
 +
 
 +
 
 +
{{Note | Operating System | The instructions in this tutorial are illustrated using screen captures from multiple operating systems. Steps and images may differ slightly if the installation is done on a different operating system (both Windows and Mac OS are supported for developing models). Some of these differences have been indicated when known, but some may also be missing.}}
 +
 
 +
{{Note | Windows | We have had reports that the next step (''Install the Eclipse Installer'') fails on some Windows installations and we are investigating. If that is the case for you, using Java 8 has proven a solution for some. If it still does not work, please follow the instructions on the manual installation tutorial (https://wiki.eclipse.org/Papyrus-RT/User_Guide/Installation>.}}
 +
 
 +
= Install the Eclipse Installer =
  
 
First, you will need to download and install the Eclipse Installer.
 
First, you will need to download and install the Eclipse Installer.
Line 25: Line 31:
 
</div>
 
</div>
  
== Install Papyrus for Real Time ==
+
= Install Papyrus for Real Time =
  
Now that the installer is available and you have the Papyrus-RT installation configuration file, you can install the software.
+
Now that the installer is available, you can install the software.
  
  
=== Start the Eclipse Installer ===
+
== Start the Eclipse Installer ==
  
 
# Open the '''eclipse-installer''' folder and double-click on the '''eclipse-inst''' application.
 
# Open the '''eclipse-installer''' folder and double-click on the '''eclipse-inst''' application.
Line 37: Line 43:
 
</div>
 
</div>
  
=== Skip ahead if Papyrus-RT setup is already available ===
+
== Skip ahead if Papyrus-RT setup is already available ==
  
 
If you see Papyrus-RT in the list of products after opening the Eclipse Installer, go to '''[[Papyrus-RT/User Guide/Eclipse Installer#Install_Papyrus-RT|Install Papyrus-RT]]'''
 
If you see Papyrus-RT in the list of products after opening the Eclipse Installer, go to '''[[Papyrus-RT/User Guide/Eclipse Installer#Install_Papyrus-RT|Install Papyrus-RT]]'''
Line 44: Line 50:
 
</div>
 
</div>
  
== Add Papyrus-RT to the list of projects ==
+
= Add Papyrus-RT to the list of projects =
  
 
You have now started the Eclipse Installer.
 
You have now started the Eclipse Installer.
Line 58: Line 64:
 
</div>
 
</div>
  
=== Set up the Papyrus-RT configuration ===
+
== Set up the Papyrus-RT configuration ==
  
 
You can now set up the Papyrus-RT configuration that will define the how to install the product.
 
You can now set up the Papyrus-RT configuration that will define the how to install the product.
  
# Select the '''&lt;User Products&gt;''' from the list.
+
# Select the '''&lt;User Products&gt;''' from the list. If you don't see this item, click the folder icon on the top-right of the dialog. A drop-down list should appear and show '''&lt;User Products&gt;'''. Select it. No it should appear in the main list.
 
# Click on the '''[+]''' to the right of the filter box to add a user product.
 
# Click on the '''[+]''' to the right of the filter box to add a user product.
# In the resulting dialog, enter the following URL in the "'''Resource URIs:'''" box: ''(you may want to cut and paste from this page)'' <br/><nowiki>http://git.eclipse.org/c/papyrus-rt/org.eclipse.papyrus-rt.git/plain/releng/org.eclipse.papyrus-rt.oomph/setups/Papyrus-RT.setup</nowiki>
+
# In the resulting dialog, enter the following URL in the "'''Resource URIs:'''" box: ''(you may want to cut and paste from this page)'' <br style="height: 22em;" /><span style="color: black; background-color: yellow; border-color: red; padding-left: 1em; padding-right: 1em; padding-top: 2px; padding-bottom: 2px; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;"><nowiki>https://www.eclipse.org/papyrus-rt/content/setup/papyrus-rt.setup</nowiki></span>
 
# Click '''[OK]'''.
 
# Click '''[OK]'''.
  
Line 70: Line 76:
 
</div>
 
</div>
  
=== Go back to simple mode ===
+
== Go back to simple mode ==
  
 
The Papyrus-RT product is now available in the list of products.
 
The Papyrus-RT product is now available in the list of products.
Line 79: Line 85:
 
</div>
 
</div>
  
== Install Papyrus-RT ==
+
= Install Papyrus-RT =
  
 
You can now install the Papyrus-RT product
 
You can now install the Papyrus-RT product
Line 92: Line 98:
 
</div>
 
</div>
  
== Launch! ==
+
= Launch! =
  
 
You can now click on '''[LAUNCH]''' to start creating models!
 
You can now click on '''[LAUNCH]''' to start creating models!
Line 99: Line 105:
 
</div>
 
</div>
  
== [Optional and <span style="color: green">Recommended</span>] Install Eclipse CDT ==
+
= Done! =
 
+
If you plan on doing more than just modeling using UML-RT, such as generating, building, and running C++ code, you will also need to install the Eclipse CDT.
+
 
+
== Done! ==
+
  
 
<div class="figure">[[Image:PapyrusRT-O-Done.png]]
 
<div class="figure">[[Image:PapyrusRT-O-Done.png]]
 
</div>
 
</div>

Latest revision as of 15:26, 29 September 2017

PapyrusForRealTime-Logo-Icon.png

Installing Papyrus for Real Time using the Eclipse Installer


Introduction

This tutorial will show you how to install Papyrus for Real Time using the Oomph-based Eclipse Installer.


Note.png
Prerequisites
You need to install Java 8 (64 bits). You can obtain it here. Note that Papyrus-RT will not work with Java 9 or with a 32-bit version of Java 8, or Java 7 and below.


Note.png
Operating System
The instructions in this tutorial are illustrated using screen captures from multiple operating systems. Steps and images may differ slightly if the installation is done on a different operating system (both Windows and Mac OS are supported for developing models). Some of these differences have been indicated when known, but some may also be missing.


Note.png
Windows
We have had reports that the next step (Install the Eclipse Installer) fails on some Windows installations and we are investigating. If that is the case for you, using Java 8 has proven a solution for some. If it still does not work, please follow the instructions on the manual installation tutorial (https://wiki.eclipse.org/Papyrus-RT/User_Guide/Installation>.


Install the Eclipse Installer

First, you will need to download and install the Eclipse Installer.

Note: If you are installing into an existing Eclipse workbench, you can follow the instructions on the "[Papyrus-RT/User Guide/Installation | Installing Papyrus for Real Time - Manual Installation]" tutorial.

  1. Go to http://wiki.eclipse.org/Eclipse_Installer
  2. Download the "Eclipse Installer" package for your operating system
  3. Decompress the downloaded archive to a folder such as "~/Apps/EclipseInstaller/" (folder name and location will vary depending on operating system)
PapyrusRT-O-EclipseInstaller.png

Install Papyrus for Real Time

Now that the installer is available, you can install the software.


Start the Eclipse Installer

  1. Open the eclipse-installer folder and double-click on the eclipse-inst application.
PapyrusRT-O-StartSclipseInstaller.png

Skip ahead if Papyrus-RT setup is already available

If you see Papyrus-RT in the list of products after opening the Eclipse Installer, go to Install Papyrus-RT

PapyrusRT-O-SetupAvail.png

Add Papyrus-RT to the list of projects

You have now started the Eclipse Installer.

However, the Papyrus-RT product is not available in the list of projects presented to you. You will have to manually add it to the list.

  1. Click on the icon at the top right.
  2. Select "Advanced Mode..."

This has for effect to restart the Eclipse Installer in the "Advanced Mode", which will allow you to specify an external setup file.

PapyrusRT-O-EclipseInstallerProjects.png

Set up the Papyrus-RT configuration

You can now set up the Papyrus-RT configuration that will define the how to install the product.

  1. Select the <User Products> from the list. If you don't see this item, click the folder icon on the top-right of the dialog. A drop-down list should appear and show <User Products>. Select it. No it should appear in the main list.
  2. Click on the [+] to the right of the filter box to add a user product.
  3. In the resulting dialog, enter the following URL in the "Resource URIs:" box: (you may want to cut and paste from this page)
    https://www.eclipse.org/papyrus-rt/content/setup/papyrus-rt.setup
  4. Click [OK].
PapyrusRT-O-SetUpConfig.png

Go back to simple mode

The Papyrus-RT product is now available in the list of products.

  1. Click on the "Switch to simple mode" button to get back to the simpler interface.
PapyrusRT-O-Back2SimpleMode.png

Install Papyrus-RT

You can now install the Papyrus-RT product

  1. Click on [Papyrus-RT]
  2. Select the desired version of Papyrus-RT to install (latest version is shown by default)
  3. Validate the Java VM
  4. Pick the location for the installation
  5. Click on [Install]
PapyrusRT-O-Install.png

Launch!

You can now click on [LAUNCH] to start creating models!

PapyrusRT-O-Launch.png

Done!

PapyrusRT-O-Done.png

Copyright © Eclipse Foundation, Inc. All Rights Reserved.