Client commands

Resource monitoring

Monitoring for StratusLab (free CPU = ACPU / 100).


ID = MarketPlace disk image identifier
For CentOS v6.6 (5 GB of disk): ID = M93WYaVpAQxwAe2THlciCzH-qQi
UUID = virtual persistent disk identifier
id = Virtual Machine (VM) identifier on the StratusLab Cloud
ip = automatically generated IP adress
For help:

$ stratus-xxx-xxx -h

Virtual machine

StratusLab's client documentation

  • To launch, connect and switch off VM with a specific OS:
$ stratus-run-instance ID
$ stratus-describe-instance -vvv
$ stratus-connect-instance id <=> ssh -i /home/user/.ssh/id_rsa root@ip
$ stratus-kill-instance id
  • To choose the number of virtual CPU and the amount of RAM and SWAP:
    • Predefined type:
$ stratus-run-instance --list-type
 Type             CPU       RAM      SWAP
  c1.medium       2 CPU    1536 MB    1536 MB
  c1.xlarge       4 CPU    6144 MB    6144 MB
  m1.large        2 CPU    6144 MB    6144 MB
  m1.medium       1 CPU    3072 MB    3072 MB
* m1.small        1 CPU    1536 MB    1536 MB
  m1.xlarge       4 CPU    8192 MB    8192 MB
  my.type         1 CPU    2048 MB    2048 MB
  t1.micro        1 CPU     512 MB     512 MB

$ stratus-run-instance --type=m1.xlarge ID 

If you want to use the predefined type of .stratuslab/stratuslab-user.cfg:

stratus-run-instance -t my.type ID
  • Selecting preferences:
$ stratus-run-instance --cpu=2 --ram=1024 --swap=1024 ID

Virtual cluster

Note: this method is deprecated. See the SlipStream section to create a virtual cluster with automatic deployment tool.

  • To create a virtual cluster:

With Smith user, with /home directory shared by NFS on master node and worker nodes, working for MPI jobs, with 4 VM, with scientific packages (gfortran,openmpi) and all nodes reachable by SSH:

$ stratus-run-cluster --cluster-user=smith --shared-folder=/home 
--mpi-machine-file -n 4 --add-packages gcc-gfortran,openmpi --ssh-hostbased 
--cpu=4 --ram=4096 --swap=4096 ID

Virtual persistent disk

StratusLab's client documentation
Note: virtual persistent disk acts as hard drive and can be attached only one time on a VM.

  • To create persistent disk of 2 GB with a private access:
$ stratus-create-volume --size=2 --tag=data-disk-smith
  • To obtain informations about the persistent disk:
$ stratus-describe-volumes -f owner:smith
  • To attach/detach the persistent disk:
    • During the instanciation of the VM:
$ stratus-run-instance --persistent-disk=UUID ID

The disk is attached on /dev/vdc partition.

  • During the run of the VM:
$ stratus-attach-volume --instance id UUID1 UUID2 UUID3
$ stratus-detach-volume --instance id UUID

The disk is attached on /dev/vda or /dev/sdc partition depending on the choice of the bus (ide, scsi or vidio).

  • To manipulate the persistent disk:

You need to format it the first time:

root@vm $ mkfs.ext4 /dev/vdc

And to mount it:

root@vm $ mount /dev/vdc /mnt

At the end of the work, unmount the disk:

root@vm $ umount /mnt