Configuration
 
Exercise 1 - Configuring Node Services Using Node Management

  1. If you have a camera, connect it to your laptop and add a VideoProducerService

    In the Venue Client
    1. Preferences -> Manage My Node....
    2. Service -> Add..., VideoProducerService

  2. Connect to https://vv2.ap-accessgrid.org:8000/Venues/default and make sure others can see video from you.

  3. Enable and disable services.

    In the Venue Client:
    1. Preferences -> Manage My Node
    2. Select VideoProducerService, then Service Disable

    Your video should stop transmitting. Select Enable again and your video should start sending again.

  4. Save the node configuration as default

    In the Venue Client:
    1. Preferences -> Manage My Node...
    2. File -> Store Configuration.
    3. Enter a name for the configuration and check the Set as default check box

    The settings should now load everytime you start the Venue Client.
Exercise 2 - Configuring Node Services Using Node Setup Wizard

  1. Try the node setup wizard

    In the AGTk menu
    1. Configure -> Node Setup Wizard

    The node setup wizard is a second tool for creating node configurations as you did in exercise 1. Follow the instructions in the wizard to create a configuration file.


  2. Load the new configuration

    In the Venue Client
    1. Preferences -> Manage My Node...
    2. File -> Load Configuration
    3. Select the new configuration

Exercise 3 - Certificates

  1. Request an identity certificate

    In the AGTk menu:
    1. Request a Certificate.
    2. Follow the instructions in the wizard.


  2. Install the certificate

    In the Venue Client
    1. Preferences -> Certificate manager...
    2. Certificate Requests tab.
    3. Select the new request and click Check Status.
    4. When the status says Ready, select Install Certificate.


  3. Find the expiration date of the certificate

    In the Venue Client:
    1. Preferences -> Certificate manager...
    2. Certificates tab.
    3. View Certificate button.

    Note: A certificate is valid for 1 year.


  4. Set the new certificate as default

    In the Venue Client:
    1. Preferences -> Certificate manager...
    2. Certificate tab
    3. Select your identity certificate and click Make Default


  5. Destroy and create a proxy

    In the Venue Client
    1. Preferences -> Certificate manager...
    2. Proxy tab
    3. Select the proxy and click Destroy

    A proxy dialog will open next time you need one.
Exercise 4 - Running and Managing a Server

 

  1. Start a Venue Server from the AGTk menu.

    Linux: /usr/bin/VenueServer

  2. Use the Venue Management Tool to add a venue.

    In the AGTk menu
    1. Venue Management Tool
    2. Connect to the venue running at https://localhost:8000/VenueServer.
    3. Add
    4. Enter information, then Ok

    Also, add this venue as exit for the lobby

    In Venue Management
    1. Select the Venue Server Lobby
    2. Modify
    3. In the Exits section, add the new venue as exit, then Ok

  3. With your Venue Client, enter https://localhost:8000/Venues/default and walk to the new venue.

  4. Set static addressing for the new venue.

    In Venue Mangement
    1. Select the new venue
    2. Modify
    3. Addressing tab
    4. Use Static Addressing, and then Generate New Addresses

    Multicast addresses for this venue will now always stay the same.

Exercise 5 - Running a Bridge

 

  1. Download the BridgeServer.cfg file.

  2. Change the values in the configuration file, make sure to uncomment the correct value for the qbexec executable for your platform.

  3. Start a server on your local machine, see Exercise 4.

  4. Run the bridge

    Windows: python c:\Program Files\AGTk-2.4\bin\BridgeServer.py -c /path/to/BridgeServer.cfg

    Linux: python /usr/bin/BridgeServer.py -c /path/to/BridgeServer.cfg

    Mac: pythonw /Applications/AccessGridToolkit.app/Contents/Resources/bin/BridgeServer.py -c /path/to/BridgeServer.cfg

    Note: OSX users will first have to source the file /Applications/AccessGridToolkit.app/Contents/Resources/setupenv.sh


  5. From a different computer (the bridge and media tools can not run on the same machine) start the Venue Client. Enter the venue to where the bridge is pointing.

  6. Use the bridge

    In the Venue Client:
    1. Preferences -> Use Unicast

    Make sure your media tools works when using the bridge. Also check that the media tools are pointing to a unicast address

    In the Venue Client
    1. Venue - Properties

Exercise 6 - Running the Toolkit from CVS

 

  1. Check out the AG toolkit from the 2.x branch.

    Linux:
    setenv CVSROOT :pserver:[email protected]:/cvs/fl
    cvs login
    cvs checkout -r r_2_3_final AccessGrid

    Windows:
    The following instructions are intended for use with WinCVS 1.3.

    Specify the CVS Repository in the WinCVS preferences dialog box.
    This is available from the Admin - Preferences Menu.

    For the CVSROOT enter "[email protected]:/cvs/fl". For the Authentication setting choose "pserver".
    To check out a copy of the code, choose the Checkout module
    command from the Create menu. For the module name, enter "AccessGrid".

  2. Go to AccessGrid/tools. Run

    python CvsSetup.py -a ..

    This will create a setup script env-init.xxx.

  3. Set your environment variables

    Windows: Run the env-init.bat file
    Other: Source the env-init.xxx for your shell.

  4. Run

    AccessGrid/bin/VenueClient.py