Contents

Introduction
Contents
Copyright
1. Changes

1.1. Changes in V4.1
1.2. Changes in V4.0

2. Overview

2.1. Architecture

2.1.1. Supervisor process
2.1.2. Data collection
2.1.3. Charging process
2.1.4. Summarisation process
2.1.5. Route file generation
2.1.6. User defined processing

2.2. Example configuration

2.2.1. Topology definition
2.2.2. Rating and charging
2.2.3. Data source
2.2.4. Reporting
2.2.5. Host definition

2.3. Running ipacc

3. Configuration file

3.1. Syntax
3.2. Blocks
3.3. Include files
3.4. Symbol substitution
3.5. Lexical control: if / else if / else / end if
3.6. Common parameter types

3.6.1. Quantity specifications
3.6.2. Interval specifications
3.6.3. Time-based file names

4. Topology and charging

4.1. Network topology

4.1.1. Defining networks: the ip statement
4.1.2. Defining topology: the group and dynamic statements

4.2. Traffic types: protocols and type of service

4.2.1. Defining protocols: the protocols statement
4.2.2. Type of service: the phb statement

4.3. Rating

4.3.1. Rating by time: the time statement
4.3.2. Rating by protocol: the service statement
4.3.3. Rating by per-hop behaviour: the diffserv statement

4.4. Charging

5. Data sources

5.1. General parameters

5.1.1. Ring buffers and daemons
5.1.2. Placing source in topology
5.1.3. Router login parameters
5.1.4. Aging collected data
5.1.5. Debugging information
5.1.6. Dynamic addressing

5.2. Cisco NetFlow

5.2.1. Setting up NetFlow on a Cisco router
5.2.2. Configuring NetFlow collection

5.3. Berkeley Packet Filter (BPF)

5.3.1. Setting up BPF on BSD systems
5.3.2. Configuring BPF collection
5.3.3. Flow cache tuning

5.4. Packet Capture Library (libpcap)

5.4.1. Configuring libpcap collection

5.5. Cisco ip accounting

5.5.1. Setting up ip accounting on a Cisco router
5.5.2. Configuring ip accounting collection

6. Reporting

6.1. Fields
6.2. Data sources, selection and summarisation

6.2.1. Data sources: the sources statement
6.2.2. Summarisation: the key statement
6.2.3. Data selection: the include statement

6.3. Counting and sorting

6.3.1. Adding counters: the counter statement
6.3.2. Sorting output: the sort statement

6.4. Data formatting

6.4.1. Output formatting: the header, trailer and format statements
6.4.2. Date and time format, the dateformat and timeformat statements

6.5. Output disposition

6.5.1. Output file: the file statement
6.5.2. Output post-processing: the postprocess and postprocess-file statements

7. Configuration file generation

7.1. Extracting routing information: the route-file block

7.1.1. Routing sources
7.1.2. Route filtering/selection
7.1.3. Filtering existing IP list
7.1.4. Timing

7.2. Generating files: the generate block

8. Per-host and miscellaneous configuration

8.1. Assigning functions: the host block

8.1.1. Collector daemons: the daemon statement
8.1.2. Binding scheduled objects to host: the process statement
8.1.3. Distributing files: the provide and require statements
8.1.4. Connectivity to other hosts: the connect statement

8.2. Scheduling: the frequency statement
8.3. Logging: the log statement

9. Advanced configuration

9.1. Dynamic IP addressing

9.1.1. Dynamic file format
9.1.2. Configuring dynamic addressing

Appendix A. Configuration File Reference
Appendix B. The ipacc control program
Appendix C. Ancillary programs

C.1. ipacc-password
C.2. ipacc-agedynamic

Appendix D. Software installation

D.1. Compiling ipacc from source
D.2. Extracting ipacc binaries
D.3. Running the installation procedure
D.4. Preparing the configuration
D.5. Starting ipacc
D.6. Disabling ipacc from system startup

Appendix E. Miscellaneous topics

E.1. strftime(3) format specifiers
E.2. libpcap filter expressions
E.3. Regular expressions

Index