manage_admin_info.rst

Updating Administrative Information

The Toolkit allows you to enter contact and location information about the host. This information will not only display on the main page but will be published in the perfSONAR Lookup Service allowing other testers to find your host. This page contains information on editing this information through the web interface.

For more information about your personal data read our Privacy Policy.

Accessing the Administrative Info Interface

1. Open http://<hostname> in your browser where <hostname> is the name of your toolkit host

2. Click on Edit in the host information section of the main page (A) or Configuration button in the right-upper corner (B) and login as the web administrator user created in the previous step.

   

3. Login using the web administrator username and password.

   .. seealso:: See :doc:`manage_users` for more details on creating a web administrator account
   
   

4. The page that loads can be used to edit your administrative information. See the remainder of this document for details on making specific edits.

   

Editing Host Information

1. On the Administrative Information tab enter the requested information in the provided fields.

   We value and respect your privacy. In order to update and save Administrative Information you will be required to agree to the perfSONAR Privacy Policy.

   Note

   Any personal data entered would be of the user's own responsibility and will by no means represent an obligation for the perfSONAR project. All the information you provide on this tab will be sent, recorded and made publicly available on the global perfSONAR Lookup Service. For more information about your personal data read our Privacy Policy.

   

   Special Topic: Administrative Information fields

   .. glossary::
   
       Organization Name
           The name of the organization to which this host belongs
   
       Administrator Name
           The full name of a person to contact about this host. For privacy reasons, we recommend you use a role or group name to be registered.
   
       Administrator Email
           The email address where correspondence regarding this host may be sent. Since this e-mail address should be used only for communication related to the operations of the specific node, it is highly recommended that a role or group e-mail address is used instead of a personal one.
   
       City
           The city where the host resides
   
       Country
           The country where the host resides
   
       ZIP/Postal Code
           The postal code of the location where the host resides
   
       State/Province
           The state, province or other country-specific region where the host resides. May be the 2-letter abbreviation if applicable.
   
       Latitude
           The latitude of the host as a decimal number between -90 and 90. Note that if you are in the southern hemisphere, this value should be negative.
   
       Longitude
           The longitude of the host as a decimal number between -180 and 180. Note that if you are in the western hemisphere, this value should be negative.
   

2. When you are done making changes, click Save at the bottom of the page.

Adding Node Metadata

Node metadata are optional tags that can be used as a means to describe a host on the Global node directory page. There are two types of metadata tags:

.. glossary::

    Node Role
        It describes the node roles in the domain. It helps potential users of this node to recognize the place of node installation in the owners' domain. You may select multiple Roles for a node.

    Node Access Policy
        It is used to indicate the access policy for a node: whether it's a public access node, private with no access, R&E only or with limited access. You may select only one Access Policy for a node.

In order to tag a node with metadata:

1. In order to add a Node Role, under Metadata, click in the field Node Role. A drop-down list shows with possible values. Click on a preferred value to select it. Repeat this step to add more tags.

   

2. In order to add a Node Access Policy, under Metadata, click in the field Node Access Policy. A drop-down list shows with possible values. Click on a preferred value.

   

3. You may also add a descriptive note in Access Policy Notes field which is a human readable text that can optionally be added to help further describe the access policy.

4. Click Save to apply your changes.

Deleting Node Metadata

You may remove a particular node metadata with the following steps:

1. Under Metadata, find the tag you wish to remove and click x beside the name.

   

2. Click Save to apply your changes.

Selecting From Existing Communities

Communities are self-defined tags that can be used as a means to search for a host on the Global node directory page. There are two ways to select from existing communities. One method is to select from the list of existing communities or by typing the known community (note that communities are case-sensitive):

1. Under Communities, click the field Select communities. A list will be shown with existing communities. Select your choice.

   

2. You may also start typing the known community in the field Select communities to match against existing communities.

3. Click Save to apply your changes.

Adding a Community

In case there is no existing community of your choice, add it manually by typing the community with the following steps:

1. Under Communities, click +Add a community

   

2. At the prompt, type in the community you want to add (case-sensitive) and click Add when done.

   

3. Click Save to apply your changes.

Deleting a Community

You may remove your host from a particular community with the following steps:

1. Under Communities, find the community you wish to remove and click x beside the name.

   

2. Click Save to apply your changes.