**__VERY IMPORTANT: __** if you encounter any problems while proceeding in accordance with the procedure or you notice that the current version of the portal does not correspond to the description, please report it to [[mailto:qcg@plgrid.pl|QCG Team]] or [[mailto:piontek@man.poznan.pl|Tomasz Piontek]].


**IMPORTANT:** The Eagle cluster is a part of the  Polish National Grid Infrastructure called "PLGrid, so to get access to it user needs to follow the PLGrid procedure. 

I'm really sorry that there is no English translation of the Portal.

===== Getting access to PSNC/PLGrid resources =====

To create an account and to get access to PLGrid infrastructure please follow the procedure below:

==== Create an account ====

1. please go the PLGrid Portal - [[https://portal.plgrid.pl|https://portal.plgrid.pl]]. 

2. You will be redirected to the log-in page. At the bottom of the log-in page please click **"Nie masz konta? Zarejestruj sie"** (Don't have an account? Register)

{{ ::1-logowanie_v3.png?400 |}}

3. Fill in the questionnaire:

{{ ::2-formularz_1.png?500 |}}

  * **Imie** - First name.
  * **Nazwisko** - Last name.
  * **Login** - The proposed user name. 
    * **IMPORTANT:** The login should begin with the "plg" prefix, must have between 6 and 15 characters and can not start with "pligid." The first character after the "plg" prefix can not be a digit.  Only lowercase letters and numbers are allowed in the login.
  * **Haslo** - Password. 
    * **IMPORTANT:** The password should consist of at least 10 characters, at least 5 of which should be different. It should contain characters from at least three of four categories: uppercase letters, lowercase letters, numbers, special characters! @ # $% ^ & * + - = _. The password can not contain the name, surname or login.
  * **Potwierdz haslo** - Confirm the password.
  * **Adres e-mail** - Email
    * **IMPORTANT** E-Mail has to be a real one, a confirmation message will be sent to it.
  * **Telefon** - Phone (you can cheat here).

4.  Go to the bottom of the page and continue ...
{{ ::3_formularz_2.png?500 |}}

  * **Czy jestes zarejestrowany w bazie Nauka Polska** - Are you registered in Polish Science Database - choose "Nie" - No.
  * **Warunki korzystania z Infrastruktury PLGrid** - PLGrid usage rules - select "Akceptuje warunki" - (I accept the usage conditions).
  * **Czy jestes Robotem?** Are you a robot? - answer according to the real state.

5. Press the green button **“Wyslij formularz rejestracyjny”** to submit a registration form.
{{ ::4_send_form_v2.png?500 |}}

==== Confirm registration ====

Go to the mailing box you provided during the registration and confirm the registration by clicking the first link in the mail you got.
The line with the confirmation link starts with: "Prosimy o potwierdzenie danych poprzez kliknięcie w ten link: <LINKK TO CLICK>".

**IMPORTANT** The link is active for 48 hours, then you have to contact plgrid operator and ask for sending a new one. In such a case you can ask me (Tomasz Piontek) to represent you.

==== Add affiliation ====

  * Login to the https://portal.plgrid.pl using your credentials. To login press the green button "Zaloguj się" (Login).
{{ ::5-logowanie_v3.png?400 |}}
     * **IMPORTANT** For some external locations it can be needed to "solve" a captcha.
  * Click **Afiliacje** (Affiliations) on the left site
{{ ::6-afiliacja_v2.png?700 |}}
    * **IMPORTANT** If you do not have the button please ensure you really confirmed your e-mail adress.
  * press **Dodaj** (Add) button
{{ ::7-add_aff_v2.png?700 |}}
  * **Dodawanie Afiliacji** - Adding affiliation. **Aby dodac afiliację wybierz swój status** - to add affiliation select your status 
    * Select - **Podopieczny pracownika jednostki naukowej** - "Charge" (person in someone else care)
{{ ::8-aff-type.png?700 |}}
  * Provide information about you supervisor for the PLGrid Infrastructure. For the VECMA project the person with this role is "Tomasz Piontek" from PSNC.
    * **Twoj opiekun** - your supervisor
      - **Imie** - first name - Tomasz
      - **Nazwisko** - last name - Piontek
      - e-mail: piontek@man.poznan.pl
      - OPI opiekuna - ignore and leave empty
{{ ::9-opiekun.png?500 |}}
  * Provide information about your Institution / Organization. 
    * **IMPORTANT**To simplify things all the VECMA Members can provide PSNC as a "home" Institution.
    * **Organizacja naukowa** - scientific organization
      - **Jednosta** - Unit - **Polska Akademia Nauk** (Polish Academy of Science). start typing Polska and you should get a hint
        - When you select the Unit a next edit will appear for a sub-unit
      - Podjednostka 1 - Sub-Unit. Provide **Instytut Chemii Bioorganicznej** (Institute of Bioorganic Chemistry). Start typing "Instytut C" to get hint
      - **Strona internetowa** (web page) - www.man.poznan.pl
      - **Nazwa Afiliacji** (name of the affiliation) - PSNC
      - **Dziedzina Nauki** - Science domain
      - **Kategoria** - Category - select "Nauki inzynieryjne i techniczne"
      - **Podkategoria** - subcategory - choose something
      - **Dzial** - Department - choose something
{{ ::10-instytucja.png?700 |}}
    * continue filling out the form
      * **“Zaufany agent"** - trusted agent (leave **“Nie”** - No)
      * **Data Weryfikacji Afiliacji** - Affiliation Expiration Data - leave the date proposed by the system. You will be able to prolong it later or I will prolong it confirming the affiliation.
{{ ::11-agent.png?600 |}}
    * Press **"Wyslij Afiliacje do weryfikacji"** (Send affiliation for verification)
{{ ::12-aff_send_v2.png?700 |}}
  * A new window will be opened with all the provided data and information that your request has been sent to be verified. Just close the window pressing the red "OK" button at the bottom of the window.
  * Your affiliation will appear on the list of affiliations with information that it is waiting for confirmation.
{{ ::13-aff-waiting.png?700 |}}
  * **IMPORTANT**Please send a message to [[mailto:piontek@man.poznan.pl|piontek@man.poznan.pl]] and wait until your affiliation will be confirmed by me. (you should be informed by the mail)

==== Applying for services ====

 Log in again to the https://portal.plgrid.pl and click **"Uslugi"** (Services) on the left side
{{ ::14-uslugi_v2.png?750 |}}
   * Press the green button - **Zarzadzaj Usługami** (Manage Services). You will be redirected to the Applications and Services Catalogue service.
{{ ::15-uslugi_v2.png?750 |}}
  * Use the **“Szukaj”** (Search) Edit to search for **"Globalny Dostęp QosCosGrid"** (Global Access to QCG)
{{ ::17-uslugi_v2_a.png?750 |}}
  * Apply for QCG by pressing the **“Aplikuj”** (Apply for) button
{{ ::17-uslugi_v2.png?750 |}}
  * **IMPORTANT:** To have local access to PSNC clusters via SSH protocol (optional) please apply also for **"Lokalny dostęp do klastrów PCSS"**.
{{ ::18-uslugi_v2.png?750 |}}
==== Requesting for the certificate (needed to use QCG) ====
  * go back to the [[https://portal.plgrid.pl|https://portal.plgrid.pl]] and click **"Certyfikaty"** (Certificates) link.
  * then in the section "SimpleCA" - press **"Wygeneruj certificate"** - Generate Certificate
{{ ::19-cert_v2.png?700 |}}
  * **Podaj haslo do konta** - provide account's password and press **"Generuj"** (Generate)
{{ ::20-cert_v2.png?700 |}}
  * **Zapisz certyfikat na dysku** - save your certificate on disk

==== Requesting for the testing grant ====
  * go to the PLGrid Portal [[https://portal.plgrid.pl|https://portal.plgrid.pl]]. On the left side please click "Granty". (You will be redirected to the Bazaar sytem).
  * in the Bazaar please select "Granty testowe" (on the left panel, just below "Granty")
  * press green button "Wlącz grant testowy" (apply for testing grant).
{{ ::23-grant_v2.png?600 |}}
  * to make the testing grant the default one please select "Granty". On the list of grants please click the one which name is "plg<USER><current year><a or b>.
{{ ::24-granty_v2.png?600 |}}
  * On the grant page (top/right corner) click "Ustaw grant jako domyślny" (set grant as default). 
{{ ::25-grant_v2.png?600 |}}
==== Make the "vecma" grant the default one ====
  * Log in to the PLGrid Portal [[https://portal.plgrid.pl|https://portal.plgrid.pl]]
  * On the left side choose "Zespoły" (Teams) and "Lista Zespołów" (List of Teams)
  * Check if the "VECMA-Members" Team is on the list of teams you belong to. If there is no such team please contact [[mailto:piontek@man.poznan.pl|Tomasz Piontek]]
{{ ::26-zespol_v2.png?700 |}}
  * on the left side please select Granty->Moje Granty (Grants->My grants)
  * In the "Granty Aktywne" (Active Grants) section find the vecma<YEAR> grant and select it
{{ ::27-grant_v2.png?700 |}}
  * on the grant page in the top-right corner click "Ustaw grant jako domyslny" button (Set as default).
{{ ::28-grant_v2.png?700 |}}
===== Another Issues =====
==== Re-creation of the certificate ====
  * go the the PLG portal ([[https://portal.plgrid.pl|https://portal.plgrid.pl]])
  * on the left side select "certyfikaty" - certificates
  * in the "SimpeCA" section press "Usuń" (remove) button
{{ ::29-cert_v2.png?700 |}}
  * create a new certificate following the procedure [[#Requesting for the certificate (needed to use QCG)]]

**IMPORTANT:** The key of the certificate will be encoded with the same password as you have to the PLGrid portal. Previously it was possible to have various passwords for portal and certificate. 

==== Registering of an EXTERNAL certificate in the PLGrid ====
**IMPORTANT:** Proceed this step only if the use of the PLGrid SimpleCA certificate is not suitable for you for some reason and you would like to use the certificate issued by another CA.

To register external certificate in the PLGrid infrastructure please follow the instruction below:
  * log in to the PLGrid portal: [[https://portal.plgrid.pl|https://portal.plgrid.pl]]
  * on the left side please choose "Certyfikaty" (certificates) option
  * go to the section "EUGridPMA" and press the "Zaladuj certyfikat z dysku" (load a certificate from the disk) button
{{ ::30-cert_v2.png?700 |}}
  * Press "Przegladaj" (Choose) button and select your certificate in p12 format.
  * Provide password to the *.p12 package (haslo do paczki) and to the key file (haslo do klucza)
  * press "Wyslij" (Send).
{{ ::32-cert_v2.png?700 |}}
  * press "Ustaw jako glowny certyfikat" (set as a main certificate).

Your certificate should be uploaded to the keyfs service and should appear on qcg.man.poznan.pl site.

**IMPORTANT:** If you have your certificate as a pair of pem files you can convert them to p12 using the following command:

openssl pkcs12 -export -descert -inkey userkey.pem -in usercert.pem -out usercred.p12 -name "national certificate"

===== Problems =====
**PLEASE REPORT ALL PROBLEMS TO [[mailto:qcg@plgrid.pl|QCG Team]] or to [[mailto:piontek@man.poznan.pl|Tomasz Piontek]]**

Do not blame us for portal stability and functionality.
It was written by Cyfronet team from Cracow.
