%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %deffont "normal" xfont "times" %deffont "typewriter" xfont "courier new-r" %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %default 1 area 90 90, leftfill, size 2, fore "black", back "white" %default 2 size 7, vgap 10, prefix " " %default 3 size 2, bar "gray70", vgap 10 %default 4 size 5, fore "black", vgap 30, prefix " " %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %tab 1 size 5, vgap 40, prefix " ", icon box "black" 40 %tab 2 size 4, vgap 40, prefix " ", icon arc "black" 50 %tab 3 size 3, vgap 40, prefix " ", icon delta3 "black" 40 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Agenda %size 4 Introduction Architecture of AFD %size 6 Compiling %size 4 Setting up AFD Graphical User Interface Configuration by examples Evaluating Log Data Performance and other considerations %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Compiling Requirements for compiling AFD Possible configuration Parameters Creating RPM Exercise %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Requirements for compiling AFD AFD only works with UNIX or MacOS (the newer ones based on Unix) AFD has been run successful under the following Unix flavors: Linux, Solaris, HP-UX, Irix, Aix, FTX and SCO One can compile AFD under Windows with the help of cygwin, but it does not run. (Last try approx. 2 years ago) What works is Microsoft Unix subsystem INTERIX (http://en.wikipedia.org/wiki/Interix). With it AFD runs. However, it seems that Microsoft has ceased development of Interix. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Requirements for compiling AFD Since AFD is written in C it needs a C compiler with all the headers. Here follows what needs to be done for the different Linux distributions to get AFD compiled with graphical user interface : Ubuntu sudo apt-get install gcc make libmotif-dev libssl-dev libx11-dev libxt-dev libxpm-dev libxaw7-dev RedHat/CentOS/Scientific Linux: su - yum install gcc openmotif-devel openssl-devel libXaw-devel libXpm-devel %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Requirements for compiling AFD Fedora su - yum localinstall --nogpgcheck http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-stable.noarch.rpm http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-stable.noarch.rpm yum install gcc openmotif-devel openssl-devel libXaw-devel libXpm-devel SuSE su - zypper install gcc make openmotif-devel libopenssl-devel MacOS For gcc download and install the Apple development environment https://developer.apple.com/xcode/. In XCode, install the optional components "command line tools" from the "Downloads" preference pane, then gcc is available on the Mac. For X11 install XQuartz http://xquartz.macosforge.org/landing/ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Possible configuration Parameters Before one wants to compile AFD one needs to configure it. This can be done via the configure script in the AFD source directory src. If one calls ./configure with the parameter --help it list all possible parameters. Here follows a list of the most important parameters: %font "typewriter", size 3 --prefix= The directory where you wish to install AFD. Default will be /usr/local. --enable-ssl Enabling this will add HTTPS and FTPS support, TLS/SSL support for HTTP and FTP. Default is NOT enabled. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Possible configuration Parameters (continued) %font "typewriter", size 3 --with-gui=none If you do not need the graphical user interface or you do not manage to compile AFD because of the GUI. Default GUI is Motif. --enable-afd_mon This compiles the AFD monitor, the program to monitor other AFD's. --enable-compiler-debug This will compile AFD with debug information. It will be useful if there is a bug and AFD crashes and creates core files (coredumps). It will then give the programmer more information where the error is. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Possible configuration Parameters (continued) There are also many configure parameters that allows one to disable certain features of AFD: %font "typewriter", size 3 --disable-http_support --disable-smtp_support --disable-sftp_support --disable-ftp_support --disable-wmo_support --disable-loc_support --disable-input_log --disable-distribution_log --disable-production_log --disable-output_log --disable-delete_log %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Possible configuration Parameters (continued) A full list and description of each configure parameters can be found in the file README.configure that comes with the tar file of AFD. There are a lot more options to configure AFD when one changes the C header files in AFD source code. The two most important ones are src/afdsetup.h and src/init_afd/afddefs.h. If you do any changes here you most likely need to reinitialize the internal database. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Creating RPM Big advantage of having AFD as an RPM is that it does nearly everything for you when you upgrade to a newer version (stop AFD before the update and then start it again, removes any unneeded binaries). It also provides and installs all necessary boot scripts. %font "typewriter", size 4 /etc/init.d/afd /etc/init.d/afdmon /etc/sysconfig/afd /etc/sysconfig/afdmon %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Creating RPM (continued) Providing you have all the tools to generate an RPM, it is actually very easy to create one. After issuing the configure command above, one just needs to issue the following command: %font "typewriter", size 4 make rpm %font "normal" Or you can build it from the source RPM (SRPM). The command to do this under root on a Fedora/RedHat/CentOS/Scientific Linux are: %font "typewriter", size 4 rpm -Uvh afd-1.4.5-0.3.beta.el6.src.rpm rpmbuild -ba ~/rpmbuild/SPECS/afd.spec %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Exercise WLAN ACCESS SSID: holger.kiehl@dwd.de PWD : afdturkey Virtual Training Systems ubuntu 192.168.123.234 redhat 192.168.123.158 fedora 192.168.123.152 suse 192.168.123.218 Users usr1 Password:afdusr1 ......... usr9 Password:afdusr9 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %page Exercise Build and install AFD from source. %font "typewriter", size 3 cd tar xf /usr/local/src/afd-1.4.5-0.3.beta.tar cd afd-1.4.5-0.3.beta ./configure --prefix=$HOME --enable-ssl --enable-afd_mon make make install