Skip to main content

Install, update and archive installations of icemac.addressbook.

Project description

icemac.install.addressbook

Scripts to ease the installation and update an existing installation of icemac.addressbook to a new version of the package.

Installation of the scripts

Install the package icemac.install.addressbook using pip:

$ pip install icemac.install.addressbook

This creates two scripts in the bin directory:

  • install-addressbook

  • archive-addressbook

Usage

install-addressbook

Start the script using:

$ bin/install-addressbook [VERSION_NUMBER]

Where VERSION_NUMBER is the number of the version you want to install resp. you want to update to. If you leave it out the newest version is used.

The script executes the following steps:

  1. Download the source distribution of icemac.addressbook to a temporary directory.

  2. Extract the source distribution to the current working directory.

  3. Run the install script. If there is a symlink named current pointing to a previous icemac.addressbook installation it uses its configuration as default answers for the questions in the installation process.

  4. Create or replace the new symlink named current pointing to the new installation.

make-current-addressbook

This script is helpful if you want to switch back to an older installed address book version in case of an error.

Start the script using:

$ bin/make-current-addressbook VERSION_NUMBER

Where VERSION_NUMBER is the number of the version you want to make the current one.

The script executes the following steps:

  1. Create or replace the new symlink named current pointing to the new installation.

archive-addressbook

After installing a new version of the address book you could archive the previous one using this script.

Start the script using:

$ bin/archive-addressbook 4.1

Where 4.1 is the version number of the installation you want to archive.

The script executes the following steps:

  1. Create an archive of the requested icemac.addressbook installation (as installed by install-addressbook) in a directory named archive. (The archive directory is created if it not yet exists.)

  2. Delete the requested icemac.addressbook installation.

Hacking

  • Clone the repository:

    $ git clone https://github.com/icemac/icemac.install.addressbook
  • Create a virtualenv, install the installer and run it:

    $ cd icemac.install.addressbook
    $ virtualenv-2.7 .
    $ bin/pip install zc.buildout
    $ bin/buildout -n

Change log

1.4 (2019-09-26)

  • Remove entries in crontab generated by the previous address book version when updating to a new one.

  • Move whole installation code here from icemac.addressbook supporting its versions >= 9.

  • Add script bin/change-addressbook-config to change configuration without installing a new addressbook version.

  • Hash the admin password in the created admin.zcml and force to change the plain text password during install resp. config update.

1.3.1 (2018-08-04)

  • Use virtualenv instead of bootstrap.py of zc.buildout.

1.3 (2018-08-03)

  • Change license from ZPL to MIT.

1.2.post1 (2017-12-26)

  • Also release as wheel.

1.2 (2017-04-08)

  • install-addressbook now prints a message before starting the download.

  • archive-addressbook now prints a message before starting archiving.

1.1.1 (2017-01-07)

  • Prevent an error in archive-addressbook if the bz2 module is not available.

1.1 (2017-01-07)

  • Add make-current-addressbook script to ease usage of the current symlink in case of an error.

1.0 (2017-01-06)

  • Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

icemac.install.addressbook-1.4.tar.gz (14.6 kB view hashes)

Uploaded Source

Built Distribution

icemac.install.addressbook-1.4-py2.py3-none-any.whl (30.1 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page