Please Update or FIX the manual-install document

MyEclipse Archived

Documentation

This topic has 1 reply, 2 voices, and was last updated 18 years, 3 months ago by Riyad Kalla.

Viewing 2 posts - 1 through 2 (of 2 total)

Author

Posts
August 21, 2006 at 10:46 pm #257334 Reply

kevincrocker
Member

I’ve found MyEclipse to be a very good product – with some minor annoyances.

However, the one thing that is really annoying is the completely outdated
Manual-install document that has a date of August 11, 2006 but has contents
that are for

MyEclipse 3.8 Manual Installation

This just plain doesn’t look like you pay attention to details – which for someone
who is making recommendations to clients all the time is a very odd thing to
try to explain.

This is not something that I should need to gloss over or cover up on your behalf.

Please fix this – it really should take a whole lot of time. Actually, since you seem to have trouble
with this I’m going to upload the corrected file here – now, it may not be perfect
but at least it doesn’t say MyEclipse 3.8 and Eclipse 3.0 anymore.
==========================================

<!DOCTYPE html PUBLIC “-//W3C//DTD HTML 4.01 Transitional//EN”>

<html>

<head>

<meta content=”text/html; charset=ISO-8859-1″

http-equiv=”content-type”>

<title>MyEclipse 5.01 Manual Installation</title>

<style type=”text/css”>

H3 { color: darkblue }

</style>

</head>

<body>



<h2>MyEclipse 5.01 Manual Installation 

</h2>

<hr style=”width: 100%; height: 2px;”>

<h3>MyEclipse Installation Model</h3>

MyEclipse conforms to the Eclipse Product Extension

Architecture. This is a packaging model that allows MyEclipse to be

installed outside of the core Eclipse installation and has a parallel

directory structure similar to that of an Eclipse install. This

approach significantly reduces the risk of corrupting your Eclipse base

installation during the install process due to conflicting plugins being

installed or overwritten. 



<table align=”center” border=”0″ cellpadding=”0″ cellspacing=”0″>

<tr>

<td colspan=”2″><img src=”img/install_model_diagram.gif”></td>

</tr>

<tr>

<td> </td>

</tr>

<tr>

<td align=”left”>C:\Eclipse\Eclipse-3.2</td>

<td align=”right”>C:\Genuitec\MyEclipse-5.01</td>

</tr>

</table>

The

entire product of Features and Plugins is managed by

Eclipse even those not deployed directly into Eclipse’s Features/Plugin

directories. For more information about the Eclipse Product

Extension Architecture, click <a

href=”http://help.eclipse.org/help21/index.jsp?topic=/org.eclipse.platform.doc.isv/guide/product_extension.htm”>here</a>. 



<hr style=”width: 100%; height: 2px;”>

<h3>Installation Prerequisites</h3>

This document assumes the following: 



<ul>

<li>Eclipse 3.2 or greater is

installed. 

</li>

<li>Eclipse has been launched at least once so the install process

can complete.</li>

<li>All earlier releases of MyEclipse have been

uninstalled. 

</li>

<li>Some sort of Zip/Unzip software. WinXP, Linux, Mac OSX

users have built-in zip support. All other can grab <a

href=”http://www.winzip.com”>WinZip</a>. This document will cover the

use WinZip, please adapt accordingly for your respective unzipping

software. 

</li>

</ul>

<hr style=”width: 100%; height: 2px;”>

<h3>Manual Install Process</h3>

 

<table style=”text-align: left; width: 100%;” border=”0″ cellspacing=”2″

cellpadding=”2″>

<tbody>

<tr>

<td style=”vertical-align: top; text-align: left; width: 50px;”>Step 1 

</td>

<td style=”vertical-align: top;”>Download the latest release of

the MyEclipse manual installation zip file. For the purposes of

this example, that will be myeclipse_05.0100.zip.

The actual file you download may be different. 

 

If you do not have the latest release, you can download it from <a

href=”http://www.myeclipseide.com/index.php?module=ContentExpress&func=display&ceid=10″>here</a>. 

</td>

</tr>

<tr>

<td style=”vertical-align: top; text-align: left; width: 50px;”>Step 2</td>

<td style=”vertical-align: top;”>

Open the myeclipse_05.0100.zip

file. 



<img

alt=””

src=”img/winzip_myeclipse_updated.gif”> 

 

</td>

</tr>

<tr>

<td style=”vertical-align: top; width: 50px;”>Step 3 

</td>

<td style=”vertical-align: top;”>Click the “Extract” button and specify a directory

to unzip MyEclipse to. The location does not matter as long as it is not under the Eclipse install directory.

As an example, we will use: C:\Genuitec\MyEclipse-5.01 

 

For Linux, you can use: /opt/MyEclipse-5.01 or /usr/local/MyEclipse-5.01 For

Mac OS X, you can use: /Applications/MyEclipse-5.01 

 

<img alt=””

src=”img/winzip_extract_updated.gif”> 

 

</td>

</tr>

<tr>

<td style=”vertical-align: top; width: 50px;”>Step 4 

</td>

<td style=”vertical-align: top;”>Click the “Extract” button and let WinZip unzip MyEclipse to the

location you specified.

 

<img alt=””

src=”img/winzip_extracting_updated.gif”> 

 

After extracting the MyEclipse files, your MyEclipse installation

directory should contain a directory named eclipse. Inside of this eclipse

directory, you should have two subdirectories: features and plugins. 

 

<img

alt=”” src=”img/myeclipse_dir_updated.gif”></td>

</tr>

<tr>

<td style=”vertical-align: top; width: 50px;”>Step 5 

</td>

<td style=”vertical-align: top;”>Now we need to start Eclipse. We will use the

new product extension management functionality in Eclipse 3.2 finish this installation.

 

Launch Eclipse and navigate to the Help > Software Updates > Manage Configuration menu item and

click on it.

 

<img alt=”” src=”img/eclipse_manage_configuration_updated.gif”>

 

This will open the Product Configuration dialog that we can use to finish the MyEclipse install

 

<img alt=”” src=”img/product_configuration_updated.gif”>

 

</td>

</tr>

<tr>

<td style=”vertical-align: top; width: 50px;”>Step 6 

</td>

<td style=”vertical-align: top;”>Now we will add a new product extension to Eclipse. Right click

on the root node labelled “Eclipse Platform”, select “New” and then “Extension Location…” 

<img alt=”” src=”img/new_product_configuration_updated.gif”>

 

Now navigate to the location you unzipped MyEclipse to, select that directory and click “OK”.

 

<img alt=”” src=”img/select_extension_location_updated.gif”>

 

Eclipse will finish installation of MyEclipse and then prompt you to restart in order

to finish applying changes, go ahead and click “Yes”.

 

<img alt=”” src=”img/restart_eclipse_updated.gif”>

</td>

</tr>

<tr>

<td style=”vertical-align: top; width: 50px;”>Step 7 

</td>

<td style=”vertical-align: top;”>After Eclipse restarts, navigate to the

Window > Open Perspective > Other… menu option and click on it.

 

<img alt=”” src=”img/open_perspective_updated.gif”>

 

Then select “MyEclipse” and click “OK”. Note: If the MyEclipse perspective was already displayed

on the Open Perspective sub menu as shown in the screenshot, it is fine to select it from there as well.

</td>

</tr>

<tr>

<td style=”vertical-align: top;”>Step

8 

</td>

<td style=”vertical-align: top;”>All finished! MyEcipse

Enterprise Workbench is now fully installed. 

</td>

</tr>

</tbody>

</table>

 

<hr style=”width: 100%; height: 2px;”>

<h3> 

</h3>

<h3>Manual Uninstall Process</h3>

 

<table style=”text-align: left; width: 100%;” border=”0″ cellspacing=”2″

cellpadding=”2″>

<tbody>

<tr>

<td style=”vertical-align: top; width: 50px;”>Step 1 

</td>

<td style=”vertical-align: top;”>Navigate back to the Help > Software Updates > Manage Configuration… menu item, and

click it. Then right click on the MyEclipse extension, and select “Disable”

 

<img alt=”” src=”img/disable_product_configuration_updated.gif”>

 

Eclipse will ask if you want to disable all the features in the MyEclipse extension, click “Yes”.

 

When Eclipse then asks you to restart in order to apply changes, click “Yes” again.

 

<img alt=”” src=”img/disable_extension_restart_updated.gif”>

</td>

</tr>

<tr>

<td style=”vertical-align: top; width: 50px;”>Step 2 (Optional) 

</td>

<td style=”vertical-align: top;”>To completely remove MyEclipse from your system you can do the following:

 

Shut down Eclipse. Navigate to your MyEclipse install directory, e.g. C:\Genuitec\MyEclipse-5.01, and erase it. Now navigate to your Eclipse install directory,

e.g. C:\Eclipse\Eclipse-3.2, and erase your configuration directory. NOTE: While this will

clear Eclipse’s knowledge of MyEclipse, the step of erasing the configuration directory could potentially clear the settings for

any additional installed extensions. This step should not clear your workbench settings and or other plugin settings (this information is stored under your workspace\.metadata directory),

this optional step should only effect other externally installed extensions.</td>

</tr>

</tbody>

</table>

<hr style=”width: 100%; height: 2px;”>

<h3>Questions / Help 

</h3>

For installation help please visit the <a

href=”http://www.myeclipseide.com/modules.php?op=modload&name=PNphpBB2&file=index”>MyEclipse

Support Forums</a>. The support staff will be very willing to

help you with your installation problems because we want your first

experience with MyEclipse to go smoothly. Our high-quality

support is a major strength of the MyEclipse product. Try us out! 

 

</body>

</html>

August 23, 2006 at 3:46 pm #257467 Reply

Riyad Kalla
Member

Kevin,
We appreciate you taking the time to do this. The reason this document does not get updated with each release is because version 3.8.0 was the first version we introduced the manual install, and since then the steps to install the manual install has not changed, so this manual is applicable to all versions from 3.8.0 to 5.0.1 strangely enough.

I do think you bring up a good point that we should make a note about this at the top of the file. I’ll bring it up with management.
Author

Posts

Viewing 2 posts - 1 through 2 (of 2 total)