| | 266 | |
| | 267 | \subsection{Installation of OSSIE Eclipse Feature} |
| | 268 | \label{section:installation:oefinstall} |
| | 269 | Installation of the OSSIE Eclipse Feature (OEF) requires the intallation of OSSIE, Java, and Eclipse. |
| | 270 | |
| | 271 | \subsubsection{Installing Java} |
| | 272 | \label{section:installation:javainstall} |
| | 273 | If installing OEF on Fedora 9, this step can be skipped as Java is already installed. However on other platforms this step may need to be performed. |
| | 274 | |
| | 275 | Eclipse is written in Java, so you must have it installed to run Eclipse and OEF. Install the full Java Software Development Kit (SDK) for best results. The GNU gcc implementation of Java, gcj, will not work and therefore Sun's JDK must be used instead. To install, go to the \href{http://java.sun.com/javase/downloads/index.jsp}{Java SE download page} and download the latest JDK update that is available. Do not download the NetBeans IDE bundle or the JRE distribution. |
| | 276 | |
| | 277 | On the next page, check the radio button to agree to the license terms and choose either the RPM or the standard self-extracting executable. Execute the installer file you downloaded to install the Java SE JDK. If you downloaded the RPM version, the file will expand into several RPM files. Use your package manager to install them next. |
| | 278 | |
| | 279 | Confirm that the installation is in place. From the command line, enter: |
| | 280 | \begin{lstlisting}[] |
| | 281 | $ java -version |
| | 282 | \end{lstlisting} |
| | 283 | If java is not found, the version number is different than the one that was downloaded, or if the response indicates that gcj is being used, then the {\tt .bashrc} file needs to be updated. Locate the where the Sun Java distribution has been installed: |
| | 284 | \begin{lstlisting}[] |
| | 285 | $ ls /usr/lib | grep java |
| | 286 | \end{lstlisting} |
| | 287 | Open the {\tt .bashrc} file and add the path to it. |
| | 288 | \begin{lstlisting}[] |
| | 289 | $ vim /home/username/.bashrc |
| | 290 | \end{lstlisting} |
| | 291 | For example, add {\tt /usr/lib/java-1.7.0/} to the end of the file: |
| | 292 | \begin{lstlisting}[] |
| | 293 | export PATH=$PATH:/usr/lib/java-1.7.0/ |
| | 294 | \end{lstlisting} |
| | 295 | |
| | 296 | Within the same terminal, update the PATH variable: |
| | 297 | \begin{lstlisting}[] |
| | 298 | $ . ~/.bashrc |
| | 299 | \end{lstlisting} |
| | 300 | |
| | 301 | Java is now installed. |
| | 302 | |
| | 303 | \subsubsection{Installing Eclipse} |
| | 304 | \label{section:installation:eclipseinstall} |
| | 305 | Install the Eclipse IDE for Java Developers. Go to the \href{http://www.eclipse.org/downloads/}{Eclipse Download Center} and download an Eclipse distribution for your platform. |
| | 306 | |
| | 307 | Eclipse is distributed as a tar file that you install in a location of your choice. Pick a location that is appropriate for your platform and simply unpack the contents. There is no self-installer, just untar the distribution. Do not install Eclipse in a directory that has spaces anywhere in its full path name. |
| | 308 | |
| | 309 | \subsubsection{Installing OEF} |
| | 310 | \label{section:installation:oefinstall} |
| | 311 | Now that the dependencies have been installed, OEF can be installed. |
| | 312 | |
| | 313 | Move into the unpacked eclipse directory, and start eclipse: |
| | 314 | \begin{lstlisting}[] |
| | 315 | $ cd /path/to/eclipse |
| | 316 | $ ./eclipse |
| | 317 | \end{lstlisting} |
| | 318 | |
| | 319 | After Eclipse starts, on the toolbar select Help : Software Updates : Find and Install. Choose "Search for new features to install" and click Next. Add a new entry by selecting "New Remote Site". Enter "OSSIE" as the name and {\tt http://ossie.wireless.vt.edu/eclipse/} as the URL, and select OK. Make sure there is a check next to OSSIE in the window, and select Finish. |
| | 320 | |
| | 321 | Eclipse will then display the OSSIE feature. Select the check mark next to the name and select Next. Accept the GNU license agreement and select Next. Then select Finish to install the feature. Select Install All when prompted to install the unsigned feature. Allow eclipse to restart so the changes take effect. |
| | 322 | |
| | 323 | Now that OEF has been installed, select the OSSIE perspective within Eclipse. On the toolbar, select Window : Open Perspective : Other. In the new window, select OSSIE which will then open the OSSIE perspective. On the toolbar, select File : New : OSSIE Waveform, or OSSIE Component to start developing. |
| | 324 | |
| | 325 | These same instructions used for installing OEF can be used later to update it to newer versions. |
