Institut de Médecine et de Physiologie Spatiales Epidefender Studio Installation notice MEDES Institut de Médecine et Physiologie Spatiales CHU Rangueil - 1 avenue du Professeur Jean Poulhès - 31403 Toulouse CEDEX 4. Tél. 05.62.17.49.51 - Fax 05.62.17.49.51 - http://www.medes.fr
Summary 1. Scope of the document...3 2. Installation instructions...4 2.1. Install the Eclipse IDE...4 2.2. Install the JDK and configure it for Eclipse...4 2.3. Install the servlet container Tomcat and configure it for Eclipse...6 2.3.1. Add Tomcat as a server in the Eclipse Workbench...8 2.4. Install the GWT plugins for Eclipse...10 2.5. Install the Android plugins for Eclipse and the Android SDK...11 2.5.1. Download and install the SDK starter package...11 2.5.2. Downloading the ADT Plugin...12 2.5.3. Configuring the ADT Plugin...14 2.5.4. Adding Android Platforms and Other Components...15 2.6. Install the Epidefender plugins for Eclipse...16 3. Update the Epidefender installation...17 HCR/OMS 11/06/10 2/17
1. Scope of the document This document is a user guide explaining how to install and configure the Epidefender Studio, a platform enabling to develop data collection applications. HCR/OMS 11/06/10 3/17
2. Installation instructions 2.1. Install the Eclipse IDE Install the Eclipse IDE (Galileo version). It can be downloaded from the Eclipse web site. Select the version Eclipse IDE for Java EE Developers. 2.2. Install the JDK and configure it for Eclipse Install the Java Development Kit version 6 (Standard Edition/JDK 6 ). It can be downloaded on the Java/Sun website. Configure Eclipse to use the installed JDK. 1. In the Eclipse menu, select 'Window/Preferences' 2. In the dialog box, select in the tree-view, 'Java/Installed JREs'. 3. On the right side of the dialog box, click on the 'Add' button. HCR/OMS 11/06/10 4/17
4. Select 'Standard VM', and in the following dialog box, press the button 'Directory' to browse to the folder where the JDK is installed. 5. Once configured, click the button 'Finish'. 6. Once done, in the Installed JREs window, select the installed JDK as the default JRE by activating its radio button. HCR/OMS 11/06/10 5/17
2.3. Install the servlet container Tomcat and configure it for Eclipse Install Tomcat version 6. It can be downloaded on the Apache Tomcat website. (For Windows, do not select the option to start the service at start-up). Install Tomcat as a Server Runtime Environment Configure Eclipse to use the installed Apache Tomcat. 1. In the Eclipse menu, select 'Window/Preferences' 2. In the dialog box, select in the treeview, 'Server/Runtime Environments'. 3. On the right side of the dialog box, click on the 'Add' button. HCR/OMS 11/06/10 6/17
4. In the following dialog window, select 'Apache Tomcat v6,0'. HCR/OMS 11/06/10 7/17
5. Press the button 'Browse' to browse to the folder where Tomcat is installed. 6. Click Finish and then OK. 2.3.1. Add Tomcat as a server in the Eclipse Workbench 1. In the Eclipse menu, select 'File/New/Other'. 2. In the following window, go to the 'Server' folder. 3. Select 'Server'. 4. Click Next. 5. Keep the 'Tomcat v6,0 Server' default option 6. Click Next and Finish. HCR/OMS 11/06/10 8/17
HCR/OMS 11/06/10 9/17
2.4. Install the GWT plugins for Eclipse 1. In the Eclipse menu, select 'Help/Install New software...'. 2. Click on the 'Add' button at the top right of the window. You will add a new update site to Eclipse. This update site will enable to install and update the GWT plugins. Enter 'GWT' as 'Name' and 'http://dl.google.com/eclipse/plugin/3.5' as 'Location'. 3. Click OK. The GWT update site is added to the update site list (label 'Work with'). 4. In this 'Work with' drop down list, select the newly added GWT update site. The GWT plugins appear in the plugin name list. HCR/OMS 11/06/10 10/17
5. In the GWT plugin list, select 'Google Plugin for Eclipse', and 'Google Web Toolkit SDK'. 6. Click Next, Next again, Accept the terms of the licence Agreement, and click 'Finish'. Eclipse starts the installation of the GWT plugins and of all the other complementary plugins that GWT requires. A warning message informs you about the unverified certificates, select the Eclipse.org certificate, and click OK to trust the certificate. 2.5. Install the Android plugins for Eclipse and the Android SDK 2.5.1. Download and install the SDK starter package Platform Windows Mac OS X (intel) Linux (i386) Package android-sdk_r06-windows.zip android-sdk_r06-mac_86.zip android-sdk_r06-linux_86.tgz HCR/OMS 11/06/10 11/17
Select a starter package from the table and download it to your development computer. To install the SDK, simply unpack the starter package to a safe location. It can be useful to add the location to your PATH as follow: On Linux, edit your ~/.bash_profile or ~/.bashrc file. Look for a line that sets the PATH environment variable and add the full path to the tools/ directory to it. If you don't see a line setting the path, you can add one: export PATH=${PATH}:<your_sdk_dir>/tools On a Mac OS X, look in your home directory for.bash_profile and proceed as for Linux. You can create the.bash_profile if you haven't already set one up on your machine. On Windows, right-click on My Computer, and select Properties. Under the Advanced tab, hit the Environment Variables button, and in the dialog that comes up, double-click on Path (under System Variables). Add the full path to the tools/ directory to the path. 2.5.2. Downloading the ADT Plugin Use Update Manager feature of your Eclipse installation to install the latest revision of ADT on your development computer. 1. Start Eclipse, then select Help > Install New Software. 2. In the Available Software dialog, click Add... HCR/OMS 11/06/10 12/17
3. In the Add Site dialog that appears, enter a name for the remote site (for example, "Android Plugin") in the "Name" field. In the "Location" field, enter this URL: https://dl ssl.google.com/android/eclipse/ Note: If you have trouble acquiring the plugin, you can try using "http" in the URL, instead of "https" (https is preferred for security reasons). Click OK. 4. Back in the Available Software view, you should now see "Developer Tools" added to the list. Select the check box next to Developer Tools, which will automatically select the nested tools Android DDMS and Android Development Tools. Click Next. HCR/OMS 11/06/10 13/17
5. In the resulting Install Details dialog, the Android DDMS and Android Development Tools features are listed. Click 'Next' to read and accept the license agreement and install any dependencies, then click 'Finish'. 6. Restart Eclipse. 2.5.3. Configuring the ADT Plugin Once you've successfully downloaded ADT as described above, the next step is to modify your ADT preferences in Eclipse to point to the Android SDK directory: 1. Select 'Window > Preferences...' to open the Preferences panel (Mac OS X: Eclipse > Preferences). 2. Select 'Android' from the left panel. 3. For the SDK Location in the main panel, click Browse... and locate your downloaded SDK directory. 4. Click Apply, then OK. HCR/OMS 11/06/10 14/17
2.5.4. Adding Android Platforms and Other Components 1. Back to your Eclipse, select 'Window > Android SDK and AVD Manager'. 2. In the Android SDK and AVD Manager dialog, select 'Available Packages' from the left panel. 3. Select 'SDK Platform Android 1.6, API 4 revision 3' and 'Google APIs by Google Inc, Android API 4, revision 2'. HCR/OMS 11/06/10 15/17
4. Click 'Install' Selected. 5. In the Choose Packages to Install select 'Accept All' 6. Click 'Install' Done! If you haven't encountered any problems, then the installation is complete. 2.6. Install the Epidefender plugins for Eclipse 1. In the Eclipse menu, select 'Help/Install New software...'. 2. Click on the 'Add' button at the top right of the window. You will add a new update site to Eclipse. This update site will enable to install and update the Epidefender plugins. 3. Enter 'Epidefender' as 'Name' and 'http://unhcr.epidefender.org/update' or 'http://oms.epidefender.org/update' as 'Location', depending of your organization. 4. Click OK. The Epidefender update site is added to the update site list (label 'Work with'). 5. In this 'Work with' drop down list, select the newly added Epidefender update site. HCR/OMS 11/06/10 16/17
6. To see the Epidefender plugin, unselect the checkbox 'group Items by Category'. The Epidefender plugins appear in the plugin name list. 7. Select all the plugins from the list. 8. Click Next, Next again, Accept the terms of the licence Agreement, and click 'Finish'. Eclipse starts the installation of the Epidefender plugins and of all the other complementary plugins that Epidefender requires. A warning message informs you about the unverified certificates, select the Eclipse.org certificate, and click OK to trust the certificate. 3. Update the Epidefender installation Eclipse provides a mechanism to update the installed plugins including the Epidefender ones. To update your installation go to the menu 'Help' and select 'Check for updates'. HCR/OMS 11/06/10 17/17