diff options
Diffstat (limited to 'org.eclipse.mylyn.help.ui/Mylyn/FAQ/Installation.html')
| -rw-r--r-- | org.eclipse.mylyn.help.ui/Mylyn/FAQ/Installation.html | 122 |
1 files changed, 74 insertions, 48 deletions
diff --git a/org.eclipse.mylyn.help.ui/Mylyn/FAQ/Installation.html b/org.eclipse.mylyn.help.ui/Mylyn/FAQ/Installation.html index c7053e085..23393c746 100644 --- a/org.eclipse.mylyn.help.ui/Mylyn/FAQ/Installation.html +++ b/org.eclipse.mylyn.help.ui/Mylyn/FAQ/Installation.html @@ -36,7 +36,7 @@ </li> </ul> <p>As of writing, Mylyn comes bundled with the main EPP distributions ( - <a href="http://www.eclipse.org/downloads/" target="mylyn_external">jee, java, cpp</a>). If you wish to manually install Mylyn there are to methods depending on the version of Eclipse. Method 1 outlines how to install using the Eclipse 3.4 update manager. Method 2 below describes how to install Mylyn into Eclipse 3.3 and below using the Update Manager. + <a href="http://www.eclipse.org/downloads/" target="mylyn_external">jee, java, cpp</a>). If you wish to manually install Mylyn there are two methods depending on the version of Eclipse. Method 1 outlines how to install using the Eclipse 3.4 update manager. Method 2 below describes how to install Mylyn into Eclipse 3.3 and below using the Update Manager. </p> <h3 id="Install_-_Eclipse_3.4_and_later">Install - Eclipse 3.4 and later</h3> <ol> @@ -78,20 +78,22 @@ <p>See the <a href="http://eclipse.org/mylyn/new/" target="mylyn_external">New &amp; Noteworthy</a>. </p> - <p><table> -<th> Mylyn Version</th><th colspan="7">Sub-projects</th> -<tr><td></td><td> Mylyn Builds</td><td>Mylyn Commons</td><td>Mylyn Context</td><td>Mylyn Docs</td><td>Mylyn Reviews</td><td>Mylyn Tasks</td><td>Mylyn Versions</td></tr> -<tr><td> 3.8 (tentative, Juno)</td><td>1.0</td><td>3.8</td><td>3.8</td><td>1.7</td><td>1.0</td><td>3.8</td><td>1.0</td></tr> + <p>List of major and release train versions:</p> + <p><table cellpadding="10"> +<th>Mylyn Version</th><th colspan="7">Sub-projects</th> +<tr><td></td><td>Mylyn Builds</td><td>Mylyn Commons</td><td>Mylyn Context</td><td>Mylyn Docs</td><td>Mylyn Reviews</td><td>Mylyn Tasks</td><td>Mylyn Versions</td></tr> +<tr><td> + <a href="http://www.eclipse.org/projects/project-plan.php?projectid=mylyn" target="mylyn_external">3.8</a> (Juno)</td><td>1.0</td><td>3.8</td><td>3.8</td><td>1.7</td><td>1.0</td><td>3.8</td><td>1.0</td></tr> <tr><td> - <a href="http://www.eclipse.org/projects/project-plan.php?projectid=mylyn" target="mylyn_external">3.7</a> (planned)</td><td>0.9</td><td>3.7</td><td>3.7</td><td>1.6</td><td>0.9</td><td>3.7</td><td>0.9</td></tr> + <a href="http://eclipse.org/mylyn/doc/plan-3.6.html" target="mylyn_external">3.7</a></td><td>0.9</td><td>3.7</td><td>3.7</td><td>1.6</td><td>0.9</td><td>3.7</td><td>0.9</td></tr> +<tr><td>3.6.5 (Indigo SR2)</td><td>0.8.5</td><td>3.6.5</td><td>3.6.5</td><td>1.5.5</td><td></td><td>3.6.5</td><td></td></tr> +<tr><td>3.6.2 (Indigo SR1)</td><td>0.8.2</td><td>3.6.2</td><td>3.6.2</td><td>1.5.2</td><td></td><td>3.6.2</td><td></td></tr> <tr><td> - <a href="http://eclipse.org/mylyn/doc/plan-3.6.html" target="mylyn_external">3.6</a> (Indigo)</td><td>0.8</td><td>3.6</td><td>3.6</td><td>1.5</td><td>0.8</td><td>3.6</td><td>0.8</td></tr> -<tr><td> 3.5.1</td><td>0.7.1</td><td>3.5.1</td><td>3.5.1</td><td>1.4.1</td><td>0.7.1</td><td>3.5.1</td><td>0.7.1</td></tr> + <a href="http://eclipse.org/mylyn/doc/plan-3.6.html" target="mylyn_external">3.6</a> (Indigo)</td><td>0.8</td><td>3.6</td><td>3.6</td><td>1.5</td><td></td><td>3.6</td><td>0.8</td></tr> <tr><td> - <a href="http://eclipse.org/mylyn/doc/plan-3.5.html" target="mylyn_external">3.5</a></td><td>0.7</td><td>3.5</td><td>3.5</td><td>1.4</td><td>0.7</td><td>3.5</td><td>0.7</td></tr> -<tr><td> 3.4.3 (Helios SR2)</td><td></td><td>3.4.3</td><td>3.4.3</td><td>1.3.2</td><td></td><td>3.4.3</td><td></td></tr> -<tr><td> 3.4.2 (Helios SR1)</td><td></td><td>3.4.2</td><td>3.4.2</td><td>1.3.2</td><td></td><td>3.4.2</td><td></td></tr> -<tr><td> 3.4.1</td><td></td><td>3.4.1</td><td>3.4.1</td><td>1.3.1</td><td></td><td>3.4.1</td><td></td></tr> + <a href="http://eclipse.org/mylyn/doc/plan-3.5.html" target="mylyn_external">3.5</a></td><td>0.7</td><td>3.5</td><td>3.5</td><td>1.4</td><td></td><td>3.5</td><td>0.7</td></tr> +<tr><td>3.4.3 (Helios SR2)</td><td></td><td>3.4.3</td><td>3.4.3</td><td>1.3.2</td><td></td><td>3.4.3</td><td></td></tr> +<tr><td>3.4.2 (Helios SR1)</td><td></td><td>3.4.2</td><td>3.4.2</td><td>1.3.2</td><td></td><td>3.4.2</td><td></td></tr> <tr><td> <a href="http://eclipse.org/mylyn/doc/plan-3.4.html" target="mylyn_external">3.4</a> (Helios)</td><td></td><td>3.4</td><td>3.4</td><td>1.3</td><td></td><td>3.4</td><td></td></tr> </table> @@ -101,17 +103,18 @@ <a href="http://eclipse.org/mylyn/downloads/" target="mylyn_external">download page</a>. </p> <p><table> -<th> Eclipse Version</th><th>Mylyn Version</th> -<tr><td> 4.2</td><td>3.7 and later</td></tr> -<tr><td> 4.1</td><td>3.5 and later</td></tr> -<tr><td> 3.8 (Juno)</td><td>3.7 and later</td></tr> -<tr><td> 3.7 (Indigo)</td><td>3.5 and later</td></tr> -<tr><td> 3.6 (Helios)</td><td>3.3 and later</td></tr> -<tr><td> 3.5 (Galileo)</td><td>3.2 - 3.6</td></tr> -<tr><td> 3.4 (Ganymede)</td><td>2.1 - 3.4</td></tr> -<tr><td> 3.3</td><td>2.0 - 3.2</td></tr> -<tr><td> 3.2</td><td>1.0 - 2.0</td></tr> -<tr><td> 3.1</td><td>0.6.0</td></tr> +<th>Eclipse Version</th><th>Mylyn Version</th> +<tr><td>4.2 (Juno)</td><td>3.7 and later</td></tr> +<tr><td>4.1</td><td>Not Supported</td></tr> +<tr><td>4.0</td><td>Not Supported</td></tr> +<tr><td>3.8</td><td>3.7 and later</td></tr> +<tr><td>3.7 (Indigo)</td><td>3.5 and later</td></tr> +<tr><td>3.6 (Helios)</td><td>3.3 - 3.8</td></tr> +<tr><td>3.5 (Galileo)</td><td>3.2 - 3.6</td></tr> +<tr><td>3.4 (Ganymede)</td><td>2.1 - 3.4</td></tr> +<tr><td>3.3</td><td>2.0 - 3.2</td></tr> +<tr><td>3.2</td><td>1.0 - 2.0</td></tr> +<tr><td>3.1</td><td>0.6.0</td></tr> </table></p> <p>Mylyn also relies on a web browser that works with the Standard Widget Toolkit; Windows and MacOS users are fine, but Linux users might have to download another browser. See <a href="http://www.eclipse.org/swt/faq.php#browserlinux" target="mylyn_external">the SWT Browser guide</a> for which browsers will work. See @@ -121,16 +124,27 @@ <p>See <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=288567" target="mylyn_external">bug 288567</a> for announcement regarding supported repository versions. </p> + <h4 id="Mylyn_3.8">Mylyn 3.8</h4> + <ul> + <li>Eclipse 3.6, 3.7, 3.8, 4.2</li> + </ul> + <ul> + <li>Bugzilla 3.6, 4.0, 4.2</li> + <li>Trac 0.11, 0.12</li> + <li>Hudson 2.1.2, 2.2.0</li> + <li>Jenkins 1.424.6</li> + <li>Gerrit 2.2.2, 2.3</li> + </ul> <h4 id="Mylyn_3.7">Mylyn 3.7</h4> <ul> <li>Eclipse 3.6, 3.7</li> </ul> <ul> - <li>Bugzilla 3.4, 3.6, 4.0</li> + <li>Bugzilla 3.6, 4.0, 4.2</li> <li>Trac 0.11, 0.12</li> - <li>Hudson 2.1.2</li> - <li>Jenkins 1.427</li> - <li>Gerrit 2.2</li> + <li>Hudson 2.1.2, 2.2.0</li> + <li>Jenkins 1.424.6</li> + <li>Gerrit 2.2.1, 2.2.2</li> </ul> <h4 id="Mylyn_3.6">Mylyn 3.6</h4> <ul> @@ -179,7 +193,7 @@ <li>If you have more than one VM, you need to specify that Eclipse should use the JDK1.5 VM. </li> </ul> <p>In Unix, set the environment variable <code>JAVA_HOME</code> to the root of the JDK1.5 installation and/or set the <code>PATH</code> variable to put the JDK1.5 executable directory before any other VM executable directories. For example, under <code>bash</code> in Unix:</p> - <pre>export JAVA_HOME="''(location of JDK1.5 root)''" + <pre>export JAVA_HOME="<i>(location of JDK1.5 root)</i>" export PATH=$JAVA_HOME/bin:$PATH </pre> <p><b>We do @@ -266,12 +280,14 @@ J2SE-1.3,J2SE-1.4,J2SE-1.5,JavaSE-1.6 <p>To ensure that you are using the 1.5 VM refer to the last comment on <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=116347#c4" target="mylyn_external">bug 1163477</a> for instructions on how to change the 1.4 default. </p> - <p>''' Startup warnings'''</p> + <p> + <b> Startup warnings</b> + </p> <p>If you see startup errors or warnings such as <code>BundleException</code> or timeout messages restart Eclipse with the <code>-clean</code> flag either on the command line, in your shortcut link, or by temporarily it into the <code>eclipse/eclipse.ini</code> file. These warnings do not cause any bad behavior, but this bug has been fixed in all Mylyn builds after 2.1. The warnings have this form:</p> <pre> !MESSAGE While loading class "org.eclipse.mylar.tasks.ui.TasksUiPlugin", thread "Thread - [main,6,main]" timed out waiting (5000ms) for thread "Thread[Worker-3,5,main]" to finish - starting bundle "update@plugins/org.eclipse.mylar.tasks.ui_2.0.0.v20070514-1800.jar [809]". - To avoid deadlock, thread "Thread[main,6,main]" is proceeding but + <a href="main,6,main">main,6,main</a>" timed out waiting (5000ms) for thread "Thread<a href="Worker-3,5,main">Worker-3,5,main</a>" to finish + starting bundle "update@plugins/org.eclipse.mylar.tasks.ui_2.0.0.v20070514-1800.jar <a href="809">809</a>". + To avoid deadlock, thread "Thread<a href="main,6,main">main,6,main</a>" is proceeding but "org.eclipse.mylar.tasks.ui.TasksUiPlugin" may not be fully initialized. </pre> <h2 id="Installation_Troubleshooting_on_Eclipse_3.4_and_later">Installation Troubleshooting on Eclipse 3.4 and later</h2> @@ -303,7 +319,7 @@ J2SE-1.3,J2SE-1.4,J2SE-1.5,JavaSE-1.6 <i>Help → Software Updates… → Available Software → Manage Sites</i>. Then re-add the sites which will refresh the meta data and artifacts available on the update sites. </p> <p>Also see steps under - <a href="Installation.html#Installation_Troubleshooting_on_Eclipse_3.4_and_later">Installation Troubleshooting on Eclipse 3.4 and later</a>. + <a href="#Installation_Troubleshooting_on_Eclipse_3.4_and_later">Installation Troubleshooting on Eclipse 3.4 and later</a>. </p> <h3 id="Why_does_update_fail_with_.27.27Cannot_complete_the_request.27.27.3F">Why does update fail with <i>Cannot complete the request</i>? @@ -326,13 +342,15 @@ J2SE-1.3,J2SE-1.4,J2SE-1.5,JavaSE-1.6 Cannot find a solution where both Match[requiredCapability: org.eclipse.equinox.p2.iu/org.eclipse.mylyn.monitor.ui/[3.0.3.v20081015-1500 -e3x,3.0.3.v20081015-1500-e3x]] and Match[requiredCapability: org.eclipse.equinox.p2.iu/org.eclipse.mylyn.monitor.ui/[3.0.1.v20080721-2100-e3x,3.0.1.v20080721-2100-e3x]]can be satisfied. […] </pre> - <pre>Cannot find a solution satisfying the following requirements org.eclipse.ui [3.4.2.M20090204-0800]. + <pre>Cannot find a solution satisfying the following requirements org.eclipse.ui <a href="3.4.2.M20090204-0800">3.4.2.M20090204-0800</a>. </pre> <p>Also see steps under - <a href="Installation.html#Installation_Troubleshooting_on_Eclipse_3.4_and_later">Installation Troubleshooting on Eclipse 3.4 and later</a>. + <a href="#Installation_Troubleshooting_on_Eclipse_3.4_and_later">Installation Troubleshooting on Eclipse 3.4 and later</a>. </p> <h2 id="Installation_Troubleshooting_on_Eclipse_3.3_and_earlier">Installation Troubleshooting on Eclipse 3.3 and earlier</h2> - <p>''' Update failures '''</p> + <p> + <b> Update failures </b> + </p> <p>First, try running the update again via <i>Help → Software Updates → Search for new features…</i> and ensure that all of the Mylyn features have been updated. </p> @@ -345,7 +363,9 @@ J2SE-1.3,J2SE-1.4,J2SE-1.5,JavaSE-1.6 <b>updated your Eclipse 3.3 to an Eclipse 3.4 milestone</b>, you will not be able to update the 3.3 copy, because Mylyn has two separate downloads for Eclipse 3.3 and 3.4. Also, not all of the 3.3 version of Mylyn will work in Eclipse 3.4. Install the latest 3.4 version from: <a href="http://www.eclipse.org/mylyn/downloads/" target="mylyn_external">http://www.eclipse.org/mylyn/downloads/</a> </p> - <p>''' Java Persistence API Tools error when updating the JEE Eclipse Package '''</p> + <p> + <b> Java Persistence API Tools error when updating the JEE Eclipse Package </b> + </p> <p>If you are trying to install additional features and get this error you have hit <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=194959" target="mylyn_external">bug 194959</a> which should be resolved soon. The work-around is to check off the <i>Europa Discovery Site</i> and install the first two components of the @@ -364,22 +384,28 @@ J2SE-1.3,J2SE-1.4,J2SE-1.5,JavaSE-1.6 <li>Uninstall the Subclipse Mylar Integration (1.0.1)</li> <li>Uninstall the old version of Mylar</li> </ul> - <p>''' Incompatible VM (e.g. JDK 1.4) '''</p> + <p> + <b> Incompatible VM (e.g. JDK 1.4) </b> + </p> <p>If you are using the wrong VM, you’ll see errors like the following in your log file. </p> <pre>Root exception: java.lang.UnsupportedClassVersionError: org/eclipse/mylar/tasklist/MylarTasklistPlugin (Unsupported major.minor version 49.0) </pre> <p>See - <a href="Installation.html#What_version_of_Java_is_required.3F">Configure Java</a> to fix this problem. + <a href="#What_version_of_Java_is_required.3F">Configure Java</a> to fix this problem. + </p> + <p> + <b> Incompatible version of Eclipse </b> </p> - <p>''' Incompatible version of Eclipse '''</p> <p>Separate versions and update sites exist <a href="http://eclipse.org/mylyn/dl.php" target="mylyn_external">for Eclipse 3.1 and 3.2</a>), in which case you may see errors like the following in your <code><workspace>/.metadata/.log </code>file or in a Mylyn view: </p> <pre>java.lang.NoSuchMethodError: org.eclipse.ui.internal.dialogs.FilteredTree.getFilterControl() The activator org.eclipse.mylar.java.MylarJavaPlugin for bundle org.eclipse.mylar.java is invalid </pre> - <p>''' Mylyn feature configuration problem '''</p> + <p> + <b> Mylyn feature configuration problem </b> + </p> <p>If the above do not address the issue, the easiest thing to do is uninstall any old versions and update to the latest Mylyn. Your tasks won’t be lost, because by default they are stored in the <code><workspace>/.metadata/.mylyn</code> folder which will be read next time Mylyn starts correctly. </p> <ul> <li>First, uninstall the old version of Mylyn using @@ -406,8 +432,8 @@ The activator org.eclipse.mylar.java.MylarJavaPlugin for bundle org.eclipse.myla <b>What does the error “Network connection problems encountered during search” mean?</b> </p> <p>If you get that message while trying to download Mylyn, it means that Eclipse couldn’t find the location you entered. This might be because you copied something incorrectly (watch for extra characters -- even extra spaces can cause errors), or because the site went down. You may be able to see if the site is up or down by copying the URL into your Web browser.</p> - <p>' - <i>What does the “Update manager failure” message mean? '</i> + <p> + <b>What does the “Update manager failure” message mean? </b> </p> <p>It means that Eclipse could not access the update site, or that it got confused about the configuration state of your Eclipse. First try updating again to see if the update site is accessible. </p> <p>If you are trying to update the JIRA connector you can also try de-selecting that feature in case the <code>Tigris.org</code> update site is not accessible. Using @@ -527,13 +553,13 @@ The activator org.eclipse.mylar.java.MylarJavaPlugin for bundle org.eclipse.myla </ul> <h3 id="Solving_issues_with_KDE_environment_variable_settings">Solving issues with KDE environment variable settings</h3> <p>Most of the - <a href="Installation.html#Known_UI_issues_with_KDE">known UI issues below</a> are due to a broken environment variable setting. The environment variable <tt>GTK2_RC_FILES</tt> contains a search path to find the GTK configuration files to be used by the GTK application and can be checked with + <a href="#Known_UI_issues_with_KDE">known UI issues below</a> are due to a broken environment variable setting. The environment variable <tt>GTK2_RC_FILES</tt> contains a search path to find the GTK configuration files to be used by the GTK application and can be checked with </p> <pre> env | grep GTK2_RC_FILES </pre> <p>The correct setting is obtained by</p> - <pre> export GTK2_RC_FILES=$HOME/.gtkrc-2.0-kde:$HOME/.kde/share/config/gtkrc-2.0 ''# Bourne shell'' - setenv GTK2_RC_FILES $HOME/.gtkrc-2.0-kde:$HOME/.kde/share/config/gtkrc-2.0 ''# C shell'' + <pre> export GTK2_RC_FILES=$HOME/.gtkrc-2.0-kde:$HOME/.kde/share/config/gtkrc-2.0 <i># Bourne shell</i> + setenv GTK2_RC_FILES $HOME/.gtkrc-2.0-kde:$HOME/.kde/share/config/gtkrc-2.0 <i># C shell</i> </pre> <p> <b>Important note:</b> The used environment setting seems to differ depending on the way KDE starts @@ -646,7 +672,7 @@ The activator org.eclipse.mylar.java.MylarJavaPlugin for bundle org.eclipse.myla <p>It is likely that you need to configure these proxy server settings. Select <i>Window → Preferences → General → Network Connections</i>, and update the section in the “Proxy settings” section of the form. </p> - <h3 id="I_can.E2.80.99t_use_.3Ccode.3ECtrl.2BAlt.2BShift.2BArrow_Up.3C.2Fcode.3E_for.27.27_Mark_as_Landmark.27.27.__What_do_I_do.3F">I can’t use <code>Ctrl+Alt+Shift+Arrow Up</code> for'' Mark as Landmark''. What do I do?</h3> + <h3 id="I_can.E2.80.99t_use_Ctrl.2BAlt.2BShift.2BArrow_Up_for.27.27_Mark_as_Landmark.27.27.__What_do_I_do.3F">I can’t use <code>Ctrl+Alt+Shift+Arrow Up</code> for'' Mark as Landmark''. What do I do?</h3> <p>This is usually a Linux/GNOME problem, where the Gnome keyboard shortcuts are interfering with the Eclipse shortcuts. Go to the Keyboard shortcuts (which might be something like <i>Desktop → Control Center → Keyboard Shortcuts</i> or <i>System → Preferences → Keyboard Shortcuts</i>) and disable both of these shortcuts: @@ -691,7 +717,7 @@ The activator org.eclipse.mylar.java.MylarJavaPlugin for bundle org.eclipse.myla <b>Eclipse 3.1:</b> you may need to reset the Java editor to be default for <code>.java</code> again via: <i>Preferences → General → Editors → File Associations</i> </p> - <h2 id="Why_am_seeing_.3Ccode.3Ejava.lang.OutOfMemoryError:_PermGen_space.3C.2Fcode.3E_errors.3F">Why am seeing <code>java.lang.OutOfMemoryError: PermGen space</code> errors?</h2> + <h2 id="Why_am_seeing_java.lang.OutOfMemoryError:_PermGen_space_errors.3F">Why am seeing <code>java.lang.OutOfMemoryError: PermGen space</code> errors?</h2> <p>If your Eclipse crashes, or you see the above error after installing Mylyn or other plug-ins, you have most likely hit the infamous MaxPermSize bug. This is not a Mylyn specific problem, but a general problem with the Sun Java VM that is often triggered on Eclipse 3.2 and later, if you have many plug-ins installed.</p> <p>To fix it simply add the following to your launch arguments. This is usually to your shortcut:</p> <pre> -vmargs -XX:MaxPermSize=128m |