Skip to content

Latest commit

 

History

History
463 lines (295 loc) · 14.8 KB

Registration.rst

File metadata and controls

463 lines (295 loc) · 14.8 KB

Registration, User and Project Management

To be able to use the CloudVeneto service, first of all you need to apply for an account. The procedure to be followed is described in this chapter.

Users who need to use INFN IT resources must met the prerequisites specified in the following section before applying for an account on the CloudVeneto infrastructure. This always applies to users willing to be member of an INFN project, but also to some Unipd projects which use some INFN resources (e.g. the network).

Prerequisites for using INFN resources

Users who need to use INFN IT resources must:

  • have a verified digital identity (LoA2) on INFN-AAI;
  • declare to have read and accepted the INFN rules for the use of IT resources;
  • have followed the "Corso di Sicurezza Informatica - BASE".

To have a verified digital identity, connect to https://signup.app.infn.it/ to self-register and to get an account on INFN-AAI. Documentation (unfortunately only in Italian) on this process is available here.

After this self-registration process, connect to the INFN-AAI User Portal at https://userportal.app.infn.it/ using your INFN-AAI account to complete the digital identity registration. In this process you will have to choose where (the INFN site) you want to be identified, and the person that will have to approve your request (if you are a Unipd student and you can't find your Professor among the proposed list of persons, please select 'Giannina Borgato').

Documentation (unfortunately only in Italian) on this process is available here.

You will then be contacted by an INFN secretariat person for your identification.

To follow the "Corso di Sicurezza Informatica - BASE", please use this link. This course must be followed within 30 days after the registration.

Note

These rules apply to users willing to be member of an INFN project, but also to users who want to join a Unipd Physics Dept. related project using a 10.64.x.0/24 network (since this is a INFN network).

Apply for an account

The registration procedure in the cloud is managed through the Horizon Openstack web service interface.

Go to https://cloud-areapd.pd.infn.it/dashboard or https://cloudveneto.ict.unipd.it/dashboard in a browser. The following page should appear:

./images/dashboard_prod.png

Click on the Register button.

The following page should appear:

./images/dashboard_reg.png

Enrollment procedure through INFN AAI or UniPD SSO

Once authenticated on your Identity Provider system, you will be redirected to a form like this:

./images/RegisterFormAAI.jpg

Fill the form with the required information. In particular please specify the relevant unit/department of your home institution.

For what concerns the Project Action (projects have been discussed in :ref:`Projects<projects>`) you have two options:

  • Select Existing Projects
  • Create new project

Choose Select Existing Projects if you want to apply membership for one or more existing projects (choose them in the relevant box).

Select Create new project if instead you want to ask the creation of a new project (and you are the leader of the experiment/research group associated to this project). In this case you will have to specify also a Project name and a Project Description.

Newly created projects will get a default quota of:

  • 20 VCPU
  • 20 GB RAM
  • 200 GB for Volume (e.g. non ephemeral) storage

Allocation of more resources for UniPD users must be approved by the Cloud UniPD "governance". Mail your request to cloud-unipd-gov@lists.pd.infn.it if you want more resources to be allocated to your project.

Note

The person who asks for the creation of a new project is automatically defined as the manager of this project, i.e. he/she will have to manage the membership requests for this project. So the request to create a new project should be done by the relevant experiment/group leader.

When you have filled the form, please read the AUP that you need to accept (by clicking the Accept AUP button).

Finally click on the Register button and you are done.

./images/RegistrationDone.png

Your request will be managed by the Cloud adminstrator and by the manager(s) of the project(s) for which you applied membership. You will get an e-mail when your request is approved or if for some reason your request is refused. In the first case you will later also receive an e-mail with the credentials needed to access the Cloud gate machine (see :ref:`Network Access<NetworkAccess>`).

Apply for an account using Username and Password

If and only if you don't have an account on the UniPD SSO or INFN AAI, click on the green icon on the right:

./images/RegisterLocalAccount.png

A form such as the one of the following image will appear.

./images/RegisterFormUserPasswd.png

Please fill the form with your personal data (First Name, Last Name, Email Address. Choose a User name (please note that it could be changed by the Cloud admins during the registration process) and a Password. Specify your home institution and the relevant unit/department.

For what concerns the Project Action (projects have been discussed in :ref:`Projects<projects>`) you have two options:

  • Select Existing Projects
  • Create new project

Choose Select Existing Projects if you want to apply membership for one or more existing projects (choose them in the relevant box).

Select Create new project if instead you want to ask the creation of a new project (and you are the leader of the experiment/research group associated to this project). In this case you will have to specify also a Project name and a Project Description.

Newly created projects will get a default quota of:

  • 20 VCPU
  • 20 GB RAM
  • 200 GB for Volume (e.g. non ephemeral) storage

Allocation of more resources for UniPD users must be approved by the Cloud UniPD "governance". Mail your request to cloud-unipd-gov@lists.pd.infn.it if you want more resources to be allocated to your project.

Note

The person who asks for the creation of a new project is automatically defined as the manager of this project, i.e. he/she will have to manage the membership requests for this project. So the request to create a new project should be done by the relevant experiment/group leader.

When you have filled the form, please read the AUP that you need to accept (by clicking the Accept AUP button).

Finally click on the Register button and you are done.

./images/RegistrationDone.png

Your request will be managed by the Cloud adminstrator and by the manager(s) of the project(s) for which you applied membership. You will get an e-mail when your request is approved or if for some reason your request is refused. In the first case you will later also receive an e-mail with the credentials needed to access the Cloud gate machine (see :ref:`Network Access<NetworkAccess>`).

Apply for other projects

After you have been given an account on the CloudVeneto, at any time you can ask the creation of a new project or the membership to an already existing project.

Both operations are performed by accessing the Identity |rarr| Projects tab of the OpenStack dashboard and clicking on Subscribe to project as depicted on the following image:

./images/ProjectRequest-new.png

Fulfill your request selecting the relevant choice under the Project action dropdown list.

Manage project membership requests (only for project managers)

If you are the manager of a project, you will receive membership requests for this project that you will have to manage (approving or refusing them).

When a user applies to be member of a project that you manage, you will receive an e-mail such as this one:

./images/email_subreq.png

To manage such requests, open the OpenStack web dashboard, i.e. go to https://cloud-areapd.pd.infn.it or https://cloudveneto.ict.unipd.it in a browser. Log in, and then access Identity |rarr| Subscriptions. An image such as the following one, with the list of the pending requests, will appear.

./images/Subscriptions.png

To approve a membership request, click on the Approve button (in Actions). A window such as the following one will appear:

./images/ProcessSubscription.png

Set the expiration date of the account, and click on the Ok button to approve the request.

If, instead, you want to reject the request, select Reject in Actions.

Note

It is therefore up to the project manager to set the expiration date of the members of his/her group.

A user belonging to multiple projects can have different expiration dates for the different projects he/she belongs to.

Administer project members (only for project managers)

If you are the manager of a project, you can list the members of your project and, if needed, change their role.

Open the OpenStack web dashboard, i.e. go to https://cloudveneto.ict.unipd.it/dashboard in a browser. Log in using the relevant method and access the Identity |rarr| Project Members panel. The list of users affiliated to your project will appear:

./images/IdentityProjectMembers.png

From here you can also change the role of a specific user (by clicking on Toggle Role) from 'Project User' to 'Project manager' or viceversa.

Note

If a user is promoted to Project manager, she will then be allowed to manage affilitation requests to the project, as described in :ref:`Manage project membership requests (only for project managers)<ManageProjectMembershipRequests>`.

From this window you can also remove a specific user from the project you manage.

Project membership renewal

A user can be affiliated to multiple projects and each affiliation has an expiration date. You can check the expiration dates for the projects you are affiliated opening the OpenStack web dashboard, i.e. going to https://cloud-areapd.pd.infn.it or https://cloudveneto.ict.unipd.it in a browser. Then log in, and access Identity |rarr| Projects.

When the membership for a particular project is going to expire, usually 30 days before the expiration, you are invited to decide whether to renew the membership or to cancel it at the due date: you will receive a message from the CloudVeneto site such as this one:

./images/proposed_renew_msg.png

You will then must log into the dashboard and select the related project from the combo on top of the page, if necessary. A page such as this one will appear:

./images/proposed_renewal.png

If you click 'Yes' (i.e. if you would like to have your membership renewed), the project renewal request will be sent to the project administrator(s) for approval (ad documented in the next section).

Manage project membership renewal requests (only for project managers)

When the affiliation of a user for a project is expiring and that user would like the renewal of such membership (see previous section), as manager of that project you will receive an e-mail such as this one:

./images/email_renewreq.png

To manage such requests, open the OpenStack web dashboard, i.e. go to https://cloud-areapd.pd.infn.it or https://cloudveneto.ict.unipd.it in a browser. Log in, and then access Identity |rarr| Subscriptions. An image such as the following one will appear:

./images/renew_acc.png

Click on the Renew button (in Actions). A window, such as the one represented in the following image will appear:

./images/renew_setdate.png

Set the new expiration date and then click the OK button.

Note

Please note that you can change any time the expiration date for the membership of a certain user to the project you are managing. This can be done going in the Dashboard and accessing Identity |rarr| Project Membership. Then select Change Expiration in the Actions menu for the relevant user.

Send a message to project members (only for project managers)

If you are the manager of a project, you can send a message (that will be delivered via e-mail) to all members of your project.

Please go to Identity |rarr| Project Members on the left hand menu and click on Send Message.

./images/send_message.png

Fill the 'Message' form with the text that you want to send, and then click Submit.

./images/send_message_form.png

Expired users

Please note the resources (instances and volumes) owned by expired users (i.e. people who don't have anymore an account on CloudVeneto) will be removed.

Please also note that, while the ownership of a volume can be transferred from a user to another one (see :ref:`Transferring the ownership of a volume to another user<TransferVolume>`), this can't be technically possible for virtual machines.