Changeset 9624

Show
Ignore:
Timestamp:
10/12/09 21:14:00 (4 years ago)
Author:
shereef
Message:

Updates for proper installation; please review

Location:
documentation/ossie/user-guide-0.8.0
Files:
3 modified

Legend:

Unmodified
Added
Removed

  • documentation/ossie/user-guide-0.8.0/Installation.tex

    r9623 r9624  
    11% ------------------------------------------------------------------ 
    22% 
    3 %   TITLE: OSSIE 0.7.4 Installation Guide 
     3%   TITLE: OSSIE 0.8.0 Installation Guide 
    44% AUTHORS: Matt Carrick, Drew Cormier, Christopher Covington, 
    55%          Carl B. Dietrich, Joseph Gaeddert, Benjamin Hilburn, 
    … …  
    8282OSSIE depends on the following software packages: 
    8383\begin{itemize} 
    84 \item Xerces - a C++ XML parser 
    8584\item omniORB - a CORBA implementation 
    8685\item omniORBpy - a Python interface for omniORB, necessary for the OSSIE tools and components 
    … …  
    103102This is the entire dependency list, so some of these packages may already be installed. 
    104103\begin{lstlisting}[] 
    105 # yum -y install xerces-c xerces-c-devel omniORB omniORBpy \ 
    106 wxPython wxPython-devel numpy rpm-build cabextract glibc-devel \ 
     104# yum -y install omniORB omniORBpy wxPython \ 
     105wxPython-devel numpy rpm-build cabextract glibc-devel \ 
    107106python-devel openssl-devel gcc gcc-c++ libtool \ 
    108 boost-1.33.1 boost-devel-1.33.1 
     107boost-1.34 boost-devel-1.34 
    109108\end{lstlisting} 
    110109 
    … …  
    126125$ sudo aptitude -y install omniorb4 libomniorb4-dev omniidl4-python \ 
    127126omniorb4-nameserver python-omniorb2 libgtk2.0-dev freeglut3-dev \ 
    128 libxerces27-dev libxerces27 python-wxgtk2.8 python-wxversion \ 
    129 python-wxtools python-numpy python-numpy-ext python-numpy-dev g++ \ 
    130 automake libtool subversion python-dev fftw3-dev libcppunit-dev \ 
    131 libboost-dev sdcc libusb-dev libasound2-dev libsdl1.2-dev guile-1.8 \ 
    132 libqt3-mt-dev swig libboost-filesystem-dev python-profiler \ 
    133 automake1.9 python2.5-dev libboost1.35-dev sdcc-nf guile-1.8-dev \ 
    134 libqt4-dev ccache python-opengl libgsl0-dev python-lxml doxygen \ 
    135 qt4-dev-tools libqwt5-qt4-dev libqwtplot3d-qt4-dev  
     127python-wxgtk2.8 python-wxversion python-wxtools python-numpy \ 
     128python-numpy-ext python-numpy-dev g++ automake libtool subversion python-dev \ 
     129fftw3-dev libcppunit-dev libboost-dev sdcc libusb-dev libasound2-dev \ 
     130libsdl1.2-dev guile-1.8 libqt3-mt-dev swig libboost-filesystem-dev \ 
     131python-profiler automake1.9 python2.5-dev libboost1.35-dev sdcc-nf \ 
     132guile-1.8-dev libqt4-dev ccache python-opengl libgsl0-dev python-lxml \ 
     133doxygen qt4-dev-tools libqwt5-qt4-dev libqwtplot3d-qt4-dev  
    136134\end{lstlisting} 
    137135 
    … …  
    306304\\ and unpack {\tt ossie-\ossieversion.tar.bz2}. 
    307305\begin{lstlisting}[] 
    308  $ wget http://ossie.wireless.vt.edu/download/tarballs/0.7.4/ \  
    309    ossie-0.7.4.tar.bz2 
    310  $ tar -xvjf ossie-0.7.4.tar.bz2 
    311 \end{lstlisting} 
    312  
    313 If you want to install everything by hand, do so, and then move on to Section~\ref{section:installation:source:ossiecf:ldconfig}. 
    314  
    315 If you would rather use the script, follow the steps below. 
     306 $ wget http://ossie.wireless.vt.edu/download/tarballs/0.8.0/ \  
     307   ossie-0.8.0.tar.bz2 
     308 $ tar -xvjf ossie-0.8.0.tar.bz2 
     309\end{lstlisting} 
     310 
     311By default, the installation directory of the OSSIE platform is {\tt /sdr}. In order to install new 
     312source code and binaries into this directory without root permissions, you need to create and change 
     313the ownership of {\tt /sdr}. 
     314\begin{lstlisting}[] 
     315 # mkdir /sdr 
     316 # chown -R username.username /sdr 
     317\end{lstlisting} 
     318where {\tt username} is your user name. 
     319 
     320There are two methods of installation available for OSSIE 0.8.0. The easy method is to run the 'build.py' script, ~\ref{section:installation:source:ossiecf:buildpy}. 
     321The new method, which we recommend for users targeting embedded systems, is to build OSSIE from the root using the autotools 'configure' and 'make' system. 
     322If you plan to develop applications on your desktop or laptop, then move on to Section~\ref{section:installation:source:ossiecf:buildpy}. If you plan to target an  
     323embedded system, then follow the steps below. 
     324 
     325\subsubsection{Using Autoconf} 
     326\label{section:installation:source:ossiecf:autoconf} 
     327 
     328\begin{lstlisting}[] 
     329 $ cd ossie-0.8.0 
     330 $ ./bootstrap 
     331 $ ./configure --prefix=/sdr --libdir=/usr/local/lib/ --includedir=/usr/local/include/ 
     332 $ make 
     333 $ sudo make install 
     334\end{lstlisting} 
     335 
     336If you prefer, or require, a different root directory, then change the '--prefix' flag to your appropriate absolute path. 
     337If you require the OSSIE libraries to be installed to a different locatio, then change the '--libdir' flag to your appropriate absolute path. 
     338For futher 'configure' options, use {\tt configure --help}. 
    316339 
    317340\subsubsection{Using Installation Scripts} 
    … …  
    341364%TODO: Have a more secure (wheel group only?) method 
    342365 
    343 By default, the installation directory of the OSSIE platform is {\tt /sdr}.  In 
    344 order to install new source code and binaries into this directory 
    345 without root permissions, you need to create and change the ownership of {\tt 
    346 /sdr}. 
    347 \begin{lstlisting}[] 
    348  # mkdir /sdr 
    349  # chown -R username.username /sdr 
    350 \end{lstlisting} 
    351 where {\tt username} is your user name. 
    352  
    353366The {\tt setup.py} script installs the tools used for component and waveform development. To install the tools, move into the {\tt tools} directory and run the {\tt setup.py} script as follows \\(optionally, use {\tt su -c "<command>"} instead of {\tt sudo <command>}): 
    354367 
    … …  
    374387********************************************************* 
    375388 
    376   Complete installation of OSSIE 0.7.4 finished! 
     389  Complete installation of OSSIE 0.8.0 finished! 
    377390 
    378391********************************************************* 

  • documentation/ossie/user-guide-0.8.0/UserGuide.tex

    r9623 r9624  
    11% ------------------------------------------------------------------ 
    22% 
    3 %   TITLE: OSSIE Installation and User Guide 0.7.4 
     3%   TITLE: OSSIE Installation and User Guide 0.8.0 
    44% AUTHORS: Matt Carrick, Drew Cormier, Christopher Covington, 
    55%          Carl B. Dietrich, Joseph Gaeddert, Benjamin Hilburn,  
    … …  
    2727errors per burst will be printed out on the screen while the waveform runs.} 
    2828 
    29 \newcommand{\ossieversion}{0.7.4} 
     29\newcommand{\ossieversion}{0.8.0} 
    3030 
    3131%@usepackage{html} 
    … …  
    293293{\tt ossie-\ossieversion/src/system/ossie/idl/python/} directory: 
    294294\begin{lstlisting}[] 
    295  # cd ossie-0.7.4/src/system/ossie/idl/python/ 
     295 # cd ossie-0.8.0/src/system/ossie/idl/python/ 
    296296 # python setup.py install 
    297297\end{lstlisting} 
    … …  
    389389\section{Change Log} 
    390390\label{appendix:changelog} 
     391 
     392\subsection {OSSIE 0.8.0} 
     393\begin{enumerate} 
     394\item CF::FileSystem now encapsulates the Boost file system library 
     395\item Xerces has been replaced by TinyXML 
     396\item The install directory structure has changed to separate Domain management from Device management 
     397\item The nodeBooter and c\_wavLoader utilities support '-debug' level flag and any compatible ORB flags (i.e. -ORBInitRef) 
     398\end{enumerate} 
    391399 
    392400\subsection {OSSIE 0.7.4} 

  • documentation/ossie/user-guide-0.8.0/UserGuide.toc

    r9623 r9624  
    1717\contentsline {subsubsection}{\numberline {3.1.5}Installing Portions of GNU Radio}{9}{subsubsection.3.1.5} 
    1818\contentsline {subsubsection}{\numberline {3.1.6}Install OSSIE}{11}{subsubsection.3.1.6} 
    19 \contentsline {subsubsection}{\numberline {3.1.7}Using Installation Scripts}{11}{subsubsection.3.1.7} 
    20 \contentsline {subsubsection}{\numberline {3.1.8}Updating System Libraries}{12}{subsubsection.3.1.8} 
    21 \contentsline {subsection}{\numberline {3.2}Installation of OSSIE Eclipse Feature}{12}{subsection.3.2} 
     19\contentsline {subsubsection}{\numberline {3.1.7}Using Autoconf}{11}{subsubsection.3.1.7} 
     20\contentsline {subsubsection}{\numberline {3.1.8}Using Installation Scripts}{11}{subsubsection.3.1.8} 
     21\contentsline {subsubsection}{\numberline {3.1.9}Updating System Libraries}{12}{subsubsection.3.1.9} 
     22\contentsline {subsection}{\numberline {3.2}Installation of OSSIE Eclipse Feature}{13}{subsection.3.2} 
    2223\contentsline {subsubsection}{\numberline {3.2.1}Installing Java}{13}{subsubsection.3.2.1} 
    2324\contentsline {subsubsection}{\numberline {3.2.2}Installing Java on Older Versions of Fedora}{13}{subsubsection.3.2.2} 
    2425\contentsline {subsubsection}{\numberline {3.2.3}Installing Java on Ubuntu}{13}{subsubsection.3.2.3} 
    25 \contentsline {subsubsection}{\numberline {3.2.4}Installing Eclipse}{13}{subsubsection.3.2.4} 
     26\contentsline {subsubsection}{\numberline {3.2.4}Installing Eclipse}{14}{subsubsection.3.2.4} 
    2627\contentsline {subsubsection}{\numberline {3.2.5}Installing OEF}{14}{subsubsection.3.2.5} 
    2728\contentsline {subsection}{\numberline {3.3}Using a VMware Image on Any Platform}{14}{subsection.3.3} 
    28 \contentsline {section}{\numberline {4}Running Waveforms}{15}{section.4} 
    29 \contentsline {subsection}{\numberline {4.1}Starting the CORBA Naming Service}{15}{subsection.4.1} 
    30 \contentsline {subsection}{\numberline {4.2}Running {\tt nodeBooter}}{15}{subsection.4.2} 
    31 \contentsline {subsection}{\numberline {4.3}Nodebooter Clean-Up}{15}{subsection.4.3} 
    32 \contentsline {subsection}{\numberline {4.4}Loading a Waveform}{16}{subsection.4.4} 
    33 \contentsline {section}{\numberline {5}Waveform Workshop}{18}{section.5} 
    34 \contentsline {subsection}{\numberline {5.1}OSSIE Eclipse Feature}{18}{subsection.5.1} 
    35 \contentsline {subsection}{\numberline {5.2}OSSIE Waveform Developer}{18}{subsection.5.2} 
    36 \contentsline {subsection}{\numberline {5.3}ALF Graphical Debugging}{19}{subsection.5.3} 
    37 \contentsline {subsection}{\numberline {5.4}WaveDash}{20}{subsection.5.4} 
    38 \contentsline {section}{\numberline {6}OSSIE Eclipse Feature}{21}{section.6} 
    39 \contentsline {subsection}{\numberline {6.1}Creating a New Waveform from Existing Components}{21}{subsection.6.1} 
    40 \contentsline {subsubsection}{\numberline {6.1.1}Adding Components to the Waveform}{23}{subsubsection.6.1.1} 
    41 \contentsline {subsubsection}{\numberline {6.1.2}Connecting Components}{24}{subsubsection.6.1.2} 
    42 \contentsline {subsubsection}{\numberline {6.1.3}Setting the Assembly Controller}{24}{subsubsection.6.1.3} 
    43 \contentsline {subsubsection}{\numberline {6.1.4}Editing Component Properties}{24}{subsubsection.6.1.4} 
    44 \contentsline {subsubsection}{\numberline {6.1.5}Deploying Components to a Node}{25}{subsubsection.6.1.5} 
    45 \contentsline {subsection}{\numberline {6.2}Creating a New Component}{25}{subsection.6.2} 
    46 \contentsline {subsubsection}{\numberline {6.2.1}Adding Ports to the Component}{27}{subsubsection.6.2.1} 
    47 \contentsline {subsubsection}{\numberline {6.2.2}Adding Properties to the Component}{29}{subsubsection.6.2.2} 
    48 \contentsline {subsubsection}{\numberline {6.2.3}Generating the Source Code}{30}{subsubsection.6.2.3} 
    49 \contentsline {subsubsection}{\numberline {6.2.4}Editing C++ Components}{31}{subsubsection.6.2.4} 
    50 \contentsline {subsubsection}{\numberline {6.2.5}Editing Python Components}{31}{subsubsection.6.2.5} 
    51 \contentsline {subsubsection}{\numberline {6.2.6}Editing the SPD File}{32}{subsubsection.6.2.6} 
    52 \contentsline {subsubsection}{\numberline {6.2.7}Making Sure Files are Executable}{32}{subsubsection.6.2.7} 
    53 \contentsline {subsubsection}{\numberline {6.2.8}Installing a Component}{32}{subsubsection.6.2.8} 
    54 \contentsline {subsection}{\numberline {6.3}Importing and Exporting Eclipse Projects}{33}{subsection.6.3} 
    55 \contentsline {subsubsection}{\numberline {6.3.1}Exporting a Project From Eclipse}{33}{subsubsection.6.3.1} 
    56 \contentsline {subsubsection}{\numberline {6.3.2}Importing Project in Eclipse}{34}{subsubsection.6.3.2} 
    57 \contentsline {subsection}{\numberline {6.4}Additional OEF Instruction}{36}{subsection.6.4} 
    58 \contentsline {section}{\numberline {7}OSSIE Waveform Developer}{37}{section.7} 
    59 \contentsline {subsection}{\numberline {7.1}Creating a New Waveform from Existing Components}{37}{subsection.7.1} 
    60 \contentsline {subsubsection}{\numberline {7.1.1}Adding an Existing Node to a Waveform}{37}{subsubsection.7.1.1} 
    61 \contentsline {subsubsection}{\numberline {7.1.2}Adding an Existing Component to a Waveform}{38}{subsubsection.7.1.2} 
    62 \contentsline {subsubsection}{\numberline {7.1.3}Connecting Components}{40}{subsubsection.7.1.3} 
    63 \contentsline {subsubsection}{\numberline {7.1.4}Deploying Components and Editing Component Properties}{41}{subsubsection.7.1.4} 
    64 \contentsline {subsubsection}{\numberline {7.1.5}Setting the Assembly Controller}{43}{subsubsection.7.1.5} 
    65 \contentsline {subsubsection}{\numberline {7.1.6}Generating the Waveform}{44}{subsubsection.7.1.6} 
    66 \contentsline {subsubsection}{\numberline {7.1.7}Installing the Waveform}{45}{subsubsection.7.1.7} 
    67 \contentsline {subsection}{\numberline {7.2}Creating a New Component}{45}{subsection.7.2} 
    68 \contentsline {subsubsection}{\numberline {7.2.1}Adding Ports}{46}{subsubsection.7.2.1} 
    69 \contentsline {subsubsection}{\numberline {7.2.2}Adding Properties}{47}{subsubsection.7.2.2} 
    70 \contentsline {subsubsection}{\numberline {7.2.3}Selecting Component Generation Options}{48}{subsubsection.7.2.3} 
    71 \contentsline {subsubsection}{\numberline {7.2.4}Generating the Source}{48}{subsubsection.7.2.4} 
    72 \contentsline {subsubsection}{\numberline {7.2.5}Building a Working Python Component}{49}{subsubsection.7.2.5} 
    73 \contentsline {subsubsection}{\numberline {7.2.6}Editing the SPD File}{50}{subsubsection.7.2.6} 
    74 \contentsline {subsubsection}{\numberline {7.2.7}Making Sure Files are Executable}{50}{subsubsection.7.2.7} 
    75 \contentsline {subsubsection}{\numberline {7.2.8}Building and Installing the Binaries}{50}{subsubsection.7.2.8} 
    76 \contentsline {subsection}{\numberline {7.3}Custom License Generation}{51}{subsection.7.3} 
    77 \contentsline {subsection}{\numberline {7.4}Removing Components, Devices, Nodes and Waveforms}{51}{subsection.7.4} 
    78 \contentsline {subsubsection}{\numberline {7.4.1}Removal Notes}{51}{subsubsection.7.4.1} 
    79 \contentsline {subsubsection}{\numberline {7.4.2}Component and Device Removal}{52}{subsubsection.7.4.2} 
    80 \contentsline {subsubsection}{\numberline {7.4.3}Node Removal}{52}{subsubsection.7.4.3} 
    81 \contentsline {subsubsection}{\numberline {7.4.4}Waveform Removal}{53}{subsubsection.7.4.4} 
    82 \contentsline {section}{\numberline {8}ALF Graphical Debugging Environment}{54}{section.8} 
    83 \contentsline {subsection}{\numberline {8.1}Running ALF}{54}{subsection.8.1} 
    84 \contentsline {subsection}{\numberline {8.2}Running Waveforms}{55}{subsection.8.2} 
    85 \contentsline {subsection}{\numberline {8.3}Managing Running Waveforms}{55}{subsection.8.3} 
    86 \contentsline {subsection}{\numberline {8.4}ALF Tools}{56}{subsection.8.4} 
    87 \contentsline {subsubsection}{\numberline {8.4.1}The Plot Tool}{57}{subsubsection.8.4.1} 
    88 \contentsline {subsubsection}{\numberline {8.4.2}The write\_to\_file Tool}{58}{subsubsection.8.4.2} 
    89 \contentsline {subsubsection}{\numberline {8.4.3}The Arbitrary Waveform Generator}{58}{subsubsection.8.4.3} 
    90 \contentsline {subsubsection}{\numberline {8.4.4}The Speaker Tool}{58}{subsubsection.8.4.4} 
    91 \contentsline {subsubsection}{\numberline {8.4.5}The Timing Tool}{58}{subsubsection.8.4.5} 
    92 \contentsline {subsubsection}{\numberline {8.4.6}The Connect Tool}{58}{subsubsection.8.4.6} 
    93 \contentsline {subsubsection}{\numberline {8.4.7}The Automation Tool}{59}{subsubsection.8.4.7} 
    94 \contentsline {subsubsection}{\numberline {8.4.8}Automation XML File}{59}{subsubsection.8.4.8} 
    95 \contentsline {section}{\numberline {9}WaveDash}{61}{section.9} 
    96 \contentsline {subsection}{\numberline {9.1}Running Wavedash}{61}{subsection.9.1} 
    97 \contentsline {subsection}{\numberline {9.2} Installing and Un-installing waveforms}{62}{subsection.9.2} 
    98 \contentsline {subsection}{\numberline {9.3}Selecting a Waveform}{63}{subsection.9.3} 
    99 \contentsline {subsection}{\numberline {9.4} Refresh }{64}{subsection.9.4} 
    100 \contentsline {subsection}{\numberline {9.5}GUI Customization}{64}{subsection.9.5} 
    101 \contentsline {subsubsection}{\numberline {9.5.1}Show or Hide Components}{64}{subsubsection.9.5.1} 
    102 \contentsline {subsubsection}{\numberline {9.5.2}Re-arrange components}{66}{subsubsection.9.5.2} 
    103 \contentsline {subsubsection}{\numberline {9.5.3}Show or Hide Properties}{66}{subsubsection.9.5.3} 
    104 \contentsline {subsubsection}{\numberline {9.5.4}Change Property Widget}{67}{subsubsection.9.5.4} 
    105 \contentsline {section}{\numberline {10}Helping With Development}{71}{section.10} 
    106 \contentsline {subsection}{\numberline {10.1}Giving Feedback and Submitting Bugs}{71}{subsection.10.1} 
    107 \contentsline {subsection}{\numberline {10.2}Contributing Code}{71}{subsection.10.2} 
    108 \contentsline {section}{\numberline {11}Troubleshooting}{72}{section.11} 
    109 \contentsline {subsection}{\numberline {11.1}nodeBooter Throws an Exception}{72}{subsection.11.1} 
    110 \contentsline {subsection}{\numberline {11.2}nodeBooter Fails to Resolve `TRANSIENT' NameService}{72}{subsection.11.2} 
    111 \contentsline {subsection}{\numberline {11.3}OWD Component Editor Does Not Allow me to Select the Device}{72}{subsection.11.3} 
    112 \contentsline {section}{Appendices}{74}{section*.3} 
    113 \contentsline {section}{\numberline {A}Managing Services on Fedora Core 9}{74}{section.A} 
    114 \contentsline {section}{\numberline {B}Creating {\tt omniNames.sh}}{74}{section.B} 
    115 \contentsline {section}{\numberline {C}Configuring {\tt ossie.pth}}{76}{section.C} 
    116 \contentsline {section}{\numberline {D}Data Source Component Creation}{77}{section.D} 
    117 \contentsline {section}{\numberline {E}Known Bugs}{79}{section.E} 
    118 \contentsline {subsection}{\numberline {E.1}OSSIE Core Framework}{79}{subsection.E.1} 
    119 \contentsline {subsection}{\numberline {E.2}OWD}{79}{subsection.E.2} 
    120 \contentsline {subsection}{\numberline {E.3}ALF}{79}{subsection.E.3} 
    121 \contentsline {subsection}{\numberline {E.4}OEF}{80}{subsection.E.4} 
    122 \contentsline {subsection}{\numberline {E.5}WaveDash}{80}{subsection.E.5} 
    123 \contentsline {section}{\numberline {F}List of Abbreviations}{81}{section.F} 
    124 \contentsline {section}{\numberline {G}Change Log}{83}{section.G} 
    125 \contentsline {subsection}{\numberline {G.1}OSSIE 0.7.4}{83}{subsection.G.1} 
    126 \contentsline {subsection}{\numberline {G.2}OSSIE 0.7.3}{83}{subsection.G.2} 
    127 \contentsline {subsection}{\numberline {G.3}OSSIE 0.7.2}{83}{subsection.G.3} 
    128 \contentsline {subsection}{\numberline {G.4}OSSIE 0.7.1}{83}{subsection.G.4} 
    129 \contentsline {subsection}{\numberline {G.5}OSSIE 0.7.0}{84}{subsection.G.5} 
     29\contentsline {section}{\numberline {4}Running Waveforms}{16}{section.4} 
     30\contentsline {subsection}{\numberline {4.1}Starting the CORBA Naming Service}{16}{subsection.4.1} 
     31\contentsline {subsection}{\numberline {4.2}Running {\tt nodeBooter}}{16}{subsection.4.2} 
     32\contentsline {subsection}{\numberline {4.3}Nodebooter Clean-Up}{16}{subsection.4.3} 
     33\contentsline {subsection}{\numberline {4.4}Loading a Waveform}{17}{subsection.4.4} 
     34\contentsline {section}{\numberline {5}Waveform Workshop}{19}{section.5} 
     35\contentsline {subsection}{\numberline {5.1}OSSIE Eclipse Feature}{19}{subsection.5.1} 
     36\contentsline {subsection}{\numberline {5.2}OSSIE Waveform Developer}{19}{subsection.5.2} 
     37\contentsline {subsection}{\numberline {5.3}ALF Graphical Debugging}{20}{subsection.5.3} 
     38\contentsline {subsection}{\numberline {5.4}WaveDash}{21}{subsection.5.4} 
     39\contentsline {section}{\numberline {6}OSSIE Eclipse Feature}{22}{section.6} 
     40\contentsline {subsection}{\numberline {6.1}Creating a New Waveform from Existing Components}{22}{subsection.6.1} 
     41\contentsline {subsubsection}{\numberline {6.1.1}Adding Components to the Waveform}{24}{subsubsection.6.1.1} 
     42\contentsline {subsubsection}{\numberline {6.1.2}Connecting Components}{25}{subsubsection.6.1.2} 
     43\contentsline {subsubsection}{\numberline {6.1.3}Setting the Assembly Controller}{25}{subsubsection.6.1.3} 
     44\contentsline {subsubsection}{\numberline {6.1.4}Editing Component Properties}{25}{subsubsection.6.1.4} 
     45\contentsline {subsubsection}{\numberline {6.1.5}Deploying Components to a Node}{26}{subsubsection.6.1.5} 
     46\contentsline {subsection}{\numberline {6.2}Creating a New Component}{26}{subsection.6.2} 
     47\contentsline {subsubsection}{\numberline {6.2.1}Adding Ports to the Component}{28}{subsubsection.6.2.1} 
     48\contentsline {subsubsection}{\numberline {6.2.2}Adding Properties to the Component}{30}{subsubsection.6.2.2} 
     49\contentsline {subsubsection}{\numberline {6.2.3}Generating the Source Code}{31}{subsubsection.6.2.3} 
     50\contentsline {subsubsection}{\numberline {6.2.4}Editing C++ Components}{32}{subsubsection.6.2.4} 
     51\contentsline {subsubsection}{\numberline {6.2.5}Editing Python Components}{32}{subsubsection.6.2.5} 
     52\contentsline {subsubsection}{\numberline {6.2.6}Editing the SPD File}{33}{subsubsection.6.2.6} 
     53\contentsline {subsubsection}{\numberline {6.2.7}Making Sure Files are Executable}{33}{subsubsection.6.2.7} 
     54\contentsline {subsubsection}{\numberline {6.2.8}Installing a Component}{33}{subsubsection.6.2.8} 
     55\contentsline {subsection}{\numberline {6.3}Importing and Exporting Eclipse Projects}{34}{subsection.6.3} 
     56\contentsline {subsubsection}{\numberline {6.3.1}Exporting a Project From Eclipse}{34}{subsubsection.6.3.1} 
     57\contentsline {subsubsection}{\numberline {6.3.2}Importing Project in Eclipse}{35}{subsubsection.6.3.2} 
     58\contentsline {subsection}{\numberline {6.4}Additional OEF Instruction}{37}{subsection.6.4} 
     59\contentsline {section}{\numberline {7}OSSIE Waveform Developer}{38}{section.7} 
     60\contentsline {subsection}{\numberline {7.1}Creating a New Waveform from Existing Components}{38}{subsection.7.1} 
     61\contentsline {subsubsection}{\numberline {7.1.1}Adding an Existing Node to a Waveform}{38}{subsubsection.7.1.1} 
     62\contentsline {subsubsection}{\numberline {7.1.2}Adding an Existing Component to a Waveform}{39}{subsubsection.7.1.2} 
     63\contentsline {subsubsection}{\numberline {7.1.3}Connecting Components}{41}{subsubsection.7.1.3} 
     64\contentsline {subsubsection}{\numberline {7.1.4}Deploying Components and Editing Component Properties}{42}{subsubsection.7.1.4} 
     65\contentsline {subsubsection}{\numberline {7.1.5}Setting the Assembly Controller}{44}{subsubsection.7.1.5} 
     66\contentsline {subsubsection}{\numberline {7.1.6}Generating the Waveform}{45}{subsubsection.7.1.6} 
     67\contentsline {subsubsection}{\numberline {7.1.7}Installing the Waveform}{46}{subsubsection.7.1.7} 
     68\contentsline {subsection}{\numberline {7.2}Creating a New Component}{46}{subsection.7.2} 
     69\contentsline {subsubsection}{\numberline {7.2.1}Adding Ports}{47}{subsubsection.7.2.1} 
     70\contentsline {subsubsection}{\numberline {7.2.2}Adding Properties}{48}{subsubsection.7.2.2} 
     71\contentsline {subsubsection}{\numberline {7.2.3}Selecting Component Generation Options}{49}{subsubsection.7.2.3} 
     72\contentsline {subsubsection}{\numberline {7.2.4}Generating the Source}{49}{subsubsection.7.2.4} 
     73\contentsline {subsubsection}{\numberline {7.2.5}Building a Working Python Component}{50}{subsubsection.7.2.5} 
     74\contentsline {subsubsection}{\numberline {7.2.6}Editing the SPD File}{51}{subsubsection.7.2.6} 
     75\contentsline {subsubsection}{\numberline {7.2.7}Making Sure Files are Executable}{51}{subsubsection.7.2.7} 
     76\contentsline {subsubsection}{\numberline {7.2.8}Building and Installing the Binaries}{51}{subsubsection.7.2.8} 
     77\contentsline {subsection}{\numberline {7.3}Custom License Generation}{52}{subsection.7.3} 
     78\contentsline {subsection}{\numberline {7.4}Removing Components, Devices, Nodes and Waveforms}{52}{subsection.7.4} 
     79\contentsline {subsubsection}{\numberline {7.4.1}Removal Notes}{52}{subsubsection.7.4.1} 
     80\contentsline {subsubsection}{\numberline {7.4.2}Component and Device Removal}{53}{subsubsection.7.4.2} 
     81\contentsline {subsubsection}{\numberline {7.4.3}Node Removal}{53}{subsubsection.7.4.3} 
     82\contentsline {subsubsection}{\numberline {7.4.4}Waveform Removal}{54}{subsubsection.7.4.4} 
     83\contentsline {section}{\numberline {8}ALF Graphical Debugging Environment}{55}{section.8} 
     84\contentsline {subsection}{\numberline {8.1}Running ALF}{55}{subsection.8.1} 
     85\contentsline {subsection}{\numberline {8.2}Running Waveforms}{56}{subsection.8.2} 
     86\contentsline {subsection}{\numberline {8.3}Managing Running Waveforms}{56}{subsection.8.3} 
     87\contentsline {subsection}{\numberline {8.4}ALF Tools}{57}{subsection.8.4} 
     88\contentsline {subsubsection}{\numberline {8.4.1}The Plot Tool}{58}{subsubsection.8.4.1} 
     89\contentsline {subsubsection}{\numberline {8.4.2}The write\_to\_file Tool}{59}{subsubsection.8.4.2} 
     90\contentsline {subsubsection}{\numberline {8.4.3}The Arbitrary Waveform Generator}{59}{subsubsection.8.4.3} 
     91\contentsline {subsubsection}{\numberline {8.4.4}The Speaker Tool}{59}{subsubsection.8.4.4} 
     92\contentsline {subsubsection}{\numberline {8.4.5}The Timing Tool}{59}{subsubsection.8.4.5} 
     93\contentsline {subsubsection}{\numberline {8.4.6}The Connect Tool}{59}{subsubsection.8.4.6} 
     94\contentsline {subsubsection}{\numberline {8.4.7}The Automation Tool}{60}{subsubsection.8.4.7} 
     95\contentsline {subsubsection}{\numberline {8.4.8}Automation XML File}{60}{subsubsection.8.4.8} 
     96\contentsline {section}{\numberline {9}WaveDash}{62}{section.9} 
     97\contentsline {subsection}{\numberline {9.1}Running Wavedash}{62}{subsection.9.1} 
     98\contentsline {subsection}{\numberline {9.2} Installing and Un-installing waveforms}{63}{subsection.9.2} 
     99\contentsline {subsection}{\numberline {9.3}Selecting a Waveform}{64}{subsection.9.3} 
     100\contentsline {subsection}{\numberline {9.4} Refresh }{65}{subsection.9.4} 
     101\contentsline {subsection}{\numberline {9.5}GUI Customization}{65}{subsection.9.5} 
     102\contentsline {subsubsection}{\numberline {9.5.1}Show or Hide Components}{65}{subsubsection.9.5.1} 
     103\contentsline {subsubsection}{\numberline {9.5.2}Re-arrange components}{67}{subsubsection.9.5.2} 
     104\contentsline {subsubsection}{\numberline {9.5.3}Show or Hide Properties}{67}{subsubsection.9.5.3} 
     105\contentsline {subsubsection}{\numberline {9.5.4}Change Property Widget}{68}{subsubsection.9.5.4} 
     106\contentsline {section}{\numberline {10}Helping With Development}{72}{section.10} 
     107\contentsline {subsection}{\numberline {10.1}Giving Feedback and Submitting Bugs}{72}{subsection.10.1} 
     108\contentsline {subsection}{\numberline {10.2}Contributing Code}{72}{subsection.10.2} 
     109\contentsline {section}{\numberline {11}Troubleshooting}{73}{section.11} 
     110\contentsline {subsection}{\numberline {11.1}nodeBooter Throws an Exception}{73}{subsection.11.1} 
     111\contentsline {subsection}{\numberline {11.2}nodeBooter Fails to Resolve `TRANSIENT' NameService}{73}{subsection.11.2} 
     112\contentsline {subsection}{\numberline {11.3}OWD Component Editor Does Not Allow me to Select the Device}{73}{subsection.11.3} 
     113\contentsline {section}{Appendices}{75}{section*.3} 
     114\contentsline {section}{\numberline {A}Managing Services on Fedora Core 9}{75}{section.A} 
     115\contentsline {section}{\numberline {B}Creating {\tt omniNames.sh}}{75}{section.B} 
     116\contentsline {section}{\numberline {C}Configuring {\tt ossie.pth}}{77}{section.C} 
     117\contentsline {section}{\numberline {D}Data Source Component Creation}{78}{section.D} 
     118\contentsline {section}{\numberline {E}Known Bugs}{80}{section.E} 
     119\contentsline {subsection}{\numberline {E.1}OSSIE Core Framework}{80}{subsection.E.1} 
     120\contentsline {subsection}{\numberline {E.2}OWD}{80}{subsection.E.2} 
     121\contentsline {subsection}{\numberline {E.3}ALF}{80}{subsection.E.3} 
     122\contentsline {subsection}{\numberline {E.4}OEF}{81}{subsection.E.4} 
     123\contentsline {subsection}{\numberline {E.5}WaveDash}{81}{subsection.E.5} 
     124\contentsline {section}{\numberline {F}List of Abbreviations}{82}{section.F} 
     125\contentsline {section}{\numberline {G}Change Log}{84}{section.G} 
     126\contentsline {subsection}{\numberline {G.1}OSSIE 0.8.0}{84}{subsection.G.1} 
     127\contentsline {subsection}{\numberline {G.2}OSSIE 0.7.4}{84}{subsection.G.2} 
     128\contentsline {subsection}{\numberline {G.3}OSSIE 0.7.3}{84}{subsection.G.3} 
     129\contentsline {subsection}{\numberline {G.4}OSSIE 0.7.2}{85}{subsection.G.4} 
     130\contentsline {subsection}{\numberline {G.5}OSSIE 0.7.1}{85}{subsection.G.5} 
     131\contentsline {subsection}{\numberline {G.6}OSSIE 0.7.0}{85}{subsection.G.6}