SmartFIRE Portal Documentation SmartFIRE Portal Documentation



Homepage

Access the SmartFIRE Portal at http://portal.eukorea-fire.eu. By signing up with an account on the SmartFIRE portal, you will have access to its federated resources. In this section, we outline the sign-up process and show you how to create an account and register a new organization if needed. From the SmartFIRE portal homepage, click on the “sign up” link to access the registration page.

Sign-up

Complete the registration form with your organization, personal information, and password. Select the organization with which you are affiliated from the dropdown menu, and be sure to read and agree to the terms and conditions by checking the box.

Confirm email

After you have filled out the account creation page, click the sign up button. A new page will appear confirming that your information was received and an activation link has been sent to your email.

Confirmed

You will receive a confirmation email on the email account with which you have registered. Click on the activation link in the email, and you will be taken to a new page directly on the SmartFIRE portal. Please check your spam box if you do not receive the email in a few minutes. Please note that even after activating your account, you will still have limited access to the portal until the manager from your institution validates your request.

Once a manager has validated your account request, you will receive a notification email. You will now have full access to the SmartFIRE portal. In the event that a manager does not validate your request, you will also be notified by email.

Request Validation

A manager is notified by email about the user sign-up and can validate or reject the request. A link is provided in the email to validate or reject the request in the portal.

Once you have been approved by a manager of your organization, you will have full access to create projects and slices, and to browse and reserve resources on the portal. This section shows you how to manage your username and password that have been created and are used to connect to the portal; download your public and private key pair that is used for testbed access; and delegate credentials that you give to the public/private key pair in order to allow the portal to access the testbeds on your behalf.

Dashboard

Log into the portal using your email and password. You will be taken to the dashboard, which lays out the different menus available. Your dashboard provides links that take you to four different centers: experiment, account, management and support. The experiment center will display your different projects and slices, and through this link you can create a slice, reserve resources, and deploy your experiment. The account center lets you manage your account settings, change your password, and download your public and private keys. Through the management center, you can find all the information about your institution, and the other users and projects belonging to your institution. If you are a manager of your institution, the management center is where you can accept or decline requests from other users to join the institution or to join and create projects within the institution. The support center will bring you to the FAQs page, where you may find information about any questions that you may have, as well as how to contact the SmartFIRE support team.

Account

You may click on your “account” link from the dashboard to manage your account. From the “User Profile” tab, you may download your public and private keys, generate new keys, download configuration files, and change your username and password.

On the “Account” tab, you may see the details of your account, including the expiration date of your credentials. Normally, your credentials will be automatically renewed; however, should you need to renew your credentials, you may do so by clicking on the “clear credentials” button on this page.

Create a Project

Projects are the means through which users are organised within SmartFIRE. A project is composed of a set of users, and within a project exists one or several slices. In this section, we will show you how to set up a project, add slices to a project and add resources to a slice. In order to run an experiment on SmartFIRE, you do so by creating a slice. A slice is a collection of testbed resources —such as wireless nodes, virtual machines, etc.— that you will use in your experiment, plus the users who are authorised to access the resources. All of the users within a project are able to access the project’s slices. Once your account is set up on and you have full access to the portal, you may create a new project and/or join an existing one to begin experimentation. First begin by clicking on the link for “Create/Join project” on the portal dashboard. To create a new project, complete the form with the project name, the authority under which the project belongs, and a short description of the project. Click on “send request” and a new page will appear confirming that your project was sent. You will be notified when the manager of the project’s authority has validated your request.

Once a manager from the project’s authority has validated your request, you will receive a confirmation email. You may then log back into the portal and your new project will appear on the dashboard.

Join an existing project

If you wish to join an existing project, click on the tab “join existing project.” Choose from the list of projects to select the one that you wish to join. On the right hand side of the page, you will see a list of the projects that you belong to.

Project Management

From the dashboard, click on the project name to view information about the project, and manage users. To remove a user, click on the “users” tab and select the users that you wish to remove from the project.

If someone requests to join a project that you have created, an email will be sent to notify you of their request. To accept or deny their request, either click directly on the link in your notification email or from the dashboard, click on the link for your project. You will then be taken to your project management page, and you may view pending requests on the “requests” tab.

Slices

Once you have created or joined a project, you may now create a slice and reserve resources to begin experimentation. From your dashboard, click on the “create slice” link and complete the form, filling out the necessary information and selecting the project under which you wish to create the new slice.

Your new slice will appear in the dashboard under its corresponding project.

Reserve resources

Click on the slice name from the dashboard to view the available resources that you may add to your slice. You will be taken to a page that displays all of the available resources in a table view. You find this table in the middle of the page, listing all of the resources on all of the testbeds. There are several columns displayed in the resource table on your slice’s homepage. We describe in the section below the different ways in which you may filter resource view. We will first go into more detail about the resource table itself, and explain the meaning behind the different columns. The resources are identified by the resource name, testbed, and facility columns in the table. The leftmost column of the table consists of a checkbox: if this box is checked, it means that that the particular resource belongs to the slice. What you will be doing in this table view is checking additional resources in order to add them to your slice, and unchecking any already checked resources to remove them from your slice.
Loading...