Installation

Installing the catalog

Enabling the catalog

The aliens Catalog is provided in the phyglos.org repository but it is not enabled by default for the BANDIT.

The BANDIT default configuration already points to two repositories: the localhost repository and the phyglos.org repository, therefore in order to use the aliens Catalog the bandit.conf file has to be updated to enable the aliens catalog.

Update the bandit.org repository list

To enable the catalog, edit the BANDIT main configuration:

$ bandit edit

and add the catalog in the list of enabled catalogs:

## Enabled catalogs
BANDIT_CATALOG_LIST=(
    localhost
    phyglos-latest
    aliens-latest
)

Check the repositories and catalogs

After enabling the catalog, you can check its availabiity with the bandit search command:

$ bandit search -rc all

Repositories (enabled):
  [localhost]
  [phyglos.org]
Repositories (available):
  none
Catalogs (enabled):
  [local]
  [phyglos-latest]
  [aliens-latest]
Catalogs (available):
  [local]
  [phyglos-latest]
  [aliens-latest]

Update the phyglos.org repository manifest

In order to use the latest release of the catalog, update first the repository manifest:

$ bandit -r phyglos.org update

...fetching repository manifest from mirror ftp://phyglos.org/mirror...
...installing...

Update the phyglos catalog

Once the phyglos.org repository manifest is updated, the catalog can be downloaded and installed with the bandit -c <catalog> commands:

$ bandit -c aliens-latest download
...downloading...
$ bandit -c aliens-latest install
...installing...

Note

The specific release of the catalog neeeds to be provided if the catalog is distributed in a versioned way.

Updating the catalog

In order to update a catalog, a new release has to be downloaded from the repository. Update the repository manifest before attempting to update the catalog and then download the new release. This can be achieved with a single command, instructing the BANDIT to update the catalogs when a repository is updated:

$ bandit -r phyglos.org update --all

...fetching repository manifest from mirror ftp://phyglos.org/mirror...
...fetching catalog phyglos-latest from mirror ftp://phyglos.org/mirror...
...installing repository manifest...
...fetching catalog phyglos-latest from catalogs cache ...
...installing...
...fetching catalog aliens-latest from catalogs cache ...
...installing...

Warning

Updating the catalog can clobber any changes made to the configuration files of the bundles in that catalog. Always copy a bundle to the localhost catalog in order to customize any bundle from a distributed catalog.

Removing the catalog

A catalog can be removed with the bandit -c <catalog> remove command:

$ bandit -c aliens-latest remove
...removing...