1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109
|
****
INSTALLATION INSTRUCTIONS FOR IPTRAF 2.1
****
IMPORTANT: READ THE SYSTEM REQUIREMENTS SECTION IN THE README. IPTRAF 2
REQUIRES LINUX 2.2 OR LATER.
IMPORTANT: THIS VERSION HAS A "make upgrade" PROCEDURE. SEE BELOW.
The package already comes with precompiled i386 executables. It should
work with no problems on most distributions. You can install the software
by issuing a "cd src" then "make install" at the shell prompt.
Do not skip the "make install". This step also creates the necessary
directories the program is going to use.
UPGRADING FROM 2.0.x or 1.4.x
IPTraf 1.4.x and 2.0.x had a filename parsing bug that caused the filter
data files to be placed in the wrong directory with the wrong names. This
version corrects it. If you're using TCP or UDP filters, perform a "make
upgrade" before running the program. This step will place the filter data
files in the correct place with the right names.
DEALING WITH "ERROR OPENING TERMINAL"
The precompiled executable program comes linked with ncurses 4.2. ncurses
4.2 needs to determine your terminal capabilities from the terminfo
database in /usr/share/terminfo. If the supplied program fails with
"Error opening terminal", check this directory. If it doesn't exist, your
terminfo database may be somewhere else. To override the default terminfo
search path, you can use the TERMINFO environment variable. Supposing
your terminfo is in /usr/lib/terminfo (typical for Slackware
distributions)
TERMINFO=/usr/lib/terminfo
export TERMINFO
You may want to place these commands in your login initialization files
(/etc/profile or ~/.profile for sh/bash).
You can also create a symbolic link /usr/share/terminfo to point to
your existing terminfo database. For example, given the same conditions
above:
ln -s /usr/lib/terminfo /usr/share/terminfo
Or, as an alternative, you can simply recompile your program to use your
ncurses installation. Be sure you have at least ncurses 1.9.9e. See
section on recompiling below.
UPGRADING FROM 2.0.x
There are no major changes in the file formats, except for the addition of
a "Non-IP" filter option. We can't be sure as to what this setting will
be after the upgrade. Just set it to whatever you want before you start
the IP traffic monitor.
UPGRADING FROM 1.3.0
The MAC address database files are now in text format. If you have MAC
address descriptions, do a "make upgrade" right after the installation.
This converts the binary pre-1.4 MAC address files to text format.
The configuration file also contains an additional option to select
between kbits/s and kbytes/s in activity indicators. The file size hasn't
changed, but upon running the new version, just verify and set this
parameter according to your preference. "make upgrade" will not touch the
configuration file.
UPGRADING FROM VERSION 1.2.0
If you're upgrading from version 1.2.0, and you've defined additional
higher-numbered ports for the TCP/UDP service monitor, you must run the
cfconv program (or do the "make upgrade") from the 1.3.0 package. This is
not necessary if you don't have any additional ports defined. The
configuration and filter file formats did not change from 1.2.0 to 1.3.0
UPGRADING FROM VERSION 1.1.0
The configuration and filter file formats changed from version 1.1.0 to
1.2.0. If you're upgrading directly from 1.1.0, do the "make upgrade"
step for 1.2.0 first (compile if necessary). Then do the upgrade from
1.2.0 described above.
RECOMPILATION
Should you wish to recompile the program (perhaps to reduce the size of the
binary by letting it use the shared versions of the ncurses and panels
libraries), you will need these:
1. Kernel 2.0.0 or later, with sources decompressed in
/usr/src/linux. Earlier versions may still work, but cannot
be confirmed. Kernel 2.0.34 or higher is recommended.
2. ncurses 1.9.9e or later. Earlier versions have undesirable
keystroke and overlapping window refresh behavior.
3. gcc 2.7.0 or later.
To compile, just cd to the src directory and type "make" at the shell
prompt. You may want to edit the Makefile to tweak some options before
you compile. There should be no errors.
The distribution binary was compiled with GCC 2.7.2.3, and linked with
ncurses 4.2
See the README file and the manual for more information.
|