| 35 | | |
| 36 | | % \subsection{Installing OSSIE via Yum} |
| 37 | | % \label{section:installation:yum} |
| 38 | | |
| 39 | | % Note: At the time this guide was compiled, the latest version of OSSIE available by Yum was 0.7.0. Version 0.7.1 is expected to be available by Yum in late 2008 or early 2009. |
| 40 | | |
| 41 | | % \subsubsection{Add OSSIE Repository to Yum} |
| 42 | | % \label{section:installation:yum:ossierepo} |
| 43 | | % In order to install OSSIE via the YUM repository, you must first edit your `/etc/yum.conf' to |
| 44 | | % add the OSSIE repository to the YUM search list. In this example, we use {\tt nano}, but you may use |
| 45 | | % whatever editor you wish ({\tt vim}, {\tt emacs}, etc). Unless your nanorc has already been configured to not |
| 46 | | % wrap lines, the `-w' flag is necessary to prevent {\tt nano} from adding line breaks to the file. |
| 47 | | % \begin{lstlisting}[] |
| 48 | | % $ su - |
| 49 | | % # nano -w /etc/yum.conf |
| 50 | | % \end{lstlisting} |
| 51 | | % Add the following lines at the bottom of the file: |
| 52 | | % \begin{lstlisting}[] |
| 53 | | % [ossie-vt] |
| 54 | | % name = OSSIE-VT |
| 55 | | % baseurl=http://ossie.wireless.vt.edu/yum/ossie-vt/ |
| 56 | | % gpgcheck=0 |
| 57 | | % \end{lstlisting} |
| 58 | | % Now update your system. This will refresh your yum package cache. It is also always smart to have |
| 59 | | % a fully updated system before installing new software anyways. |
| 60 | | % \begin{lstlisting}[] |
| 61 | | % # yum update |
| 62 | | % \end{lstlisting} |
| 63 | | % |
| 64 | | % \subsubsection{Install OSSIE} |
| 65 | | % \label{section:installation:yum:installviayum} |
| 66 | | % Now install OSSIE and its dependencies via yum by typing: |
| 67 | | % \begin{lstlisting}[] |
| 68 | | % # yum install ossie |
| 69 | | % # exit |
| 70 | | % \end{lstlisting} |
| 71 | | |
| 72 | | % Congratulations! You should now have a fully-operable OSSIE installation. |
| 98 | | % OSSIE \ossieversion\ is packaged with a convenient Python script called {\tt build.py} to automatically |
| 99 | | % configure and build the packages necessary for the framework, tools, and other |
| 100 | | % libraries. Use of this script is not mandatory, and you can manually compile and install all/part of |
| 101 | | % OSSIE as you wish. |
| 102 | | |
| 103 | | \subsubsection{Installing Dependencies on Fedora} |
| 104 | | \label{section:installation:source:dependencies:fedora} |
| 105 | | On Fedora systems, the dependencies can be installed via {\tt yum}. |
| 106 | | % |
| 107 | | % First, add the OSSIE yum repository to your yum.conf. This is described in |
| 108 | | % Section~\ref{section:installation:yum:ossierepo} |
| 109 | | % |
| 110 | | This is the entire dependency list, so some of these packages may already be installed. |
| 111 | | \begin{lstlisting}[] |
| 112 | | # yum -y install wxPython wxPython-devel numpy \ |
| 113 | | rpm-build cabextract glibc-devel \ |
| 114 | | python-devel openssl-devel gcc gcc-c++ libtool |
| 115 | | \end{lstlisting} |
| 116 | | |
| 117 | | When installing OSSIE on Fedora, we recommend installing omniORB and omniORBpy |
| 118 | | from source. This should only be done for Fedora however. If installing on |
| 119 | | Ubuntu, follow the directions in |
| 120 | | section~\ref{section:installation:dependencies:ubuntu}. |
| 121 | | \begin{lstlisting}[] |
| 122 | | $ wget http://omniorb.sourceforge.net/releases/omniORB-4.1.4.tar.gz |
| 123 | | $ wget http://omniorb.sourceforge.net/releases/omniORBpy-3.4.tar.gz |
| 124 | | $ tar -xvf omniORB-4.1.4.tar.gz $ tar -xvf omniORBpy-3.4.tar.gz |
| 125 | | $ cd omniORB-4.1.4/ |
| 126 | | $ mkdir build |
| 127 | | $ cd build |
| 128 | | $ ../configure |
| 129 | | $ make |
| 130 | | $ sudo make install |
| 131 | | $ cd ../../omniORBpy-3.4/ |
| 132 | | $ mkdir build |
| 133 | | $ cd build |
| 134 | | $ ../configure |
| 135 | | $ make |
| 136 | | $ sudo make install |
| 137 | | \end{lstlisting} |
| 138 | | |
| 139 | | If you plan on using GNURadio 3.2 or higher, or the USRP2, as part of your work, then you will need to install Boost v1.35 or higher. |
| 140 | | Currently, Fedora and Ubuntu do not ship with this version, so you will need to install it. |
| 141 | | Whether you are using Fedora or Ubuntu, we recommend that you install Boost from source. Download Boost from |
| 142 | | \href{http://sourceforge.net/projects/boost/files/boost/1.37.0/boost\_1\_37\_0.tar.bz2/download}{http://sourceforge.net/projects/boost/} and unpack {\tt boost\_1\_37\_0.tar.bz2}. |
| 143 | | \begin{lstlisting}[] |
| 144 | | $ wget http://sourceforge.net/projects/boost/files/boost/1.37.0/ \ |
| 145 | | boost_1_37_0.tar.bz2/download |
| 146 | | $ tar -xvf boost_1_37_0.tar.bz2 |
| 147 | | $ cd boost_1_37_0/ |
| 148 | | $ ./configure --prefix=/usr/ |
| 149 | | $ make |
| 150 | | $ sudo make install |
| 151 | | \end{lstlisting} |
| 152 | | |
| 153 | | If you are using Fedora Core 10 or higher, you will need to download the RPM for the SDL library in order to user the JPEGVideoViewer component. |
| 154 | | \begin{lstlisting}[] |
| 155 | | $ wget http://www.libsdl.org/release/SDL-devel-1.2.13-1.i386.rpm |
| 156 | | $ rpm -Ui SDL-devel-1.2.13-1.i386.rpm |
| 157 | | \end{lstlisting} |
| 158 | | % |
| 159 | | % Now move onto Section~\ref{section:installation:source:dependencies:gnuradio} |
| 160 | | % |
| | 52 | %\subsubsection{Installing Dependencies on Fedora} |
| | 53 | %\label{section:installation:source:dependencies:fedora} |
| | 54 | |
| | 55 | %If you plan on using GNURadio 3.2 or higher, or the USRP2, as part of your work, then you will need to install Boost v1.35 or higher. |
| | 56 | %Currently, Fedora and Ubuntu do not ship with this version, so you will need to install it. |
| | 57 | %Whether you are using Fedora or Ubuntu, we recommend that you install Boost from source. Download Boost from |
| | 58 | %\href{http://sourceforge.net/projects/boost/files/boost/1.37.0/boost\_1\_37\_0.tar.bz2/download}{http://sourceforge.net/projects/boost/} and unpack {\tt boost\_1\_37\_0.tar.bz2}. |
| | 59 | %\begin{lstlisting}[] |
| | 60 | % $ wget http://sourceforge.net/projects/boost/files/boost/1.37.0/ \ |
| | 61 | % boost_1_37_0.tar.bz2/download |
| | 62 | % $ tar -xvf boost_1_37_0.tar.bz2 |
| | 63 | % $ cd boost_1_37_0/ |
| | 64 | % $ ./configure --prefix=/usr/ |
| | 65 | % $ make |
| | 66 | % $ sudo make install |
| | 67 | %\end{lstlisting} |
| | 68 | |
| | 69 | \subsubsection{Installing Dependencies} |
| | 70 | Ubuntu is the main supported operating system for OSSIE, and Ubuntu 11.04, 10.10 and 10.04 all |
| | 71 | have a different list of dependencies that must be installed. After following the instructions |
| | 72 | for your respective operating system, jump to |
| | 73 | Section~\ref{section:installation:source:dependencies:configomni} to continue the install. |
| | 74 | |
| | 75 | \subsubsection{Installing Dependencies on Ubuntu 10.10} |
| | 76 | A few of the dependencies changed with Ubuntu 10.10, specifically omniidl4-python is now omniid-python, and python-omniorb2 is now python-omniorb. The updated dependency list is below. |
| | 77 | \begin{lstlisting}[] |
| | 78 | $ sudo aptitude install gcc build-essential |
| | 79 | $ sudo aptitude -y install omniorb4 libomniorb4-dev omniidl-python \ |
| | 80 | omniorb4-nameserver python-omniorb libgtk2.0-dev freeglut3-dev \ |
| | 81 | python-wxgtk2.8 python-wxversion python-wxtools python-numpy \ |
| | 82 | python-numpy-ext python-numpy-dev python-profiler g++ automake \ |
| | 83 | libtool subversion python-dev fftw3-dev libcppunit-dev libboost-dev sdcc \ |
| | 84 | libusb-dev libasound2-dev libsdl1.2-dev guile-1.8 libqt3-mt-dev swig \ |
| | 85 | python-profiler automake1.9 python2.6-dev sdcc-libraries guile-1.8-dev \ |
| | 86 | libqt4-dev ccache python-opengl libgsl0-dev python-lxml \ |
| | 87 | doxygen qt4-dev-tools libqwt5-qt4-dev libqwtplot3d-qt4-dev \ |
| | 88 | libboost-filesystem-dev libboost-system-dev libboost-thread-dev \ |
| | 89 | libboost-program-options-dev |
| | 90 | \end{lstlisting} |
| | 91 | |
| 181 | | \subsubsection{Installing Dependencies on Ubuntu 10.10 and up} |
| 182 | | A few of the dependencies changed with Ubuntu 10.10, specifically omniidl4-python is now omniid-python, and python-omniorb2 is now python-omniorb. The updated dependency list is below. |
| 183 | | \begin{lstlisting}[] |
| 184 | | $ sudo aptitude install gcc build-essential |
| 185 | | $ sudo aptitude -y install omniorb4 libomniorb4-dev omniidl-python \ |
| 186 | | omniorb4-nameserver python-omniorb libgtk2.0-dev freeglut3-dev \ |
| 187 | | python-wxgtk2.8 python-wxversion python-wxtools python-numpy \ |
| 188 | | python-numpy-ext python-numpy-dev python-profiler g++ automake \ |
| 189 | | libtool subversion python-dev fftw3-dev libcppunit-dev libboost-dev sdcc \ |
| 190 | | libusb-dev libasound2-dev libsdl1.2-dev guile-1.8 libqt3-mt-dev swig \ |
| 191 | | python-profiler automake1.9 python2.6-dev sdcc-libraries guile-1.8-dev \ |
| 192 | | libqt4-dev ccache python-opengl libgsl0-dev python-lxml \ |
| 193 | | doxygen qt4-dev-tools libqwt5-qt4-dev libqwtplot3d-qt4-dev \ |
| 194 | | libboost-filesystem-dev libboost-system-dev libboost-thread-dev \ |
| 195 | | libboost-program-options-dev |
| 196 | | \end{lstlisting} |
| 197 | | |
