A Buildout recipe to install and configure tomcat for Anaconda.
Project description
******************************
birdhousebuilder.recipe.tomcat
******************************
.. contents::
Introduction
************
``birdhousebuilder.recipe.tomcat`` is a `Buildout`_ recipe to install ``Apache Tomcat`` application server with `Anaconda`_. This recipe is used by the `Birdhouse`_ project.
.. _`Buildout`: http://buildout.org/
.. _`Anaconda`: http://www.continuum.io/
.. _`Supervisor`: http://supervisord.org/
.. _`Apache Tomcat`: https://tomcat.apache.org/
.. _`Birdhouse`: http://bird-house.github.io/
Usage
*****
The recipe requires that Anaconda is already installed. It assumes that the default Anaconda location is in your home directory ``~/anaconda``. Otherwise you need to set the ``ANACONDA_HOME`` environment variable or the Buildout option ``anaconda-home``.
It installs the ``apache-tomcat`` package from a conda channel in a conda enviroment named ``birdhouse``. The location of the birdhouse environment is ``.conda/envs/birdhouse``. It deploys a `Supervisor`_ configuration in ``~/.conda/envs/birdhouse/etc/supervisor/conf.d/tomcat.conf``. Supervisor can be started with ``~/.conda/envs/birdhouse/etc/init.d/supervisord start``.
By default Tomcat will be available on http://localhost:8080/thredds.
The recipe depends on ``birdhousebuilder.recipe.conda`` and ``birdhousebuilder.recipe.supervisor``.
Supported options
=================
This recipe supports the following options:
``anaconda-home``
Buildout option with the root folder of the Anaconda installation. Default: ``$HOME/anaconda``.
The default location can also be set with the environment variable ``ANACONDA_HOME``. Example::
export ANACONDA_HOME=/opt/anaconda
Search priority is:
1. ``anaconda-home`` in ``buildout.cfg``
2. ``$ANACONDA_HOME``
3. ``$HOME/anaconda``
Example usage
=============
The following example ``buildout.cfg`` installs ``tomcat`` as a Supervisor service::
[buildout]
parts = tomcat
anaconda-home = /home/myself/anaconda
[tomcat]
recipe = birdhousebuilder.recipe.tomcat
Authors
*******
Carsten Ehbrecht ehbrecht at dkrz.de
Changes
*******
0.2.0 (2014-02-24)
==================
* installing in conda enviroment ``birdhouse``.
* using ``$ANACONDA_HOME`` environment variable.
* separation of anaconda-home and installation prefix.
0.1.4 (2014-12-06)
==================
* Don't update conda on buildout update.
0.1.3 (2014-12-04)
==================
* Update tomcat config.
0.1.2 (2014-07-31)
==================
* Update documentation.
0.1.1 (2014-07-22)
==================
* Configure tomcat-users.xml.
0.1.0 (2014-07-10)
==================
* Initial Release.
birdhousebuilder.recipe.tomcat
******************************
.. contents::
Introduction
************
``birdhousebuilder.recipe.tomcat`` is a `Buildout`_ recipe to install ``Apache Tomcat`` application server with `Anaconda`_. This recipe is used by the `Birdhouse`_ project.
.. _`Buildout`: http://buildout.org/
.. _`Anaconda`: http://www.continuum.io/
.. _`Supervisor`: http://supervisord.org/
.. _`Apache Tomcat`: https://tomcat.apache.org/
.. _`Birdhouse`: http://bird-house.github.io/
Usage
*****
The recipe requires that Anaconda is already installed. It assumes that the default Anaconda location is in your home directory ``~/anaconda``. Otherwise you need to set the ``ANACONDA_HOME`` environment variable or the Buildout option ``anaconda-home``.
It installs the ``apache-tomcat`` package from a conda channel in a conda enviroment named ``birdhouse``. The location of the birdhouse environment is ``.conda/envs/birdhouse``. It deploys a `Supervisor`_ configuration in ``~/.conda/envs/birdhouse/etc/supervisor/conf.d/tomcat.conf``. Supervisor can be started with ``~/.conda/envs/birdhouse/etc/init.d/supervisord start``.
By default Tomcat will be available on http://localhost:8080/thredds.
The recipe depends on ``birdhousebuilder.recipe.conda`` and ``birdhousebuilder.recipe.supervisor``.
Supported options
=================
This recipe supports the following options:
``anaconda-home``
Buildout option with the root folder of the Anaconda installation. Default: ``$HOME/anaconda``.
The default location can also be set with the environment variable ``ANACONDA_HOME``. Example::
export ANACONDA_HOME=/opt/anaconda
Search priority is:
1. ``anaconda-home`` in ``buildout.cfg``
2. ``$ANACONDA_HOME``
3. ``$HOME/anaconda``
Example usage
=============
The following example ``buildout.cfg`` installs ``tomcat`` as a Supervisor service::
[buildout]
parts = tomcat
anaconda-home = /home/myself/anaconda
[tomcat]
recipe = birdhousebuilder.recipe.tomcat
Authors
*******
Carsten Ehbrecht ehbrecht at dkrz.de
Changes
*******
0.2.0 (2014-02-24)
==================
* installing in conda enviroment ``birdhouse``.
* using ``$ANACONDA_HOME`` environment variable.
* separation of anaconda-home and installation prefix.
0.1.4 (2014-12-06)
==================
* Don't update conda on buildout update.
0.1.3 (2014-12-04)
==================
* Update tomcat config.
0.1.2 (2014-07-31)
==================
* Update documentation.
0.1.1 (2014-07-22)
==================
* Configure tomcat-users.xml.
0.1.0 (2014-07-10)
==================
* Initial Release.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for birdhousebuilder.recipe.tomcat-0.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9277abbb327842904dcef3982730c69923b4997cedc92471d74171c02c7abc46 |
|
MD5 | b59f368315585f9a1b43688653835862 |
|
BLAKE2b-256 | d507f83f1c1a8415774c1196effa95ce00bd6adb4a8b57f9f93f72630b769c95 |