Readme

This a the material for a "Train the Trainers" event.

The trainers are preparing to deliver the NeCTAR cloud lessons.

Thus they must be familiar with the basics of the NeCTAR cloud. These are the topics they should be comfortable with:

  • Security groups
  • Key pairs
  • Launching an instance
  • Ephemeral drives
  • Snapshots
  • ssh
  • The Linux command line
  • The object store

Attendees prerequisites for this course

  1. [ ] A laptop
  2. [ ] Internet access
  3. [ ] A GitHub account
  4. [ ] Git locally installed
  5. [ ] An active account on the NeCTAR dashboard

Git

If you check this repository out be aware that it uses Git submodules to manage the reveal.js dependency. To also clone reveal.js, you will have to either:

# fetch it all in one hit
git clone --recursive https://github.com/MartinPaulo/ResOsTrainTheTrainer.git

Or:

# take it step by step
git clone https://github.com/MartinPaulo/ResOsTrainTheTrainer.git
git submodule init
git submodule update

To regenerate the slides

The SlideExtractor.jar in the root directory will re-create the slides if needed.

To run it ensure that the java version installed is java 8:

java -version

should return something along the lines of java version "1.8.0_65".

If it doesn't then install java 8 from here: http://www.oracle.com/technetwork/java/javase/overview/java8-2100321.html

Then in a command prompt in the root directory simply issue:

java -jar SlideExtractor.jar

You should see something like the following fly by:

Working on: ./Booklet/Booklet.md
Writing to: ./Presentation/Booklet.html
Writing to: ./Presentation/index.html

Remember to always walk through your slides if you regenerate them!

Etherpad

There is a Heat template to build an Etherpad server on the NeCTAR cloud. There is also an accompanying Etherpad that can be uploaded to an Etherpad server if you wish to use Etherpads..

Preparation for delivering the actual course.

To give the lessons, you need to

  1. Clone the repository
  2. Update the repository submodules
  3. Optional: Checkout the tag/branch you want to deliver
  4. Optional: Update the introductory slide with your name
  5. Optional: Regenerate the slides
  6. Open the lesson slides in your browser!

So, you, the presenter, will need to:

  1. [ ] Have an AAF account
  2. [ ] Have checked the training material out of GitHub
  3. [ ] Have a terminal of some kind that you can ssh into instances with

We suggest getting attendees to log onto the NeCTAR cloud, and to install any needed software before the day.

So before the day, send out an email message to attendees advising them of the prerequisites.

Find out about the venue. Does it have enough:

  1. [ ] Seats
  2. [ ] Tables
  3. [ ] Power points

Does the venue have:

  1. [ ] Network connectivity (wifi)
  2. [ ] Internet access
  3. [ ] A big display you can use
  4. [ ] A whiteboard (or paper) that you can draw on
  5. [ ] Pens (and cleaner for the whiteboard)

What kind of connectors do you need to bring along for your devices?

Do you have:

  1. [ ] Network connectivity (eg: are you banking on having EduRoam work for you, and have you tested that it is available and does indeed work for you...)
  2. [ ] Enough sticky notes, in two different colours, to hand out to attendees at the start and after each break
  3. [ ] A set of answer cards, enough for each learner, lettered 'A', 'B', 'C', 'D' and 'E' respectively.
  4. [ ] A set of three envelopes, at least one of which fits inside the other two, to describe ssh and man in the middle attacks.
  5. [ ] Any other props you might like to use?
  6. [ ] A set of spare pens for people to write on the sticky notes with (It would appear in this digital age a lot of people travel penless)?

The image to be used:

  1. [ ] Is the image named res_os_drupal7 available and public on the NeCTAR cloud?
  2. [ ] If you use it launch an instance, then ssh into the instance and run apt-get update & apt-get upgrade -y
    is the behaviour acceptable?
    
  3. [ ] Does it bring up the web page with the kittens? Make a snapshot so that you have a fall back image.
  4. [ ] If it's not there, or doesn't work as expected, make a new image to use.

Have you checked the slides are all as you expect?

On the day:

  1. [ ] Each learner will need a laptop with wifi access
  2. [ ] Do you need to deal with Chromebooks? Crosh Or Chrome Shell might be needed
  3. [ ] Each learner on the course must have an AAF logon
  4. [ ] Each learner must have an allocation on the Research Cloud that they can use

On the day for those that have expired trial projects you can:

  1. [ ] get them to pair up with others
  2. [ ] have a special tenancy for the lesson, and then add them to it on the fly. This may not a great solution as people in the tenancy will step on each others toes. But is has worked for us
  3. [ ] have someone on hand to extend their trial tenancies on the spot?

If you are going to stream people, devise and send out a pre-assessment questionnaire. We'd love a copy to add to these notes!

Afterwards...

  • If needed, send out a reminder email about the post day survey...
  • Collate the feedback. Is any of it actionable?
  • Remove users from a shared tenancy (if you had to add any)

Some links

results matching ""

    No results matching ""