Apt-Cacher NG Command And Control Page

Apt-Cacher NG maintenance page for ${hostname}

## Transfer statistics

| Since startup | Recent history
Data fetched: | ${dataInHuman} | ${dataHistInHuman}
Data served: | ${dataOutHuman} | ${dataHistOutHuman}

### Log analysis

Period | Cache efficiency
| Requests |  | Data
| Hits | Misses | Total |  | Hits | Misses | Total
${statsRow}

Note: data table is created based on the current log file. Deviation from real request count is possible due to previous log file optimization.

## Configuration instructions

Please visit any invalid download URL to see configuration instructions for users. For system administrators, read the manual (or see system documentation online resp. in the local filesystem).

## Shared processing options

Temporary options for the general behavour and index update configuration can set in this user interface. They are only relevant to expiration and import features triggered below.
Stop the work on errors during index update step
More verbosity
Force the download of index files (even having fresh ones)
Don't update index files (DANGEROUS for expiration tasks!)

## Expiration

Expiration mechanism is needed to delete files from the local cache when they are removed on the servers, e.g. when the software versions of the package is updated and the package files are replaced. This is rarely needed when Stable system distribution is used by the clients, but use of unstable branches with high fluctuation requires to clean up the local cache from time to time. ACNG includes helper code to identify unreferenced files automatically and optionally check the cache and verify data against file information in the index files, where available.

### Scan and semi-automatic expiration

The default method does update the index files, check the files present in the cache and optionally delete them. The checks consist of file name comparison and optionally file contents verification or directory location comparison. Files that are not listed in any index file or have incorrect contents are marked for removal in one of the later sessions, or can be removed by direct user action triggered with the controls below.

Ignore the threshold that aborts early when there is probably not much to do
Skip header checks (faster, not detecting bad metadata)
Validate by file name AND file directory (use with care),
then validate file contents through checksum (SLOW), also detecting corrupt files,
then truncate damaged files immediately.
Treat incomplete files as damaged.
Purge unreferenced files immediately after scan

### Direct actions

## Import

Importing package files from foreign sources works in following case:

Files can be assigned to known download locations. The locations become known when they are found in index files. However, this index files must exist in the package cache, therefore at least one client needs to download them, i.e. running "apt-get update" on a client system which is configured for use with ACNG. See ACNG manual for more details.

When all conditions are met put your files into the "_import" directory, e.g. /var/cache/apt-cacher-ng/_import/. Subdirectories and symlinks are ok. Then run import.

## Guided precaching (Mirroring)

Apt-Cacher NG supports a massive download of package files referenced in a specified set of index files. This is configured with the PrecacheFor configuration option (see config examples and manual for details).

In special cases this feature can be used to create a local partial mirror where the cache internal structure of packages mostly represents the contents of the remote package archive and includes everything apt might want to download.

Calculate and display download size
Download package files
Restrict to packages related to previously cached files
Use Debdelta if possible (experimental)

## File Type Pattern Tracing

This section provides a simple tool useful to identify new file name patterns which might be needed to configuration in order to handle new file types correctly. Please provide your findings to apt-cacher-ng author if they might be useful for other users. Current value of pattern extensions:

    SPfilePatternEx: ${cfg:SPfilePatternEx}
    VfilePatternEx: ${cfg:VfilePatternEx}
    PfilePatternEx: ${cfg:PfilePatternEx}

Current mode: Active (watching download activity) not tracing

Currently collected file paths not covered by the configured patterns:

    ${curPatTraceCol}

${footer}