1. CREATE A KEYPAIR
    1. Connect to the hepiaCloud portal
    2. Click on « Access & Security » (left menu)
    3. Click on “Key pair” tab
    4. Click on “Create Key pair” button
    5. Give a name to your key pair
    6. Download the .pem file (private key). This key will allow you to access to the created instances by ssh command.
  2. CREATE A SECURITY GROUP OR UPDATE THE DEFAULT SECURITY GROUP
    1. Click on « Access & Security » (left menu)
    2. Click on the Manage Rules button of the default security group
    3. Select « SSH » rule and click on Add button
  3. CREATE NETWORK
    1. Click on “Networks” (left menu)
    2. Click on “Create Network” button
    3. Network Name: Give a name to your network
    4. Admin state : UP
    5. Click on “Next”
    6. Subnet Name: Give a name to your sub-network
    7. Network address: Example: 10.0.0.0/24. The network may be any IPv4 network address.
    8. IP Version: IPv4
    9. Gateway IP: leave it blank. The default address is the first IP of the network address
    10. Do not enable “Disable Gateway” button
    11. Click on Next
    12. Allocation Pools: leave it empty
    13. DNS Name Servers: Put these addresses
          129.194.4.6
          129.194.8.7
          8.8.8.8
    14. Host Routers: leave it empty
  4. CREATE ROUTER
    1. Click on “Routers” (left menu)
    2. Click on “Create Router” button
    3. Router Name: Give a name to your router
    4. Admin state : UP
    5. External Network: Select “ext-net”.
    6. At this stage, the router is created and appears on the list of routers. Click on your created router, then click on the “interfaces” tab
    7. Click on “Add Interface” button
    8. Subnet: select the subnet you previously created
    9. IP address: Leave it empty
    10. Router Name: name of your router
    11. Router ID: Leave it as it is
    12. Click on “Add Interface” button
    13. At this stage your network is created. You can check its topology by clicking on Network Topology (left menu)
  5. LAUNCH INSTANCES VIA hepiaCloud PORTAL
    1. Click on « Instances » (left menu)
    2. Click on « launch instances »
    3. Availability zone: nova
    4. Instance name: Give a name to your instance
    5. Choose a flavour (at least m1.small if you create an Ubuntu instance)
    6. Instance count: number of instances you would like to launch
    7. Instance boot source: Boot from image
    8. Image name: select “ubuntu-14.04”
    9. Click on « Access & Security » tab and select the keypair previously created
    10. Click on “Networking” tab and select the network you would like to use
    11. Click on “Launch”. Your instance will appear in the list of your running instances with its private IP address
    12. Click on the drop-down menu next to the “Create snapshot” button, and then click on “Associate Floating IP” menu
    13. IP Address: select an IP address or add a new one by clicking on “+” button
    14. Port to be associated: Do not update this field
    15. Click on “Associate”. The floating IP address (“public” address) will be associated to the instance.
    16. You can check the topology of your network and instances by clicking on the “Network Topology” menu (left menu)
  6. ACCESS AN INSTANCE VIA SSH

    In order to access an instance via ssh you need to know the last decimal number of the dot-decimal floating IP address. The instances are contacted through the gateway machine (hepiacloud.hesge.ch) that port-forwards to the appropriate instance IP address. The last decimal number of the floating IP address is added to 10000 to get the appropriate port number.

    ssh -i <name of privatekey .pem file> -p 10066 ubuntu@hepiacloud.hesge.ch

    Notes :

    1. Do not forget to restrict the access to your .pem file: <keypair.pem> (chmod 600 <keypair.pem>)
    2. For Ubuntu instances, the user name is “ubuntu”. For CentOS instances, the user name is “centos”.