JBoss Classroom Usage Instructions

This document will step you through the process of installing a JBoss Classroom and assumes that you have already built the CD and USB drives (See JBoss Classroom Quick Start for details if you have not yet created these).

Table of Contents
Instructor Machine Setup...........................................................................................................................1 Course Materials....................................................................................................................................2 Troubleshooting.....................................................................................................................................2 Student Machine Setup..............................................................................................................................3 Windows................................................................................................................................................3 Red Hat Enterprise Linux......................................................................................................................3 Instructor Machine Usage..........................................................................................................................3 Classroom Wipe Procedure ..................................................................................................................4

Instructor Machine Setup

1. Plug in the USB drive and insert the CD (you may have to power on the machine briefly for the latter) 1. If you do not have the CD, please burn a copy using the .iso file found in /courses 2. Power on (or restart) the machine and boot from the CD (If the system will not boot from the CD, F12 usually brings you to the boot menu, but different machines run on different BIOS which may use different conventions the initial startup screen should provide the information you need) 3. Strike F4 to view the JBoss Classroom options 4. Type jbserver 5. Select Hard Drive for the Installation Method 6. Point the installer at your install media 1. Select your USB drive (usually an sd_1 at the bottom of the list) 2. Enter rhel5/Server 3. Select OK 7. Select your timezone 8. Wait 9. Log in using username instructor, password jboss Note: The root account on this machine is disabled, but the instructor account has been given full sudo access. If you wish to run a full root account (not recommended), you may access the root account via sudo su -

Course Materials
All the RPMs placed in the repos/courseware directory on the USB key can be installed using yum commands on the instructor machine. For instance:

sudo yum install JB336c sudo yum install JB295

Any installers necessary for the class should be copied from installers/ to the coursematerials folder on the instructor's desktop to the student's workstations (see below). Additionally, look on the Desktop for any follow-on instructions which may be directly related to the course being taught. JB336, for instance, has some additional steps that must be taken postinstall to complete the instructor system setup for the course.

Troubleshooting
If GRUB Hangs during the reboot: Step 1: Reboot the machine and verify BIOS setting *Make sure CD/DVD is first bootable device (not USB Stick) *Reboot & see if problem resolves (if not follow next Steps) Step 2: Plug in USB Stick and re-boot from CD Step 3: Type linux rescue at boot: prompt. Follow instructions and tell it to get materials from the USB stick as you would during an install. Step 4: Follow the instructions until you get to a command prompt, then run chroot /mnt/sysimage Step 5: Edit /boot/grub/grub.conf and change all instances of "hd1" to "hd0". Step 6: Edit /boot/grub/device.map so it contains only the following line:(hd0) /dev/sda Step 7: Run: grub-install /dev/sda Step 8: Reboot by typing "exit" twice The machine should now work. Note: Another way to solve this issue, and one which may make any other strange issues you might

have during boot magically disappear, is this: 1. Start the install process with the CD in the drive, but do not plug in the USB key yet. 2. When the install process reaches the Installation Method screen, then plug in your USB key. 3. Choose Hard Drive, and click OK. 4. Your USB key should be the last entry on the list. If you only see entries reflecting your hard drive (which is likely blank), click Back, and repeat the previous step until you see your USB key show up. You might have to go back several times before the key shows up, but it will, eventually. 5. The purpose of this is to ensure that your USB key is not the first hard drive seen on the system. If it is seen as the first hard drive, this will cause all sorts of problems with the boot sequence later on.

Student Machine Setup

Windows
If the student chooses Windows and are in a classroom that supports it, they should: 1. Open the Network Neighborhood 2. Open Server1 3. Open the CourseMaterial share 4. Copy the contents to their desktop

Red Hat Enterprise Linux

If the student chooses to use Red Hat Enterprise Linux, they should: 1. Power on (or restart) the machine and boot from the Network (F12 usually brings you to the boot menu, but different machines run on different BIOS which may use different conventions the initial startup screen should provide the information you need) 2. Enter jbworkstation at the prompt 3. Wait 4. Log in using username student, password jboss 5. Copy files from the CourseMaterial folder on the desktop to the desktop

Instructor Machine Usage

Here are some notes to get you familiar with the new Instructor Machine

Root accounts have been disabled

Execution of privileged commands must be prefaced with sudo No additional password entry is required

Use of sudo instead of direct root access is considered to be a Best Practice, especially for instructors with limited Linux/Unix experience

Any materials to be distributed to all students should be placed in the coursematerials desktop folder

The RPM installation of courses will generally provide all required student materials in this directory already, and we are actively moving towards making all courses distributed via RPM

All presentation files are located in the presentations desktop folder The Instructor can control access to the internet (i.e. to remove distractions during lecture) by clicking the two plugs icon in the upper right

Click to turn on network access (icon is plugged) Click once more to turn it off (icon is unplugged)

Students should complete the roster on day one at http://server1/cgibin/roster.cgi

Students should complete the survey on the last day at http://server1/rhsurvey

To collect the rosters and/or survey results, run (with your USB drive mounted): sudo /usr/bin/roster-collection.sh

This will dump these files to a folder on your USB drive

If your USB drive is unavailable, the roster/survey files are in the /var/www/ks/state directory, and you can copy them with:

sudo cp /var/www/ks/state/* /path/to/copy/to/.

The roster/survey files are very important for Red Hat Global Learning Services. Please be sure to e-mail these files to [insert person here] as soon as possible after class.

Classroom Wipe Procedure

The following process is designed to be initiated at the end of each class to be sure we do not accidentally leave any of our proprietary data lingering for others to find.

With your USB drive mounted, run: sudo /usr/bin/classcleanup.sh

This, too, will collect surveys and rosters onto the inserted USB drive

Manually reboot all Windows machines with the CD and enter metadestroy This will attempt to reboot all RHELbased systems via netboot Check each machine if it has not rebooted, initiate a network boot and enter metadestroy When prompted, remove your USB drive and hit Enter Wait

Leave and enjoy your weekend