Changeset 8403

Timestamp:

10/31/08 15:58:20 (5 years ago)

Author:

mcarrick

Message:

added nodebooter clean up section

Files:

• documentation/ossie/user-guide-0.7.0/RunningWaveforms.tex (modified) (1 diff)

documentation/ossie/user-guide-0.7.0/RunningWaveforms.tex

@@ -28 +28 @@
 because nodeBooter uses paths that are defined relatively to the directory in
 which it is run.
+
+\subsection{Nodebooter Clean-Up}
+If a waveform crashes or is uninstalled incorrectly, Nodebooter will not be
+able to shut down all of the processes that it starts. This is currently 
+being addressed by the development team, however in the interim the processes
+must be stopped by hand. To find which processes were not stopped, enter the 
+following command:
+\begin{lstlisting}[]
+ $ ps -e
+\end{lstlisting}
+
+This will list all of the currently running processes. Processes with the names
+of components or devices that are in the waveform need to be shutdown. To stop
+a process, enter the following command:
+\begin{lstlisting}[]
+ $ killall USRP GPP <MORE-DEVICES> TxDemo Decimator <MORE-COMPONENTS>
+\end{lstlisting}
+
+If the USRP node (default\_GPP\_USRP\_sound\_node) cannot be started, this is
+typically resolved by killing the USRP, soundCardPlayback and soundCardCapture
+devices.
+
+To make this process faster, create a script to kill all of the processes created
+by a certain waveform. For example, create a text file called {\tt killOSSIEDemo}.
+\begin{lstlisting}[]
+ $ cd ~
+ $ vim killOSSIEDemo
+\end{lstlisting}
+
+In this text file, press {\tt i} to insert text and enter the following on a single 
+line:
+\begin{lstlisting}[]
+ killall GPP TxDemo ChannelDemo RxDemo
+\end{lstlisting}
+
+Press {\tt <ESC>}, {\tt :wq}, and then {\tt <ENTER>} to save the file and exit. Now 
+change the permissions so the script can be executed.
+
+\begin{lstlisting}[]
+ $ chmod +x killOSSIEDemo
+\end{lstlisting}
+
+Now the script has been created and can be run by entering the command:
+\begin{lstlisting}[]
+ $ ./killOSSIEDemo
+\end{lstlisting}
+
+If not all processes within the script are running a warning will be printed stating 
+that the process has not been killed, which is fine.
+
 
 \subsection{Loading a Waveform}