Revision 4801
Added by daigle almost 16 years ago
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/<skin_name></div> |
257 | 260 |
for each skin, where <skin_name> 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/<service_id></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 <sessionId> <xml_file_path> 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 <sessionId> is the id you got after loggin in via the dev skin.</li> |
|
476 |
<li>The <xml_file_path> 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 <id>, where <id> 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
Add instructions for how to test the web registry, web ldap, and ecogrid registry service.