Skip to content

WINDUP-2245: Included instructions for installing JBoss Tools. #238

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
huffmanca merged 1 commit into from
Oct 25, 2018
Merged

WINDUP-2245: Included instructions for installing JBoss Tools. #238

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/plugin-guide/master.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,8 @@ include::topics/eclipse-submit-ruleset.adoc[leveloffset=+2]

include::topics/plugin-icon-legend.adoc[leveloffset=+2]

include::topics/install-jboss-tools.adoc[leveloffset=+2]

// **********************************
// * Appendix: Revision Information *
// **********************************
Expand Down
17 changes: 17 additions & 0 deletions docs/topics/install-jboss-tools.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
[[install_jboss_tools]]
= Install JBoss Tools into Eclipse
Copy link
Copy Markdown

@johnsteele johnsteele Oct 24, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is not a requirement to install JBoss Tools, only that Eclipse knows where to find those JBoss Tools dependencies when it's installing our plugin.

So there are three choices

  1. install using DevStudio, which already has JBoss Tools installed by default, thus Eclipse knows where to find the deps or
  2. install using a vanilla distro of Eclipse and our composite update site (http://download.jboss.org/jbosstools/photon/stable/updates/rhamt/), which will automatically detect and pickup JBoss Tools or
  3. install using a vanilla distro of Eclipse and our direct update site (http://download.jboss.org/jbosstools/photon/stable/updates/rhamt/4.2.0.Final/) and then manually add the JBoss Tools update site location (eg https://devstudio.redhat.com/10.0/stable/updates/)

Copy link
Copy Markdown

@johnsteele johnsteele Oct 24, 2018 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@huffmanca I like to encourage people to use our composite update site (http://download.jboss.org/jbosstools/photon/stable/updates/rhamt/) because in addition to automatically picking up JBoss Tools, it will pick up our latest release, which is ideal for bug fixes, patches, etc

Copy link
Copy Markdown
Contributor Author

@huffmanca huffmanca Oct 24, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm attempting #2 above, using the following steps:

  1. Install a fresh copy of Eclipse Photon.
  2. Go to Help -> Install New Software
  3. Click Add
  4. In Name, define RHAMT.
  5. In Location, define http://download.jboss.org/jbosstools/photon/stable/updates/rhamt/.
  6. Click Add
  7. Check JBoss Tools - RHAMT
  8. Click Next

At this point I get the same error reported in WINDUP-2245 regarding missing dependencies. Installing JBoss Tools manually, or using JBDS, resolves this issue.

Is there a step I'm missing?


The {PluginNameTitle} depends on JBoss Tools, and therefore these dependencies must be installed for {ProductShortName} to function successfully. The following instructions detail installing JBoss Tools on an Eclipse installation.

.Install JBoss Tools

. From the menu bar, select *Help* -> *Eclipse Marketplace*.
. In the *Find* field, enter `JBoss Tools` and press *Enter* to search for the project.
. Scroll down until you see *JBoss Tools* in the list and press *Install* next to this project.
. Review the selected features and press *Confirm*. It is recommended to accept the defaults to install the required dependencies for {ProductShortName}.
. Ensure that the first radio button, `Keep my installation the same and modify the items being installed to be compatible`, is selected.
. Review the selected packages and click *Confirm*.
. Accept the terms of the license agreement and click *Finish*.
. Click *Install anyway* to accept the certificates.
. Click *Select all* to trust all of the specified certificates, and then click *Accept selected*.
. Restart Eclipse for the changes to take effect.
4 changes: 4 additions & 0 deletions docs/topics/plugin-install.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@ If you do not already have an existing installation, download link:http://www.ec

NOTE: This guide uses _Eclipse_ to refer to an installation of Eclipse or JBoss Developer Studio.

.Prerequisites

* If you are using Eclipse, and not JBoss Developer Studio, then you must xref:install_jboss_tools[install JBoss Tools] before installing the {PluginNameTitle}.

.Install the Plugin

. Launch Eclipse.
Expand Down