Appion

h1. AMI Eclipse Quick Start Guide

{{>toc}}

h2. 1 Get the Eclipse executable

First, you can try the executable that already has the plugins installed. Get "eclipse.tar.gz":http://emg.nysbc.org/attachments/download/8/eclipse.tar.gz. Just copy it to your machine, uncompress it and the executable is available within the eclipse directoy. No further installation steps are required.

If you want to install things yourself, this is what you need:

# Download eclipse from "here":http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/galileo/SR1/eclipse-jee-galileo-SR1-linux-gtk-x86_64.tar.gz.

# Get the plugins:

## Subversion

## PHP

## Subversion connector

## pydev

# Copy it to somewhere on your local machine.

# Double click the eclipse executable to open. If using a machine that was setup with the AMI kickstart program, you will need to update java to use the 64 bit version. 

See also: "PHP: Debugging with Eclipse":http://www.youtube.com/watch?v=zlHUCAf7oSk 

h2. 2 Create a Workspace and get the MyAMI code from Subversion

# Double click the eclipse executable found in the eclipse directory.

# When it opens, it will prompt you to choose a workspace. This workspace will hold a local copy of the myami code for you to work on. A good workspace location is a amiworkspace in your home directory. That is /home/username/amiworkspace.

# From the menu, select Window -> Open Perspective -> SVN Repository Exploring. This will open a view labeled SVN Repositories.

# Go to File -> New -> Repository Location.

# In the URL field type: http://emg.nysbc.org/svn/myami to get the Appion and Leginon code.

# Press the Finish button at the bottom of the dialog. A new repository will appear in the SVN Repositories view.

# Click on the arrow next to the repository icon to view the trunk, branches and tags associated with the repository.

# Click on the trunk to highlight it. Right click and select Checkout. This will get the code from the repo and put it in your workspace. When the operation completes, you will find a myami directory under amiworkspace in your home directory.

h2. 2.1 Import an existing project into a workspace 

# open the PHP or pydev view

# right click and select import

# under General select Existing Projects into Workspace

# select the project

# after the workspace is loaded, if the project is not linked to SVN, select Team->Share Project and select the repository

h2. 3 Configure your Development Environment

There are 2 types of development that you will most often do with the MyAMI code, Python for core processing and PHP for the web interface.

h3. 1 Setup the Python environment

Go to Window -> Preferences -> PyDev -> Editor -> Interpreter – python. Press the Auto Config button then press OK.

h3. 2 Setup the PHP environment

There are two ways to view the web applications that you are developing in your home directory. If you are developing on a machine that does not have a local Apache server, you can use the Cronus3 web server. The advantage of this is that all the image processing plugins are already installed on Cronus3 so you don't have to worry about them and you don't have to worry about making Apache work. If you do run Apache locally, you can take advantage of integrated debugging tools in Eclipse and learn more about how all the pieces of the project fit together since will will have to set more things up. 

Also note that the directions below will not get project_tools running. It is currently undergoing many changes and directions will be added when that process is complete.

h4. Use Cronus3 or Fly to view your web app

Follow [[Use Cronus3 or Fly to view your web app]]

h4. Create your config file

Use the setup wizard to create the config file by browsing to myamiweb/setup. 

At AMI, you would go to cronus3/~YOUR_HOME_DIR/myamiweb/setup.

*IMPORTANT:* Never check your local copy of the config files into Subversion. We don't want to share our database user information with the world.

# To edit the config file by hand:

## Change directories to the myamiweb project: *$ cd ~/amiworkspace/myami/myamiweb*

## Copy config.php.template to config.php: *$ cp config.php.template config.php*

## Open config.php for editting: *$ vi config.php*

## Make changes similar to this [[example config file]], replacing "amber" with your home directory. 

h4. Use your local Apache server to view your web app (optional)

# Make sure you are logged in as root. ($ su)

# Make sure Apache is installed. There should be /etc/init.d/httpd on your machine. Start apache with $ /etc/init.d/httpd start. 

# Point a web browser to http://localhost/ and make sure you see the apache test page.

# Make sure Apache is configured for php

# the Apache config file is at /etc/httpd/conf

# web files should be at /var/www/html

## create  symbolic link to your workspace in /var/www/html

## Try to view at http://localhost/myamiweb 

## Not working because need the files on phpami

### go to phpami in your myamiweb workspace and create symbolic links to each file that remove the .php file extension

### put a symbolic link to this folder from user/share ( $ ln -s /home/amber/amiworkspace/myami/phpami php )

# To debug PHP issues check http://localhost/myamiweb/info.php

# For everything to work, you need to install plugins like the MRC module

h2. 4 Get a local copy of the databases (optional)

If you want to work on the databases and you would prefer to have a local copy to play with, read [[Setup Local Databases | How to set up a local copy of AMI databases]].

You also have an option of creating a copy of the database that you wish to work with on the fly server. You will name your DB with your name prepended to the name of the DB that is copied. You will need to update your Config file accordingly. You can work with your DB without affecting formal testing on fly or the production databases.

h2. 5 Run a Python Script

# Change perspective to PyDev. (Window->Open Perspective)

# Right click on the myami project and choose Properties

# Select PyDev - PYTHONPATH

# Under Source Folders select Add source folder

# Make sure myami is selected and press OK

# Build numextension

## Right click on numextension/setup.py and select Properties

## Select Run/Debug settings

## Select Edit

## Select the Arguments tab

## Under program arguments type _build_

## Select OK

## Right click on setup.py and select Run As->Python Run

# Run Leginon 

## Make sure the config files are set correctly (leginon.cfg, sinedon.cfg)

## Run leginon/syscheck.py by right clicking and selecting Run As->Python Run

## Right click on leginon/start.py and select Run As->Python Run

h2. 6 Merge a revision to another branch

# Commit your change and note the revision number.

# Go to the branch that you want to merge the code into and select Team->Merge.

# Under URL click Browse and select the trunk or branch that you already committed your changes to.

# In the revisions area, select the radio button next to Revisions: and click the Browse button.

# Select the revision that you wish to merge AND the revision immediately preceding yours.

# Select OK to close out the revision browser.

# Select the Preview Button to see what files will be merged.

# If it looks like the correct files, select the Ok button the close the preview and select OK again to execute the Merge.

# When it completes, Eclipse will open a synchronizing window where you can see the differences between your local, merged version of the files and the version held by SVN.

# If all the changes look correct, you may Commit the changes. Please include a comment in the commit message similar to the following:

bq. Merge from trunk r14376 and r14383 to 2.0 branch, Fix for Post-processing does not work with FREALIGN jobs , refs #657

h2. 7 How to commit a change to svn

# In the Pydev Explorer or PHP explorer view, right click on the file, folder or project that you want to commit and select Team->Synchronize with repository. This will show you what files have been changed in your local sandbox.

# You may click on the changed files to view the specific differences that you will be checking in to ensure they are what you intended.

# Then right click and select Commit. Add a comment that references the redmine issue number (ex. refs #123). This will automatically link the revision number to the issue in redmine.