Skip to main content

CLI for Elemento

Project description





Elemento command line overview

tags: elemento CLI tech CTO tutorials
<style> h1, h2, h3, h4, h5, h6, h7, p, a { font-family: Arial, Helvetica, sans-serif; } </style>

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

Info about daemons

elemento info will tell you if the daemons are running properly.

It is possible to get the client daemons from

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

:::spoiler Pro Tip 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

:::spoiler iso files 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

Community Edition

If you are interacting with servers running the Community Edition they will not be automacically discovered.

:::success Before running the daemons put your server IP in $HOME/.elemento/hosts :::

AtomOS - server side

Services

Resource matcher server

sudo systemctl status matcherserver

Storage server

sudo systemctl status storageserver

Elemento paths

The storageserver searches Elemento volumes (.elimg) in /mnt.

Add a new drive

  • mount the drive in /mnt
  • add a settings.json in the new path specifing the number of VM volumes and their total size (in GB) as follows
{
    "max-volumes": 1,
    "max-size": 1000
}

Example of configuration

|/mnt
|/mnt/elemento-vault
|/mnt/elemento-vault/settings.json

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

elemento_cli-0.2.1.tar.gz (48.8 kB view details)

Uploaded Source

Built Distribution

elemento_cli-0.2.1-py3-none-any.whl (72.5 kB view details)

Uploaded Python 3

File details

Details for the file elemento_cli-0.2.1.tar.gz.

File metadata

  • Download URL: elemento_cli-0.2.1.tar.gz
  • Upload date:
  • Size: 48.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.6

File hashes

Hashes for elemento_cli-0.2.1.tar.gz
Algorithm Hash digest
SHA256 8dcba9f75f72ac86e4c289a00a077b8a66da1585309981598f52c3cb165ed98e
MD5 e766d1822badac223d605834bbdab2e0
BLAKE2b-256 af05c5f335d5ce2b7555f334a8926be419896be58891215df926d1ad2b16bda6

See more details on using hashes here.

File details

Details for the file elemento_cli-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: elemento_cli-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 72.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.6

File hashes

Hashes for elemento_cli-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bc503a19bff2358cd9c90d9c499507d7b3bf331534945da414117f63c9f961cb
MD5 826c71ca72d8c45e2459f057e79b3faa
BLAKE2b-256 6623c1f7eff09a0673e1802549bebe112373fc010a80db2a4eae33a1cc67fff1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page