User manual: quick start

Connection to Archipel GUI

First login

Enter the URL of the HTTP served directory where Archipel GUI is installed in your browser, After a small pre-loading phase, the connection prompt will open.

And enter the following informations (all the fields must be filled):

• Jabber ID: your XMPP admin account, which must be like [email protected]
• Password: the password associated to the admin account
• BOSH Service: the BOSH URL of your XMPP server. If you use our sample conf for Ejabberd, it should be http://your.fqdn.fr:5280/http-bind
• Remember: remember credentials (will connect automatically at next loading of Archipel)

Basically your BOSH hostname is the same that the domain of your JID.

Then click on the connection button.

Adding your first hypervisor

To communicate with Archipel agents, you need to add them in your roster (list of contacts). This is the exact same system you would use with your GMail account when you want to communicate with someone. You must ask for the hypervisor a subscription request. Then hypervisor is you are granted to talk with it and if yes, it will ask you as friend too.

To add your hypervisor, click on the bottom left "+" button and select "Add a contact".

Enter the JID of your hypervisor. It should be hypervisor@myfqdn. You also can choose to name it. This name is just the nickname you want to use in your own roster. It is not visible by others. If you leave this field blank, The actual name of the hypervisor will be used. You will be able to change this later.

Then your hypervisor will be added to your roster.

Creating a virtual machine

In Archipel, virtual machines are XMPP entities, just like the hypervisors. They have their own JID and own roster. In order to create a virtual machine, you have to ask one hypervisor to do it for you. Then the virtual machine will be created, and it will ask you a subscription request.

Select your hypervisor from your roster then select the tab named "Virtual Machines":

Click on the bottom "+" button, and enter the name of the virtual machine. This is name cannot be changed. You will be able to change the display name (nickname) but never the name. If you leave this field blank, Archipel will pick up a random name, from the list of named asteroids in solar system.

Once the virtual machine has been initialized, you must answer to its subscription request:

Then the virtual machine will appears in your roster in a Not defined status. The virtual machine is now ready to be configured.