Project

General

Profile

« Previous | Next » 

Revision 4801

Added by daigle almost 16 years ago

Add instructions for how to test the web registry, web ldap, and ecogrid registry service.

View differences:

docs/dev/testing-metacat.html
53 53
      <div class="toc2"><a href="#ManuallyRunScripts">Manually Run Scripts</a></div>
54 54
    <div class="toc1"><a href="#UserTesting">User Testing</a></div>
55 55
      <div class="toc2"><a href="#TestingSkins">Testing Skins</a></div>
56
      <div class="toc2"><a href="#TestingWebLDAP">Testing LDAP Web Interface</a></div>
57
      <div class="toc2"><a href="#TestingRegistry">Testing Metadata Registry</a></div>
58
    <div class="toc1"><a href="#TestingEcogridRegistry">Testing the EcoGrid Registry Service</a></div>
56 59
  </div>  
57 60
  
58 61
  <a name="Intro"></a><div class="header1">About Metacat Testing</div>
......
255 258
  <li>View main skin page by going to:
256 259
    <div class="code">http://dev.nceas.ucsb.edu/knb/style/skins/&lt;skin_name&gt;</div>
257 260
  for each skin, where &lt;skin_name&gt; is in:
258
    <div class="code">default, nceas, esa, knb, kepler, lter, ltss, obfs, nrs, sanparks, saeon</div>
261
    <div class="code">default, nceas, esa, knb, lter, ltss, obfs, nrs, sanparks, saeon</div>  
262
  Note that the kepler skin is installed on a different metacat instance and can be found at:
263
    <div class="code">http://kepler-dev.nceas.ucsb.edu/kepler</div>
259 264
  </li>
260 265
  <li>Test logging in.  Where applicable (available on the skin) log in using an LDAP account.</li>
261 266
  <li>Test Basic searching
......
297 302
     <li>view contents for basic validity (contents exist, etc)</li>
298 303
     </ul>
299 304
  </li>
300
  <li>Downlaod Data
305
  <li>Download Data
301 306
     <ul>
302 307
     <li>Choose the data download</li>
303 308
     <li>view the data for basic validity (contents exist, etc)</li>
......
310 315
     <li>view the data table for basic validity (contents exist, etc)</li>
311 316
     </ul>
312 317
  </li>
313
    
318
  </ul>
319
   
320
  <a name="TestingWebLDAP"></a><div class="header2">Testing LDAP Web Interface</div>  
321
  <p>The following skins use a perl based LDAP web interface to create
322
     accounts, change passwords and reset forgotten passwords: </p>
323
     <div class="code">default, nceas, esa, knb, lter, ltss, obfs, nrs, sanparks, saeon</div>
324
  <p>Following the instructions in the <a href="#TestingSkins"> Testing Skins</a>  section
325
     go to each of these skins and test:</p>
326
  
327
  <ul>
328
  <li>Create LDAP Account
329
    <ul>
330
    <li>Choose the "Create a New Account" link</li>
331
    <li>Fill out the required information.
332
      <ul>
333
      <li>Choose a username that will be easy to find and remove from ldap later.</li>
334
      <li>Use your real email address</li>
335
      </ul>
336
    </li>  
337
    <li>Hit the "Register" button</li>
338
    <li>You may see a page with similar accounts.  If so, choose to continue.</li>
339
    <li>You should get a "Registration Succeeded" message.</li>
340
    </ul>
341
  </li>  
342
  <li>Change LDAP Password (if available)</li>
343
    <ul>
344
    <li>Choose the "Change Your Password" link</li>
345
    <li>Fill out the requested information</li>
346
    <li>Hit the "Change password" button</li>
347
    <li>You should get a "Your password has been changed" message.</li>
348
    </ul>
349
  </li>   
350
  <li>Request Forgotten LDAP Password Reset
351
    <ul>
352
    <li>Choose the "Forgot Your Password" link</li>
353
    <li>Enter your username</li>
354
    <li>Hit the "Reset Password" button</li>
355
    <li>You should get a "Your password has been reset" message.</li>
356
    <li>You should get an email with your new password</li>
357
    <li>Verify that you can log in with the new password</li>
358
    </ul>
359
  </li>
360
  </ul>
361
   
362
  <a name="TestingRegistry"></a><div class="header2">Testing Metadata Registry</div>   
363
  <p>The following skins use a perl based registry service to register metadata and
364
     data in metacat via the web: </p>
365
     <div class="code">nceas, esa, ltss, obfs, nrs, sanparks, saeon</div>
366
  <p>Following the instructions in the <a href="#TestingSkins"> Testing Skins</a> section
367
     go to each of these skins and test:</p>
368
     
369
  <ul>
370
  <li>Choose the "Register Dataset" link</li>
371
  <li>Fill out required fields.  Note that there are typically many different fields.  
372
      You should test out different combinations including attaching datasets if
373
      available.</li>
374
  <li>Hit the "Submit Dataset" button</li>
375
  <li>Review the information for accuracy</li>
376
  <li>Submit the data set</li>
377
  <li>You should get a "Success" message.</li>
378
  <li>Search for the data set in metacat and review for accuracy</li>
379
  </ul>
380
       
381
  <a name="TestingEcogridRegistry"></a><div class="header2">Testing the EcoGrid Registry Service</div>  
382
  <p>The EcoGrid registry service maintains a database of systems that are available to EcoGrid. Primarily, 
383
  these are Metacat instances which are built with the EcoGrid service automatically activated.  Testing
384
  the registry service is somewhat complicated.  The procedure described here uses Eclipse to test. 
385
  These instructions assume that you have Eclipse installed and the Seek project set up as a Java project
386
  in Eclipse.</p>
387
  
388
  <ul>
389
  <li>Configure the Seek project in Eclipse
390
    <ul>
391
    <li>Right click on the Seek project and go to Properties->Java Build Path->Source</li>
392
    <li>Only the following two direcories should be set up as source:
393
      <ul>
394
      <li>seek/projects/ecogrid/src</li>
395
      <li>seek/projects/ecogrid/tests</li>
396
      </ul>
397
    </li>
398
    <li>Right click on the Seek project and go to Properties->Java Build Path->Libraries</li>
399
    <li>Add all Jars from:
400
      <ul>
401
      <li>seek/projects/ecogrid/lib/</li>
402
      <li>seek/projects/ecogrid/lib/axis-1_3/</li>
403
      <li>seek/projects/ecogrid/build/lib/</li>
404
      </ul>
405
    </li>  
406
    <li>If you do not already have an Ant view open in Eclipse, in the menu, go to 
407
        Window->Show View->Ant</li>
408
    <li>drag the file from the seek project at seek/projects/ecogrid/build.xml into
409
        the Ant window you just opened.</li>
410
    <li>Double click the serverjar and stubjar targets to build those jar files.<li>
411
    <li>Right click on the Seek project and go to Properties->Java Build Path->Libraries</li>
412
    <li>Add the two Jar files you just created:
413
      <ul>
414
      <li>seek/projects/ecogrid/lib/RegistryServiceImpl.jar</li> 
415
      <li>seek/projects/ecogrid/lib/RegistryService-stub.jar</li>   
416
      </ul> 
417
    </li>  
418
    </ul>
419
  </li>
420
  <li>View the RegistryServiceClient usage
421
    <ul>
422
    <li>In Eclipse, go to the registry service client at: <br>
423
        seek/projects/ecogrid/src/org/ecoinformatics/ecogrid/client/RegistryServiceClient.java</li>
424
    <li>Right click on RegistryServiceClient.java and go to Run As->Open Run Dialog</li>
425
    <li>Name it something like "RegistryServiceClient noargs" since you are running it without arguments.</li>
426
    <li>Hit the "Apply" button and then the "Run" button.</li>
427
    <li>Proceed past the project error warning dialog</li>
428
    <li>In the Eclipse console you should see usage instructions that look like:
429
      <ul>
430
      <li>Usage: java RegistryServiceClient add session_id local_file GSH</li>
431
      <li>Usage: java RegistryServiceClient update session_id  docid local_file GSH</li>
432
      <li>Usage: java RegistryServiceClient remove session_id docid GSH</li>
433
      <li>Usage: java RegistryServiceClient list session_id GSH</li>
434
      <li>Usage: java RegistryServiceClient query session_id query_field query_string GSH</li>
435
      </ul>
436
    </li>
437
    <li>Note: now you can run the client using the green "run" button in the Eclipse
438
    menu. We will use that button from now on, instead of going to the java file.</li>
439
    </ul>    
440
  </li> 
441
  <li>List Registry Services on dev
442
    <ul>
443
    <li>In Eclipse, go to the green run button dropdown and choose "Open Run Dialog"</li>
444
    <li>Right click on the "RegistryServiceClient noargs" configuration you created earlier and choose "duplicate".</li>   
445
    <li>Name your new configuration "RegistryServiceClient list dev.nceas"
446
    <li>Go to the Arguments tab and enter: list 12345 http://dev.nceas.ucsb.edu/registry/services/RegistryService
447
      <ul>
448
      <li>This conforms to the list usage we saw earlier</li>
449
      <li>Note that the session ID is not needed for listing, so we include a random value.</li>
450
      <li>GSH always refers to the server where the registry database is held.</li>
451
      </ul>
452
    </li>
453
    <li>Choose "Run"</li>
454
    <li>Proceed past the project error warning dialog</li>
455
    <li>You should see a listing of details for all services registered on the dev server.</li>
456
    </ul>
457
  </li> 
458
  <li>Register a new  service on dev
459
    <ul>
460
    <li>Look in your service list you just printed and find a service that has a 
461
        service type of: http://ecoinformatics.org/identifierservice-1.0.0</li>
462
    <li>Get the service ID and use it to get the xml description from dev metacat by going to:</br>
463
        http://kepler-dev.nceas.ucsb.edu/kepler/metacat/&lt;service_id&gt;</li>
464
    <li>Save the file to disk</li>
465
    <li>Edit the file and change the id to something unique and the description to be something
466
        easily recognizable.</li>
467
    <li>In the browser, go to: http://kepler-dev.nceas.ucsb.edu/kepler/style/skins/dev/login.html</li>
468
    <li>Log in and make note of the sessionId that was returned</li>
469
    <li>In Eclipse, go to the green run button dropdown and choose "Open Run Dialog"</li>
470
    <li>Right click on the "RegistryServiceClient noargs" configuration you created earlier and choose "duplicate".</li>   
471
    <li>Name your new configuration "RegistryServiceClient add-test dev.nceas"
472
    <li>Go to the Arguments tab and enter: add &lt;sessionId&gt; &lt;xml_file_path&gt; http://dev.nceas.ucsb.edu/registry/services/RegistryService
473
      <ul>
474
      <li>This conforms to the add usage we saw earlier</li>
475
      <li>The &lt;sessionId&gt; is the id you got after loggin in via the dev skin.</li>
476
      <li>The &lt;xml_file_path&gt; is the full path to the descriptor file you downloaded and modified.</li>
477
      <li>GSH always refers to the server where the registry database is held.</li>
478
      </ul>
479
    </li>
480
    <li>Choose "Run"</li>
481
    <li>Proceed past the project error warning dialog</li>
482
    <li>You should see a message saying: "The new id is &lt;id&gt;, where &lt;id&gt; is the unique id
483
        you added to the service descriptor file.</li>
484
    <li>Follow the instructions shown above to list services to make sure your new service shows up</li>
485
    </ul>  
486
  </li>      
487
  </ul>
488
  
314 489
  <br>
315 490
  <a href="./metacat-eclipse-project.html">Back</a> | <a href="./index.html">Home</a> | 
316 491
  <!--a href="add next file here when one exists" -->Next<!-- /a -->

Also available in: Unified diff