Appion

h1. AMI Eclipse Quick Start Guide

{{>toc}}

h2. 1. Get the Eclipse executable

# AMI has a preconfigured version available at [  ...  ]

# Copy it to ...

# Double click the eclipse executable to open. If using a machine that was setup with the AMI kickstart program, you will need to update [...]

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. 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. 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 to view your web app

# Open a terminal and go to your home directory: @$ cd ~@

# If is does not exist, create a directory called ami_html/: @$ mkdir ami_html/

# Change directories to ami_html:  $cd ami_html@

# Create a symbolic link to the web app directory in your workspace: @$ ln -s /home/[username]/amiworkspace/myami/myamiweb@

# Try to browse to the project in a web browser ( http://cronus3/~username/myamiweb ). You should see an error because config.php failed to open.

h4. Create your config file

*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.

# 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 the following changes to config.php:

<pre>

// --- Set your leginon MySQL database server parameters

$DB_HOST        = "cronus4";

$DB_USER        = "usr_object";

$DB_PASS        = "";

$DB             = "dbemdata";

// --- XML test dataset

$XML_DATA = "test/viewerdata.xml";

// --- Project database URL

$PROJECT_URL = "http://cronus3.scripps.edu/~[username]/project_tools";

$PROJECT_DB_HOST = "cronus4";

$PROJECT_DB_USER = "usr_object";

$PROJECT_DB_PASS = "";

$PROJECT_DB = "project";

</pre>

h4. Use your local Apache server to view your web app

# 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.