FAQ10 EGI Federated Cloud User

From EGIWiki
Revision as of 15:13, 10 January 2014 by Spinto (talk | contribs) (How can I connect to a VM?)
Jump to: navigation, search
Main Roadmap and Innovation Technology For Users For Resource Providers Media



EGI FedCloud Users FAQs

How can I get access to the EGI.eu Federated Cloud?

The information is available here.

How can I get the list of the FedCloud sites?

The federated cloud is currently in testbed phase. The list of the testbed FedCloud sites is available here

How can I choose which FedCloud site to use?

FedCloud sites offers their resources voluntary to all the FedCloud user comunities. Anyway, they may assign you higher or lower priorities according to your particular user community and research field. To find the better site for your need, it is recommended to send an email to the EGI.eu UCST Team, with a small description of your needs and your field of research.

How can I get the list of the resource templates available on a site?

In a command line environment, using the rOCCI client (a guide on how to install it is available here), you can run the following command

occi --endpoint site_occi_endpoint --action list --resource resource_tpl --auth x509 --user-cred proxy_certificate --voms

where site_occi_endpoint is the site OCCI endpoint and proxy_certificate is the path to your VOMS proxy certificate (obtained via the voms-proxy-init commands, see here)

How can I get the list of the OS templates available on a site?

In a command line environment, using the rOCCI client (a guide on how to install it is available here), you can run the following command

occi --endpoint site_occi_endpoint --action list --resource os_tpl --auth x509 --user-cred proxy_certificate --voms

where site_occi_endpoint is the site OCCI endpoint and proxy_certificate is the path to your VOMS proxy certificate (obtained via the voms-proxy-init commands, see here)

How can I get information about the available VM images

The EGI Marketplace and the EGI Application Database contains information about the VM images available in the EGI Federated Cloud.

How can I publish my own VM image?

Direct publish of custom VMs implies an authorization and verification phase. If you want to use your custom VM, the main steps to follow are:

  • Create a custom VM image
  • Upload the image and register it into the EGI marketplace and EGI Application Database.
    • Tip: A guide (beta) on doing so is here.
  • Contact the site to endorse your image (trusting you as VM custom images producer on the EGI Federated Cloud).
    • Tip: Best way to do so is to contact the EGI.eu UCST Team. The team will contact the EGI site for you.

For more detailed information about the procedure, please send an email to EGI.eu UCST Team.

How can I start a VM?

In a command line environment, using the rOCCI client (a guide on how to install it is available here), you can run the following command

occi --endpoint site_occi_endpoint --action create --resource compute --mixin os_template --mixin resource_template --attributes title="My rOCCI VM" --auth x509 --user-cred proxy_certificate --voms

where site_occi_endpoint is the site OCCI endpoint, proxy_certificate is the path to your VOMS proxy certificate (obtained via the voms-proxy-init commands, see here), os_template is your VM OS image disk (e.x. os_tpl#debian6) and resource_template is your resource template (ex. resource_tpl#small).

How can I get the status of a VM?

In a command line environment, using the rOCCI client (a guide on how to install it is available here), you can run the following command

occi --endpoint site_occi_endpoint --action describe --resource /compute/VMID --auth x509 --user-cred proxy_certificate --voms

where site_occi_endpoint is the site OCCI endpoint, proxy_certificate is the path to your VOMS proxy certificate (obtained via the voms-proxy-init commands, see here) and VMID is the VMID obtained as output of the create VM action.

How can I connect to a VM?

As first, you need to check that the VM is running and get its IP address. You can do that via a describe OCCI command (see #How can I get the status of a VM? for more info).

To access the VM via the shell, you can use an SSH client and connect to the VM IP address, port 22, root user with your own authorization key.

NOTE: The authorization public key to access the VM can be setup in the VO VOMS (ex. in [Perun]) or using contextualization as startup (see #How can I get the status of a VM?)

How can I inject my public SSH key into the machine?

Best way to login into the virtual server is to use SSH keys. To inject your public SSH key into the VM during startup, you can use CloudInit contextualization feature and contextualization (see #How can I use contextualization?). A sample user data script to setup an administrator user is

#cloud-config
users:
 - name: cloudadm
   sudo: ALL=(ALL) NOPASSWD:ALL
   lock-passwd: true
   ssh-import-id: cloudadm
   ssh-authorized-keys:
    - <your SSH key>

How can I use contextualization?

If you have a contextualization script, you can run it using the following rOCCI command at VM creation:

occi --endpoint site_occi_endpoint --action describe --resource /compute/VMID  --context user_data="file://$PWD/contextulization_script.sh" --auth x509

NOTE: FedCloud supports CloudInit user data format. Using CloudInit you can easily inject your SSH private keys or run a set of deployment scripts. Full documentation about CloudInit is here.

How can I get the list of running VM?

In a command line environment, using the rOCCI client (a guide on how to install it is available here), you can run the following command

occi --endpoint site_occi_endpoint --action list --resource compute --auth x509 --user-cred proxy_certificate --voms

where site_occi_endpoint is the site OCCI endpoint and proxy_certificate is the path to your VOMS proxy certificate (obtained via the voms-proxy-init commands, see here)

How can I stop a VM?

In a command line environment, using the rOCCI client (a guide on how to install it is available here), you can run the following command

occi --endpoint site_occi_endpoint --action delete --resource /compute/VMID --auth x509 --user-cred proxy_certificate --voms

where site_occi_endpoint is the site OCCI endpoint, proxy_certificate is the path to your VOMS proxy certificate (obtained via the voms-proxy-init commands, see here) and VMID is the VMID obtained as output of the create VM action.

How can I register to the FedCloud VO?

You can register to the FedCloud VO following the instruction in this page.

How can I get a proxy certificate (for authorization)?

You can get a proxy certificate with the following command (NOTE: you need to be registered to the FedCloud VO):

voms-proxy-init -voms fedcloud.egi.eu --rfc

How can I install the rOCCI client?

You can setup the FedCloud User command line environment (which contains the rOCCI client) following the instructions in this page.