a2svm

---

A2SVM - Apache 2 Simple Virtualhost Manager

---

a2svm is a Simple CLI tool to create and delete easily virtualhosts in Apache.

usage: a2svm [-h] [-v] {mk,ls,rm,en,ds} ...

a2svm commands are:

• mk Create a virtualhosts
• ls Show managed virtualhosts on Apache server
• rm Delete a virtualhosts
• en Enable a virtualhosts
• ds Disable a virtualhosts

See 'a2svm -h' for more information on a specific command.

PyPI package <http://pypi.python.org/pypi/a2svm>__

Sources <https://github.com/cypx/a2svm>__

Requirements ##############

a2svm need apache mod_macro which could be installed on debian 6 by the following command

.. code-block:: bash

$ aptitude install libapache2-mod-macro

Once mod_macro is avalaible some template could be created for use by a2svm like this one

.. code-block:: xml

<Macro vhost_standard $name $servername $directory>
  <VirtualHost *:80>

    ServerName $servername

    DocumentRoot /var/www/$directory/public

    <Directory /var/www/$directory>
        Options  FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        allow from all
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error-$name.log

    # Possible values include: debug, info, notice, warn, error, crit,
    # alert, emerg.
    LogLevel warn

    CustomLog ${APACHE_LOG_DIR}/access-$name.log combined
  </VirtualHost>
</Macro>

#Comments beginning by "a2svm_make_command" are used to run external commands
#when vhost is created
#a2svm_make_command: /bin/mkdir -p /var/www/$directory/public /var/www/$directory/log
#a2svm_make_command: /bin/chown -R cyp:www-data /var/www/$directory
#Comments beginning by "a2svm_remove_command" are used to run external commands
#when vhost is removed
#a2svm_remove_command: /bin/tar czf /var/www/archive/$servername.tgz /var/www/$directory
#a2svm_remove_command: /bin/rm -rf /var/www/$directory

Installation ##############

Install it easily:

Using pip

---

.. code-block:: bash

$ pip install a2svm

Warning! On some old distribution using Python 2.x, you could require to upgrade pip to support install, run:

.. code-block:: bash

$ pip install --index-url=https://pypi.python.org/simple/ --upgrade pip setuptools

Using easy_install

---

On most Linux distribution

.. code-block:: bash

$ easy_install a2svm

But on some, prerequisites are required, for example, on Debian 6

.. code-block:: bash

$ aptitude install python-pip

Upgrade ##########

Using pip

---

.. code-block:: bash

$ pip --upgrade a2svm

Using easy_install

---

.. code-block:: bash

$ easy_install --upgrade a2svm

From sources

---

.. code-block:: bash

$ git clone https://github.com/cypx/a2svm
$ cd a2svm
$ pip install -r requirements.txt
$ python setup.py install

Reminder

---

To publish package on pypi

.. code-block:: bash

$ pip install twine
$ rm -rf dist
$ python setup.py sdist bdist_wheel
$ twine upload dist/*