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"

(Install the Eclipse Installer)
(Updated Java version prereq)
 
(20 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 Linux. 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 22: Line 28:
 
# Decompress the downloaded archive to a folder such as &quot;'''~/Apps/EclipseInstaller/'''&quot; ''(folder name and location will vary depending on operating system)''
 
# Decompress the downloaded archive to a folder such as &quot;'''~/Apps/EclipseInstaller/'''&quot; ''(folder name and location will vary depending on operating system)''
  
<div class="figure">[[Image:PapyrusRT-O-EclipseInstaller.png]]
+
<div class="figure">[[Image:PapyrusRT-O-EclipseInstaller.png]]
 
</div>
 
</div>
  
== Download the Papyrus-RT configuration file ==
+
= Install Papyrus for Real Time =
  
# Download the [https://wiki.eclipse.org/images/9/9c/Papyrus-RT.setup.zip Papyrus-RT-specific configuration file] for the Eclipse Installer. You can use the folder from the previous step.
+
Now that the installer is available, you can install the software.
  
<div  class="figure">[[Image:PapyrusRT-O-configFile.png]]
 
</div>
 
  
== Install Papyrus for Real Time ==
+
== Start the Eclipse Installer ==
  
Now that the installer is available and you have the Papyrus-RT installation configuration file, you can install the software.
+
# Open the '''eclipse-installer''' folder and double-click on the '''eclipse-inst''' application.
  
 +
<div class="figure">[[Image:PapyrusRT-O-StartSclipseInstaller.png]]
 +
</div>
  
=== Start the Eclipse Installer ===
+
== Skip ahead if Papyrus-RT setup is already available ==
  
# Open the '''eclipse-installer''' folder and double-click on the '''eclipse-inst''' application.
+
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]]'''
  
<div class="figure">[[Image:PapyrusRT-O-StartSclipseInstaller.png]]
+
<div class="figure">[[Image:PapyrusRT-O-SetupAvail.png]]
 
</div>
 
</div>
=== The Eclipse Installer Projects ===
+
 
 +
= Add Papyrus-RT to the list of projects =
  
 
You have now started the Eclipse Installer.
 
You have now started the Eclipse Installer.
Line 54: Line 61:
 
This has for effect to restart the Eclipse Installer in the &quot;Advanced Mode&quot;, which will allow you to specify an external setup file.
 
This has for effect to restart the Eclipse Installer in the &quot;Advanced Mode&quot;, which will allow you to specify an external setup file.
  
<div class="figure">[[Image:PapyrusRT-O-EclipseInstallerProjects.png]]
+
<div class="figure">[[Image:PapyrusRT-O-EclipseInstallerProjects.png]]
 
</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. 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.
# Select the from the 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, click on '''[Browse File System...]'''.
+
# 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>
# Navigate to the folder where you saved the &quot;'''Papyrus-rt.setup'''&quot; file.
+
 
# Click '''[OK]'''.
 
# Click '''[OK]'''.
# The Papyrus-RT.setup file is shown in the dialog.
 
# Click '''[OK]''' to complete the selelection.
 
  
<div class="figure">[[Image:PapyrusRT-O-SetUpConfig.png]]
+
<div class="figure">[[Image:PapyrusRT-O-SetUpConfig.png]]
 
</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.
 
  
 
# Click on the &quot;'''Switch to simple mode'''&quot; button to get back to the simpler interface.
 
# Click on the &quot;'''Switch to simple mode'''&quot; button to get back to the simpler interface.
Line 83: 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
  
 
# Click on '''[Papyrus-RT]'''
 
# Click on '''[Papyrus-RT]'''
 +
# Select the desired version of Papyrus-RT to install (latest version is shown by default)
 
# Validate the Java VM
 
# Validate the Java VM
 
# Pick the location for the installation
 
# Pick the location for the installation
 
# Click on '''[Install]'''
 
# Click on '''[Install]'''
  
<div class="figure">[[Image:PapyrusRT-O-Install.png]]
+
<div class="figure">[[Image:PapyrusRT-O-Install.png]]
 
</div>
 
</div>
  
=== Accept the licenses ===
+
= Launch! =
 
+
You will have to accept the licences to continue the installation.
+
 
+
# Review and '''[Accept]''' the licenses
+
 
+
<div  class="figure">[[Image:PapyrusRT-O-AcceptLicenses.png]]
+
</div>
+
 
+
=== Accept unsigned content ===
+
 
+
Some of the Papyrus-RT content is unsigned at the time these instructions were created.
+
 
+
# Click '''[Accept]'''.
+
 
+
<div  class="figure">[[Image:PapyrusRT-O-AcceptUnsignedContent.png]]
+
</div>
+
 
+
== Launch! ==
+
  
 
You can now click on '''[LAUNCH]''' to start creating models!
 
You can now click on '''[LAUNCH]''' to start creating models!
  
<div class="figure">[[Image:PapyrusRT-O-Launch.png]]
+
<div class="figure">[[Image:PapyrusRT-O-Launch.png]]
 
</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.