-- TaraMcQueen - 2010-11-23

Initial User login (GFDL only)

These instructions will simplify the boarding process to Gaea. Following these 3 steps will setup your account and set your standard configurations files automatically. If you prefer to manually do this, please see ConfigureGaeaConnection documentation. Step 1 and 2 can be completed at anytime independently of each other. Step 3 can only be completed an hour or so after Step 2. This is because a successful login will not happen until your certificates are signed by two other parties. Users who have already generated a certificate on the new analysis nodes here at GFDL will not need to generate a new certificate on Gaea as explained in Step 2. For these users, please disregard instructions 6,7 and 8 from Step 2.

IMPORTANT!! Users must have an active GFDL cryptocard with them and access to their GFDL workstation in order to proceed through these steps.

 

Step 1 (gfdl workstation .ssh/config setup)

1. Log onto your workstation (or public1)
   
2. open a command terminal
3. if you have a workstation at GFDL run this command terminal:
1. if you use a cryptocard ~gwp/bin/usersetup/setup-gfdl-ssh.pl
2. if you use a rsa token ~gwp/bin/usersetup/setup-gfdl-rsassh.pl
   
4. Else, if you work through Public1 and/or do not have a personal workstation at GFDL then run this command:
   
1. if you use a cryptocard ~tlm/bin/usersetup/setup-gfdl-ssh.pl
2. if you use a rsa token ~tlm/bin/usersetup/setup-gfdl-rsassh.pl

This step will insert the necessary configurations for ssh connections to the gaea system. After this is complete, users will only need to do an ssh gaea to connect to gaea. This script will also generate a backup of your original config file. This will be /home/$USER/.ssh/config.bak. Running this command will add all standard gaea configurations to what was preexisting. It will overwrite old gaea configurations if it matches the current format.

Step 2 (proxy certificate)

1. Log onto your workstation (if not already)
2. Open a command terminal (in not already)
3. Run the command ssh gaea
4. Enter your cryptocard
5. Answer yes for any yes/no questions.
6. Create a minimum of 3 words passphrase for your grid certificate. This will only occur if you did not already generate a passphrase for the new analysis nodes.
7. Confirm your passphrase
8. It will then prompt you for a "PASSCODE" -- at this point there's nothing further for you to do; hit Control-C to log off and wait until your certificate has been processed.

This set has generated your certificates. NOTE- You will not be able to fully log on until your certificate is signed and recognized. This will take some time on our side. You may keep attempting to log into gaea but anytime it asks you for a PASSCODE, it means your certificate is not ready yet. NOTE- Users who have already logged onto the analysis nodes will have already generated a certificate and will not need to do so here. In this case, they will only need to enter their cryptocard and that will log them onto their home directory on Gaea.

Your certificate is approved when you can do the following:

1. ssh gaea
2. enter cryptocard
3. enter passphrase (the one you generated in previously in step 2)
4. enter cryptocard again (generate new number)
5. you will be brought to your home directory which will have your First.Last> e.g. home1/Tara.McQueen>

AGAIN, if you can't log on or your are not prompted for the above inputs, you MUST WAIT and TRY AGAIN later. Step 3 cannot be completed until you have logged onto gaea.

Step 3 (After successful Gaea login)

1. Run this command in a gaea terminal: /ncrc/home1/Tara.McQueen/bin/usersetup/setup_cshrc_2.pl

This script allows users to automatically setup two gaea specific configuration files. This will create a .cshrc and a .ssh/config file.

---

Once these steps are complete, you are officially logged onto gaea and can start the hands on training course.