elemento-cli 0.1.3

CLI for Elemento

Elemento command line overview

Authentication

Before using the Elemento CLI you would need to authenticate!

elemento auth login

Do you have an account? No, create yours here

Forgot your password? Recover it here

elemento auth logout

Account Management

To use AtomOS you will need a License: buy yours here!

From the CLI you can list your licenses

elemento account list_licenses

or activate one. AtomOS licenses become active and ready when you activate them, not when you buy them.

elemento account activate_license --key

the CLI will download your license and you'll find a atomos.license file:

• keep it in a safe place!
• copy it in /etc/elemento/atomos.license path of your server (one license per server)
• restart the elementolicensing service systemctl restart elementolicensing

Volumes

You can list your volumes.

elemento volume list

Volumes will be searched in /mnt/elemento-vault, mount here your volumes!

If you have not any volume you can ask if there is any server ready to create one for you

elemento volume cancreate --size 1

and then create or even destroy your volumes

elemento volume create --size 1

(Read our tech pack for a complete list of volume specification)

elemento volume destroy fffffffffffffffffffffffffffffffff

Virtual Machines

You can manage your own volumes or download a standard iso image elemento vm getiso This command will download a file calles {os_flavour}.iso in /tmp and you can run vmw from this if using the Live image!

then you can create your machine

elemento vm create --spec-json /path/to/request.json --volumes-json /path/to/volumes.json

(Read our tech pack for a complete list of volume specification)

Templates

List some machines templates elemento vm gettemplates

List your vms

elemento vm list

you will notice a SW and a HW link in the form https://localhost:8443/#/clients/... these will open a screen to manage your machines directly form your browser. In order to use the software link you need to enable VNC (on Linux) or RDP (on Windows) with an account elemento.

or destroy them

elemento vm destroy fffffffffffffffffffffffffffffffff

Licensing

First of all grab your license, activate it with the command line

elemento account activate_license --key

the CLI will download your license and you'll find a atomos.license file:

• keep it in a safe place!
• copy it in /etc/elemento/atomos.license path of your server (one license per server)
• restart the elementolicensing service systemctl restart elementolicensing

Check the status of your service sudo systemctl status elementolicensing

Doubts? Need help?

Open an issue in our helpcenter