Setup a LA demo using microstack - AtlasOfLivingAustralia/documentation GitHub Wiki

Setup a Living Atlas demo using microstack

This howto explains how to deploy a LA demo portal using microstack and the la-toolkit.

Quoting the microstack requirements:

You will need a multi-core processor and at least 8 GiB of memory and 100 GiB of disk space. MicroStack has been tested on x86-based physical and virtual (KVM) machines running either Ubuntu 18.04 LTS or Ubuntu 20.04 LTS.

For that,

  1. Install the la-toolkit in your computer: https://github.com/living-atlases/la-toolkit#prerequisites

  2. Install microstack following the instructions in: https://microstack.run/docs/single-node

  3. When completed, list the different VMs flavors you have, for instance:

$ microstack.openstack flavor list           
+----+-----------+-------+------+-----------+-------+-----------+
| ID | Name      |   RAM | Disk | Ephemeral | VCPUs | Is Public |
+----+-----------+-------+------+-----------+-------+-----------+
| 1  | m1.tiny   |   512 |    1 |         0 |     1 | True      |
| 2  | m1.small  |  2048 |   20 |         0 |     1 | True      |
| 3  | m1.medium |  4096 |   20 |         0 |     2 | True      |
| 4  | m1.large  |  8192 |   20 |         0 |     4 | True      |
| 5  | m1.xlarge | 16384 |   20 |         0 |     8 | True      |
+----+-----------+-------+------+-----------+-------+-----------+

  1. Test you can access to microstack UI at https://10.20.20.1/

  2. Download some ubuntu 18.04 (and optionally 20.04) images from, for instance bionic-server-cloudimg-amd64.img from https://cloud-images.ubuntu.com/bionic/current/

  3. Create the images in https://10.20.20.1/admin/images

  1. Now create a VM with that image and choosing a flavor with enough resources (you can create more if you want to test more services, but in this example we'll create only one):
$ microstack launch ubuntu-18.04 -n la-test-1 --flavor 4 
Launching server ...
Allocating floating ip ...
Server la-test-1 launched! (status is BUILD)

Access it with `ssh -i /home/youruser/snap/microstack/common/.ssh/id_microstack [email protected]`
You can also visit the OpenStack dashboard at https://10.20.20.1:443

We'll use the ssh key id_microstack to access this VM from our la-toolkit.

  1. Check that the VM is running (Active) and annotate the IP of the VM (in this example: 10.20.20.74)

  1. Access to your key pairs and copy the public ssh key string:

https://10.20.20.1/project/key_pairs/

  1. Copy this Public Key string to a text file id_microstack.pub and the above private key /home/youruser/snap/microstack/common/.ssh/id_microstack to your la-toolkit ssh keys directory:
$ ls -lrta /data/la-toolkit/ssh/id_microstack*
-rw------- 1 youruser youruser 1678 jun 14 14:32 /data/la-toolkit/ssh/id_microstack
-rw-rw-r-- 1 youruser youruser  399 jun 14 14:33 /data/la-toolkit/ssh/id_microstack.pub
  1. In the la-toolkit reload your ssh keys (Upper-left drawer > SSH keys > Scan your keys ) to see that reads this new pair of keys:

  1. Create a New LA Project and add the name of the VM you created above:

  1. Select the mandatory services and assign them to that VM. In this example we only select these basic services. If you want to test more services, probably you'll need more VMs a resources:

  1. Configure the above ssh key and the IP to your server:

  1. Save your project and Test the connectivity:

  1. If this works, you can start deploying the services:

Continue testing your with the LA Quick Start Guide