Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

This branch is 303 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

..
Failed to load latest commit information.
ANSOS @ d25bb3d
archipel-agent-action-scheduler
archipel-agent-hypervisor-geolocalization
archipel-agent-hypervisor-health
archipel-agent-hypervisor-network
archipel-agent-hypervisor-platformrequest
archipel-agent-iphone-notification
archipel-agent-virtualmachine-oomkiller
archipel-agent-virtualmachine-snapshoting
archipel-agent-virtualmachine-storage
archipel-agent-virtualmachine-vnc
archipel-agent-vmcasting
archipel-agent-vmparking
archipel-agent-xmppserver
archipel-agent
archipel-core
archipel-platformrequest-defaultcomputingunit
README.md
buildAgent
epydoc.conf
epydoc.css

README.md

What is Archipel Agent ?

Archipel Agent is the small piece of software you need to install on each of your hypervisors. It will perform bridging between XMPP and Libvirt, and allows to add extensions. It willcreate a thread for the hypervisor and each virtual machines you run on the hypervisor. It it distribute under python setuptools package. See .

License

Archipel is distributed under AGPL v3. See the LICENSE files in eggs

Read me!

Please, read this document completely before typing anything!

Get help

Installation

Basic users (mostly you :)

Installation from packages

If you read this file, there are great chances you don't want to do this. You can skip to the next section

First of all, note that you can install the latest realease of archipel agent directly from pypi, running:

# sudo easy_install archipel-agent && archipel-initinstall

To update:

# sudo easy_install -U archipel-agent

Installation from Github repo or Nightly build

If you already have a previous installation of Archipel done using easy_install, please flush your installation:

# rm -rf /usr/lib/python2.X/site-packages/archipel*
# sed '/archipel*./d' /usr/lib/python2.X/site-packages/easy-install.pth -i

this won't remove archipel data files. your virtual machines and settings are same, no worries

Ensure all dependencies are installed:

# yum install python-libvirt python-imaging
# easy_install numpy sqlalchemy apscheduler xmpppy

Now, to install archipel from the source or the nightlies, please type:

# sudo ./buildAgent --devinstall

It will "symlinks" (sort of) the eggs to the python's site-packages folder. to update you just have to git pull, no needs for further installation of the eggs.

Note that after running this command you MUST NOT move the ArchipelAgent folder. If you do so, you will nee to re-run ./buildAgent --devinstall

Update the configuration file in /etc/archipel/archipel.conf if needed.

Finally start it using :

# /etc/init.d/archipel start

You can check the log at /var/log/archipel/archipel.log. If it doesn't start, try to start it manually in order to get informations from the error output:

# killall runarchipel ; runarchipel

DO NOT FORGET to killall runarchipel before restarting it, or you will get two processed fighting for XMPP connection.

Logs

All buildAgent actions are logged into ./buildAgent.log. Please review it if you have any problem.

Advanced users

The buildAgent script has several other options that can be usefull.

Generate EGGS packages

You can generate python eggs packages without installing then if you need to:

# ./buildAgent --buildeggs --export

The optional --export option will export the eggs in ./Archipel_EGGS

Generate RPMS packages

You can generate RPMS packages if you need to:

# ./buildAgent --buildrpms --export

The optional --export option will export the eggs in ./Archipel_RPMS

Clean everything

You can reset the repository (removing all build files, generated eggs/rpms etc) by doing:

# ./buildAgent --clean

Core team information

these commands are useless if you have no right to access the Archipel account on Pypi.

To register to packages against PyPi, please type:

# ./buildAgent --register

To upload a new version of the eggs:

# ./buildAgent --buildeggs --upload

All information to connect to PyPi are red from ~/.pypirc. For instance:

```ini
    [pypirc]
    servers =
        pypi
    [pypi]
    username:username
    password:yourpassword
    [server-login]
    username:username
    password:yourpassword
```

Team

  • Antoine Mercadal : Lead developer
Something went wrong with that request. Please try again.