Tools

Archipel comes with some utilities that can make your life easier.

archipel-tagnode

This tool allow to create and configure the needed PubSub "/archipel/tags" used for central tags management. This tag MUST be created on the common pubsub server if you want tags to be shared all over the platform

arch-tagnode (c) 2010 Antoine Mercadal
this tool allows to create a new tags node. 
you should create this node using admin account (or a special dedicated account)

usage :
    arch-tagnode --jid aJid --password aPassword --pubsubserver pubsub.server [--create] [--delete]

    --jid           : set the JID to use
    --password      : set the password associated to the JID
    --pubsubserver  : set the pubsubserver to use. if not given it will be pubsub.[jid.getDomain()]
    --create, -c    : create the node (default action)
    --delete, -d    : delete the node
    --help, -h      : shows this message

You should use the admin account to create this node.

archipel-rolesnode

This tool allow to create and configure the needed PubSub "/archipel/roles" node used to store roles (permissions templates)

arch-rolesnode (c) 2010 Antoine Mercadal
this tool allows to create a new role node. 
you should create this node using admin account (or a special dedicated account)

usage :
    arch-rolesnode --jid aJid --password aPassword --pubsubserver pubsub.server [--create] [--delete]

    --jid           : set the JID to use
    --password      : set the password associated to the JID
    --pubsubserver  : set the pubsubserver to use. if not given it will be pubsub.[jid.getDomain()]
    --create, -c    : create the node (default action)
    --delete, -d    : delete the node
    --help, -h      : shows this message

You should use the admin account to create this Node.

archipel-adminaccounts

This tools allow you to declare dynamically new Archipel administrators (all permissions, on everything).

Usage: archipel-adminaccounts [options]

Options:
  -h, --help            show this help message and exit
  -j user@domain, --jid=user@domain
                        set the JID to use
  -p 123456, --password=123456
                        set the password associated to the JID
  -P pubsub.domain, --pubsubserver=pubsub.domain
                        set the pubsubserver to use. if not given it will be
                        pubsub.[jid.getDomain()]
  -c, --create          create the node
  -d, --delete          delete the node
  -a jid@domain, --authorize=jid@domain
                        insert a new admin JID
  -u jid@domain, --unauthorize=jid@domain
                        remove an admin JID identified by the item ID
  -l, --list            list all existing JID

Once created, you can add an admin account

# archipel-adminaccounts [email protected] --password=yourpassword -a [email protected] 

To remove one:

# archipel-adminaccounts [email protected] --password=yourpassword -a [email protected] 

And to list them:

# archipel-adminaccounts [email protected] --password=yourpassword -l

The platform will be notified in real time. Note that you can grant admin access right from the XMPPServer module, from the UI

archipel-updatedomain

This tool allow to quickly change the XMPP domain of all virtual machines stored in the hypervisor's database. For example, if your domain was @olddomain you can use this tool to update to @newshinydomain.

update_xmpp_domain (c) 2010 Antoine Mercadal
This tool allows you to quicky change the domain of all virtual machines in a hypervisor database.

usage: 
    update_xmpp_domain --file aFile --domain aDomain

    --file      : the sqlite3 file of hypervisor
    --domain    : the new domain to use
    --help, -h  : displays this message

archipel-importvirtualmachine

This tool is deprecated. You should use the UI directly to import virtual machines now.

This tool allows you to import already existing virtual machine into your hypervisor's archipel agent.

archipel-importvirtualmachine (c) 2010 Antoine Mercadal
this tool allows to import already existing libvirt virtual machine into Archipel.
Be sure to stop archipel agent before running this tool

usage :
    archipel-importvirtualmachine --file=sqlite3DB --uuid=aUUID --xmppserver=aServer --name=aName [--password=aPassword]
    
    --file          : the sqlite3 file of hypervisor
    --uuid          : the UUID of the exting libvirt machine
    --xmppserver    : the current Archipel's XMPP server
    --name          : the name you want to use for this virtual machine
    --password      : OPTIONAL, the password the VM should use to connect to XMPP server. Generated if ommitted
    --help, -h      : shows this message

archipel-command

This tool allows you to send raw stanza to hypervisors and VM. The stanza can be send in the command line, or from STDIN. List of stanza.

Usage: archipel-command [options]
     -j user@domain, --jid=user@domain : set the JID to use
     -p 123456, --password=123456 : set the password associated to the JID
     -t DEST_JID, --to=DEST_JID : the target **full** JID (i.e. entity@fqdn/resource)
     -r SEND_RAW, --raw=SEND_RAW:  the raw acp string to send. You do not need to set the  'from', 'to', and 'id' information
     -P, --nopretty  : use plain response

##archipel-ejabberdadmin

This tool allow you to add ejabberd admins from the command line without editing the ejabberd.conf. This is used when you will need to allow xml-rpc communication between an entity and ejabberd or deal with user management through XMPPServer Toolbar.

Usage: archipel-ejabberdadmin [options]
     -j user@domain, --jid=user@domain : set the JID to use **must** already be an ejabberd admin
     -p 123456, --password=123456 : set the password associated to the JID
     -a JID, --authorize JID : promote this JID (i.e. entity@fqdn) as ejabberd admin. 
     -u JID, --unauthorize JID :  demote this JID (i.e. entity@fqdn) as ejabberd admin.
     -l, --list: list the current ejabberd admins.