how to install and conï¬gure ag 2.1 on a single machine node (pig

How To Install and Configure AG 2.1 on a SingleMachine Node (PIG), for Windows

Jennifer Teig von HoffmanBoston University

[email protected]

Cindy SieversLos Alamos National Laboratory

[email protected]

How To Install and Configure AG 2.1 on a Single Machine Node (PIG), for Windowsby Jennifer Teig von Hoffman and Cindy Sievers

Copyright © 2003 by Boston UniversityLos Alamos National Laboratory

Permission is hereby granted to use, reproduce, to redistribute copies to others, and prepare derivative works.Any use or publication of the material shall acknowledge the copyright of [copyright holder] in an appropriatemanner which shall include the legend "© 2003 by Trustees of Boston University and Los Alamos NationalLaboratory, LA-UR-03-4995, includes materials developed by and/or derived from the Access Grid project(http://www.accessgrid.org)."

Revision History

Revision 1.3.1 March 10, 2004Small revision to fix a typo and to emphasize that prerequisites must be installed before ToolkitRevision 1.3 December 3, 2003Updated to support AG 2.1.2Revision 1.2.1 September 16, 2003Additional revisions to support AG 2.1.1bRevision 1.2 September 8, 2003Substantial revisions to conform to AG 2.1.1bRevision 1.01 July 10, 2003Changed "Video Device Setup" to "Install AG Toolkit" and reordered sectionsRevision 1.0 June 27, 2003

Table of Contents1. Introduction ................................................................................................................12. Installation Instructions ...........................................................................................3

Uninstall any previous versions of Access Grid Toolkit 2.x ...........................3Download and install all required prerequisite software................................3Install AG Toolkit ..................................................................................................4

3. Starting Up Your Personal Node.............................................................................5Requesting or Importing Your Globus Certificate............................................5Running the Venue Client ....................................................................................5Configure Venue Client ........................................................................................6Save Configuration ...............................................................................................7

iii

Chapter 1. Introduction

These instructions are written specifically for a Personal Node Installation (PIG)of Access Grid Toolkit 2.1 on Windows. These instructions are based specificallyon a Windows XP installation, but should apply to other Windows flavors as well.The exact version these instructions were tested on is 2.1.2.

Important: If you have installed previous releases of AG Toolkit version 2.x (such as betasoftware, RC1, or other 2.x releases), or of any of its prerequisites, you should uninstallthose before beginning to install AG Toolkit 2.1; before uninstalling, be sure to exportyour Globus certificate and key, as they can be used in your new installation, using theinstructions in this document. You must uninstall Windows Globus as well if that waspreviously installed. AG Toolkit 1.x installations, however, can happily co-exist with AG2.x installations, and do not need to be removed.

The authors would like to express thanks to Brett Ellis of University of Tennesseefor testing the instructions of this document, and to Bob Olson and SusanneLefvert of Argonne National Laboratory for their excellent and patient help.

1

Chapter 1. Introduction

2

Chapter 2. Installation Instructions

Uninstall any previous versions of Access Grid Toolkit 2.xBefore installing version 2.1.2, you need to remove any previously-installed ver-sions of the 2.x AG software. AG 1.x, on the other hand, can remain installed.

Before removing the previously-installed 2.x software, you should export a copyof your Globus certificate, as it can be used in the new installation you are prepar-ing to create. The method for doing so depends on the version previously in-stalled:

• Version 2.0: When you requested and installed your certificates using version2.0, you used a mostly-manual process to create and configure your user cer-tificate and user key files. They may have been saved under the default names"userkey.pem" and "usercert.pem"; you may have placed them in the defaultlocation C:\Documents and Settings\user-name\Application Data\globus\.Find these files and move them to another location, outside of your AG 2.0installation; you will need them when you install versionn 2.1.2.

• Version 2.1: Download the file certmgr.py1, a utility for certificate management.It is preferred (but not necessary) to save this file to the bin/ directory in yourAG 2.1 installation. Once you have downloaded the file, create a commandprompt window in the directory where you have saved the file. In this com-mand prompt window, type "certmgr.py", which will bring up a new prompt.

At the certmgr prompt, type "list", for a list of the certificate(s) installed in yourcurrent AG2 client. Next, type "export [number] [location]", where "number" isthe number associated with the certificate you want to export, and "location"is the location to which you would like the exported certificate to be saved. A.pem file of your user certificate and key will be created in the location whereyou have run the command. Save this file somewhere outside of your AG 2.1installation directories; you will need it after you install 2.1.2.

After you have found or exported your certificate and key files and moved themto a save place, you can remove the previous version of AG2 using the Start Menuicon "Uninstall the AGTk."

Download and install all required prerequisite softwareIt is necessary to download and install the prerequisite software listed below be-fore installing AG Toolkit.

Install the prerequisite software in this order:

• ActiveState Python 2.2 (which includes the Win 32Extensions)

Selecting ActivePython 2.2 from the software download page below will takeyou to the Python web site. From here, download the most recent stable releaseof Python for your platform.

3

Chapter 2. Installation Instructions

• wxPython-2.4.0

Selecting xwPython from the software download page below will take you toa page of mirror sites where you can download wxPython. The installer willagain guide you through a typical installation.

Software can be downloaded from the following site:

http://www-unix.mcs.anl.gov/fl/research/accessgrid/software/releases/2.1.2/windows.html

Install AG ToolkitInstall the AG Toolkit, found at http://www-unix.mcs.anl.gov/fl/research/accessgrid/software/releases/2.1.2/index.html.As discussed in the previous section, it is necessary that you uninstall any alpha,beta, RC, or release versions of AG 2.x before installing AG 2.1.2; any existingAG 1.x installations may remain.

Notes1. http://fl-cvs.mcs.anl.gov/viewcvs/viewcvs.cgi/*checkout*/AccessGrid/bin/certmgr.py

2. http://www-unix.mcs.anl.gov/fl/research/accessgrid/software/releases/2.1.2/windows.html

3. http://www-unix.mcs.anl.gov/fl/research/accessgrid/software/releases/2.1.2/index.html

4

Chapter 3. Starting Up Your Personal Node

Requesting or Importing Your Globus CertificateFrom the Start Menu, select "Access Grid Toolkit", "Venue Client". (Or, you maychoose to select "Venue Client (Debug Mode)".)

The first time you enter the Venue Client, you will be prompted to request aGlobus certificate, as well as to enter your personal profile information. The stepsyou will take to request or import a certificate are as follows:

• If you already have a certificate: When prompted to request a certificate, click"cancel", and then respond "yes" to the dialog box which will ask whether youwant to start the Venue Client without a certificate. Within the Venue Client, se-lect "Preferences", "Manage Certificates", "Import Identity Certificates" from thepull-down menu. You will then be prompted to identify the locations of yourusercert.pem and userkey.pem files, and next prompted for the passphrase youcreated when you requested this certificate. After doing so, you will need toexit and re-start the Venue Client in order to be able to successfully connect toan AG session

• If you do not already have a certificate: When prompted to request a certificate,follow the steps in the certificate request wizard, filling out all requested infor-mation. For the field "domain", list the DNS domain of the organization withwhich you are affiliated. After you complete the wizard, you will receive a re-sponse to your request within 2 business days. Once you have been informedthat your request has been approved, open the Venue Client (using "cancel" tobypass the certificate request), and select "Preferences", "Manage Certificates,""View Pending Requests". Within the window that will appear, highlight thecertificate request which has been approved and click "Import Certificate." Youwill then need to exit and re-start the Venue Client to be able to successfullyjoin an AG session.

Running the Venue ClientFrom the Start Menu, select "Access Grid Toolkit", "Venue Client". (Or, you maychoose to select "Venue Client (Debug Mode)".)

Depending on the amount of time that has elapsed since you last ran the VenueClient, you may be prompted to create a Globus Grid Proxy. To do so, you willneed to enter the passphrase you created when you requested your Globus cer-tificate. If you wish to change the default duration or key size of your proxy, clickon the "details" button.

In the Venue Client, you’ll see your default venue address, with a button next toit labeled "Go". (Your default venue is probably ANL’s Transitional Venue Server,unless you changed it in your profile.) Click "Go" to connect to the venue (or, typein whatever other venue you might want to connect to, and then click "Go.")

5


Configure Venue ClientThe first time you connect to a venue, you will need to configure your VenueClient to transmit video, if desired. Your various media applications should startautomatically upon connecting to the venue.

From the pull-down menus in your Venues Client, select "Preferences," "Man-age my Node". In the Node Management window that appears, highlight "local-host:12000"

From the pull-down menus in the Node Management window, select "Service,""Add." In the window that will appear, select "VideoProducerService" and click"OK".

Confirm your camera selection as prompted. For many users, this means selecting"Microsoft WDM Image Capture (Win32)", but your configuration details may be

6


different depending on the camera you’re using.

AudioService and VideoConsumerService usually work with the default config-uration, and therefore do not need to be altered.

Save ConfigurationYou may save your node configuration the first time you run it, so you won’tneed to manually re-start the VideoProducerService each time. To do so, in theNode Manager, select "File," "Store Configuration" from the pull-down menu.

Select the "defaultWindows" option and click "OK." Or, if you prefer, choose an-other name for this configuration, which you may or may not choose to make thedefault.

Your screen should now have the following windows displayed:

• AccessGrid Venue Client

• Rat

• VIC thumbnails

7


Remember, you need to click "Talk" on RAT to transmit audio. To go to a differentvirtual venue, simply click on the doorway to that venue. A Text tool is includedin the Access Grid Venue Client window. Simply type your text into the text boxlabeled "Your Message" and it will appear in the dialog box directly above it.Other participant’s text will appear in the dialog box as well.

8