Versions Compared

Old Version 69

changes.mady.by.user Sr

Saved on

compared with

New Version 70

changes.mady.by.user Colin Samuel Rosenthal

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

Test basic start and stop of selective-,event- and snapshot harvesting, scheduling and deduplication. The following templates are currently used: 

default_orderxml,

default_orderxml_low_bandwidth (maxPerHostBandwidthUsageKbSec=30),

frontpages(maxHops=0), (Not needed after fixing NAS-2483)

frontpages_plus_2levels.(maxHops=2) (Not needed after fixing NAS-2483)

Table of Contents

1. Check of monitoring and basic settings

...

  1. Go to http://$GUIadminserver:$http-port/HarvestDefinition/where GUIadminserver and http-port are specified in the deploy configuration file under the application named dk.netarkivet.common.webinterface.GUIApplication. In the one-machine setup (deploy_example_one_machine.xml ) the link will be : http://localhost:8074
  2. Make a new selective harvest definition with a name you can remember
    1. Click 'Definitions'->'Selective Harvests' in the left menu
    2. *Click 'Create new harvest definition' in the bottom of the main window
    3.  Fill in the Harvest name and note the name for later use (from now referred as sh.name)
    4. Choose "Once_a_week" in the drop down list for 'Schedule'
    5. Write netarkivet.dk in In the 'Enter Domain...' window add the name of a domain not already in the system (e.g. mazda.dk) and click 'Add domains'
    6. If netarkivet.dk is unknown (i.e. not registered in the domain table), the There should be a button "Create and add to the harvest definition" is added to the to page, and you then need to click on this buttonshown. Click on it.
    7. Click 'Save'
  3. Activate the selective harvest
    1. Click 'Activate' in column 5 on the line with the sh. name
    2. Check that the time in the "Next Run" column time on the line with the sh. name is now.
  4. Check harvest status of the selective harvest
    1. Click 'Harvest status'->'All Jobs' in the left menu
    2. Select "All" in "Only display job status" to the right from the menu
    3. Click the "Show" button, until the name appears in a new job line (approx. after a minute)
    4. Check that the job has status "NEW", it may have turned into status "SUBMITTED" or status "STARTED" before you see it.
  5. Check job creation in the system status for the selective harvest
    1. Click 'Systemstate'->'Overview of the system state'
    2. Find and click 'HarvestJobManagerApplication' in the 'Application' column.
    3. Click 'show all' in the header.
    4. Check that there exists a line with the message "INFO: Created 1 jobs for harvest definition ' and a line after that "INFO: Job #1 submitted, and later the line: "INFO: Job #1 has been started by the harvester."

...

  1. Make a new selective (event) harvest definition with a name you can remember
    1. Click 'Definitions'->'Selective Harvests' in the left menu
    2. Click 'Create new harvestdefinition' in the bottom of the main window
    3. Fill in the Harvest name and note the name for later use (from now referred as EH)
    4. Choose '''Once_an_hour''' in the drop down list for 'Schedule'
    5. Click Save (DO NOT CLICK ACTIVATE YET)
  2. Add seeds to the selective (event) harvest
    1. Click 'Edit' in column 6 on the line with the EH
    2. Write domain list from 'Seed list 1' given below to a file on your desktop e.g. notepad)
    3. Click 'Add seeds from a file' at the bottom of the main page
    4. Click 'Browse" and pick up the just created file with seeds
    5. Choose default_orderxml in the drop-down list for 'Harvest template' (set maxobjects pr domain to 500; max bytes to 400.000.000, maxhops to 0, obey robots.txt? unchecked and extract_javascript checked)  [previously used template frontpages]
    6. Click 'Insert'
    7. Now click 'Add seeds'
    8. Choose default_orderxml in the drop-down list for 'Harvest template'
    9. Write domain list from 'Seed list 2' given below (you can cut and paste from this page) (set maxobjects pr domain to 300; max bytes to 500.000.000, maxhops to 2, obey robots.txt? unchecked and extract_javascript checked) [previously used template frontpages_2levels]
    10. Click 'Insert'
    11. *Click 'Save'
  3. Check that seed lists for domains in Seed list 1 has changed correspondingly (You have to click on Show unused configurations/seedlists show all)
    1. For each of the domains raeder.dk, netarkivet.dk do:
    2. Click 'Definitions'->'Find Domain(s)'
    3. Search for domain by writing its name as text and click 'Search'
    4. Check that there exists a configuration with the name "EH_default_orderxml_400000000Bytes_500Objects" (verify that the config has maxHops=0maxHops=0, obey robots unchecked, extract javascript checked)
    5. Check that there exists a seed list with the name "EH_default_orderxml_400000000Bytes_500Objects
    6. Click 'Edit' in the line with seed list "EH_default_orderxml_400000000Bytes_500Objects
    7. Check that the seed list shown corresponds to the seed list for the domain (see below)
    8. Check that seed lists for domains in Seed list 2 has changed correspondingly (you have to click on Show unused configurations/seedlists show all)
    9. For the domains kaarefc.dk, netarkivet.dk do:
    10. Click 'Definitions'->'Find Domain(s)'
    11. Search for the domain by writing this text (either kaarefc.dk or netarkivet.dk) and click Search
    12. Check that there exists a configuration with name EH_default_orderxml_500000000Bytes_300Objects (verify that the config has maxHops=2)
    13. Check that there exists a seed list with the name EH_default_orderxml_500000000Bytes_300Objects
    14. Click 'Edit' in the line with seed list EH_default_orderxml_500000000Bytes_300Objects
    15. Check that the seed list shown corresponds to the seed list for the domain (see below)
  4. Activate the harvest
    1. Click 'Definitions'->'Selective Harvests' in the left menu
    2. Click 'Activate' in column 5 on the line with the <eh. name>
  5. Check harvest status of the event harvest using menu "All Jobs"
    1. Click 'Harvest status'->'All Jobs' in the left menu
    2. Select "All" in "Only display job status" to the rigth right from the menu
    3. Click the "Show" button, until the <eh. name> appears in a new job line (approx. after a minute)
    4. Check that two jobs appears and that they both have Harvest name <eh. name>
    5. Check the menu "Running jobs", that the jobs appears and that you can go to the Heritrix GUI. by clicking on the host link and by using the login/password: "admin"/"adminPassword" and close the window again.

...

6. Verify that the harvest is activated and done

  1. Click 'Harvest status'->'All Jobs' in the left menu
  2. Select "All" in "Only display job status" to the right from the menu
  3. Click the "Show" button, until the jobs have stepped through statuses "NEW", "SUBMITTED", "STARTED", "DONE"
  4. Wait until all jobs have got status "DONE"
  •  Surely the following steps are a bit superfluous?
  1. Check the following for the domain '''raeder.dk''': (Using page Harvest Status -> All jobs per domain)
    1. Check that the domain has been harvested by one job of the name <eh. name>
    2. Check that this job has configuration <eh. name>_default_orderxml_400000000Bytes_500Objects
    3. Check that there is a number for 'Run number' and 'Job ID'
    4. Check that the 'Start time' and 'End time' columns approximately corresponds to time of test with <eh. name> harvest
    5. Check that the 'Bytes Harvested' and 'Documents Harvested' columns contains positive numbers
    6. Check that the 'Stopped due to' columns contain "Domain Completed"
  2. Check the following job details for the domain '''netarkivet.dk''': (Using page SelectiveHarvests->History->Run Number 0 ->JobID 1)
    1. Check that the 'Submit time', 'Start time' and 'End time' columns approximately corresponds to time of test with <eh. name> harvest
    2. Click on "Browse reports for jobs"
    3. Check that you don't get any errors when you click on some of the links
    4. Click on "Browse harvest files for job"
    5. Check that you don't get any errors when you click on some of the links
    6. Click on "Browse only relevant crawl-log lines for domain netarkivet.dk"
    7. Check that you don't get any errors when you click on some of the links
  3. Check the following for the domain '''netarkivet.dk''': (Using page Harvest Status -> All jobs per domain)
    1. Check that the domain has been harvested by 2 jobs of the name <eh. name>
    2. Check that one of the jobs has configuration <eh. name>_default_orderxml_400000000Bytes_500Objects
    3. Check that the 'Start time' and 'End time' columns approximately corresponds to time of test with <eh. name>
    4. Check that one of the jobs has configuration <eh. name>_default_orderxml_500000000Bytes_300Objects
    5. Check that the 'Start time' and 'End time' approximately corresponds to time of test with <eh. name> harvest
    6. Check that 'Run number' and 'Job ID' columns contains positive numbers
    7. Check that the 'Bytes Harvested' and 'Documents Harvested' columns contains positive numbers
    8. Check that the 'Stopped due to' columns contains "Domain Completed"
  4. Check the following for the domain '''kaarefc.dk''': (Using page Harvest Status -> All jobs per domain)
    1. Check that the domain has been harvested by 1 job of the name <eh. name>
    2. Check that the job has configuration <eh. name>_default_orderxml_500000000Bytes_300Objects
    3. Check that the 'Start time' and 'End time' approximately corresponds to time of test with <eh. name> harvest
    4. Check that 'Run number' and 'Job ID' columns contains positive numbers
    5. Check that the 'Bytes Harvested' and 'Documents Harvested' columns contains positive numbers
    6. Check that the 'Stopped due to' columns contains "Domain Completed"

7. Browse in data from the first event harvest only

These step require that you have your browser set up to use viewerproxy. For example in the DK test environment use the instructions at Setup DK test environment#ViewerproxySetup, or for a standalon installation use the instructions here.

  1. Click 'Definitions'->'Selective Harvests' in the left menu
  2.  Click 'History' in column 8 on the line with the event harvest <eh. name>
  3. Click 'Show jobs' in column 'Total number of jobs' on the line with 'Run number' 0
  4. Click 'Select these jobs for QA with viewerproxy' (it may take some time to create page)
  5. Check following in the 'Current Viewerproxy status'
  6. No errors are reported
  7. Check the "Currently does _not_ collect missing URLs." appear
  8. Check the "Current list of missing URLs contains 0 URLs."
  9. Check there is a line expressing index used from harvest <eh. name>, run 0 and built on jobs being looked at.
  10. Open a New tab or window in the browser (optionally, and in same kind of browser)
  11. Go to page http://www.netarkivet.dk/adgang-for-forskere/
  12. Check that an error occurs saying that www. http://netarkivet.dk/adgang-for-forskere/was not found (DOES NOT WORK: . If this works then mark
    Jira Legacy
    serverSystem JIRA
    serverId81c76265-cab2-3ba5-b74d-ee7cd9a2765e
    keyNAS-2076
    ) as fixed.
  13. Go to page http://www.kaarefc.dk
  14. Check that this page contains data
  15. Go to page http://www.kaarefc.dk/wop/
  16. This page should exist.
  17. Go to page http://indvandrerbiblioteket.dk
  18. Check that an error occurs saying that www.indvandrerbiblioteket.dk was not found
  19. Go to page http://localtimes.info/Europe/Denmark/Copenhagen/
  20. Check that a page containing date and time of the first harvest appears

8. Browse in data from the second event harvest only

  1. Click 'Definitions'->'Selective Harvests' in the left menu
  2. Click 'History' in column 8 on the line with event harvest <eh. name>
  3. Click 'Show jobs' in column 'Total number of jobs' on the line with 'Run number' 1
  4. Click 'Select these jobs for QA with viewerproxy' (it may take some time to create page)
  5. Check following in the 'Current Viewerproxy status'
  6. No errors are reported
  7. Check the "Currently does _not_ collect missing URLs." appear
  8. Check the "Current list of missing URLs contains 0 URLs."
  9. Check there is a line expressing index used from harvest <eh. name>, run 1 and built on jobs being looked at.
  10. Open a New tab or window in the browser (optionally, and in same kind of browser)
  11. Go to page http://www.netarkivet.dk
  12. Check that an error occurs saying that www.netarkivet.dk was not found (DOES NOT WORK:
    Jira Legacy
    serverSystem JIRA
    serverId81c76265-cab2-3ba5-b74d-ee7cd9a2765e
    keyNAS-2076
    )
  13. Go to page http://www.kaarefc.dk
  14. Check that this page contains data
  15. Click on a local link (e.g. =http://www.kaarefc.dk/wop/ in link for= 'Here').
  16. Check that this page contains data
  17. Go to page http://indvandrerbiblioteket.dk
  18. Check that an error occurs saying that www.indvandrerbiblioteket.dk was not found
  19. Go to page http://localtimes.info/Europe/Denmark/Copenhagen/
  20. Check that a page containing date and time of the second harvest appears (Note: "Refresh" may be necessary)

9. Browse in data from the selective harvest only

  1. Click 'Definitions'->'Selective Harvests' in the left menu
  2. Click 'History' in column 8 on the line with the selective harvest &lt;sh. name>
  3. Click 'Show jobs' in column 'Total number of jobs' on the line with 'Run number' 0
  4. Click 'Select these jobs for QA with viewerproxy' (it may take some time to create page)
  5. Check following in the 'Current Viewerproxy status'
    1. No errors are reported
    2. Check the 'Currently does _not_ collect missing URLs.' appear
    3. Check the 'Current list of missing URLs contains 0 URLs.'
    4. Check there is a line concerning index used for harvest &lt;sh. name>, run 0 and built on jobs being looked at.
  6. Open a new tab or window in the browser (optionally, and in same kind of browser)
  7. Go to page http://netarkivetmazda.dk
  8. Check that this page contains data and all links are functional
  9. Go to a random internet page not on http://netarkivet.dk (but not https). The page should NOT be found. (Example: http://www.pligtaflevering.dk)

10. Verify that data is deduplicated

  1. Click on the JobID for your finished event harvest <eh-name> in the Job status overview
  2. Click on "Browse reports for jobs"
  3. Click on the "processors-report" e.g. "metadata://netarkivet.dk/crawl/reports/processors-report.txt?heritrixVersion=1.14.4&harvestid=1&jobid=1" [this link should look different now!]
  4. Check that there is a deduplicator processors-report similar to this one (the numbers will be different), but duplicates found should be non-zero:
Code Block
Total handled: 88
Duplicates found: 20 20.0%
Bytes total: 6391852 (6.1 MB)
Bytes discarded: 0 (0 0.0%
New (no hits): 88
Exact hits: 0
Equivalent hits: 0
......

11. Define and run low bandwidth selective harvest 

  1. Go to Edit Harvest Templates page. Download default_orderxml.
  2. Edit it to replace max-per-host-bandwidth-usage-KB-sec with 30.
  3. Upload it as a new config: default_orderxml_low_bandwidth
  4. Go to edit-page for domain 'netarkivet.dk', edit defaultconfig, and replace harvesttemplate with 'default_orderxml_low_bandwidth'
  5. Make a new selective harvest definition with a name you can remember
    1. Click 'Definitions'->'Selective Harvests' in the left menu
    2. Click 'Create new harvest definition' in the bottom of the main window
    3. Fill in the Harvest name and note the name for later use (from now referred as <sh1. name>)
    4. Choose "Once_a_week" in the drop down list for 'Schedule'
    5. Write =netarkivet.dk= in the 'Enter Domain...' window and click 'Add domains'
    6. If =netarkivet.dk= is unknown (i.e. not registered in the domain table), the button "Create and add to the harvest definition" is added to the to page, and you then need to click on this button.
    7. Click 'Save'
  6. Activate the selective harvest
    1. Click 'Activate' in column 5 on the line with the <sh1. name>
    2. Check that the time in the "Next Run" column time on the line with the <sh1. name> is now.
  7. Check harvest status of the selective harvest
    1. Click 'Harvest status'->'All Jobs' in the left menu
    2. Select "All" in "Only display job status" to the right from the menu
    3. Click the "Show" button, until the <sh1. name> appears in a new job line (approx. after a minute)
    4. Check that the job has status "NEW", it may have turned into status "SUBMITTED" or status "STARTED" before you see it.
  8. Check job creation in the system status for the selective harvest
    1. Click 'Systemstate'->'Overview of the system state'
    2. Find and click 'HarvestJobManagerApplication' in the 'Application' column for the KB kb-test-adm-001
    3. Click 'show all' in the "Index" header
    4. Check that there exists a line with the message "INFO: Created 1 jobs for harvest definition and a line after that "INFO: Job #1 submitted, and later the line: "INFO: Job #1 has been started by the harvester."

12. Run Heritrix GUI and terminate a harvest

  1. Goto Harvest status/Running Jobs'
  2. When the Host link appears for the job ID that has just been started, click on it. This will bring you to the Heritrix login page.
  3. Fill login/password: admin/adminPassword
  4. Click on Terminate (Terminate harvest or heritrix ???)

13. Check the Heritrix terminated job is logged in the Job details in ADM GUI

  1. Click on refresh until the job disappears in 'System Overview' ( 5 min.)
  2. Click 'Harvest status' and select your terminated job by clicking on the Job ID number
  3. Verify that under the 'Included domains and configurations' some domains are "Stopped due to": "Harvesting aborted" (Should be only domain: netarkivet.dk)

14. Start a snapshot harvest with max 1.000.000 bytes

  1. Make a new snapshot harvest definition with a name you can remember
    1. Click 'Definitions'->'Snapshot Harvests' in the left menu
    2. Click 'Create new harvestdefinition' in the bottom of the main window
    3. Fill in the 'Harvest name' and note the name for later use (from now referred as <snh. name>)
    4. Set Max number of bytes per domain to 1000000 (1 Mbytes)
    5. Click Save
    6. Click 'Activate' in column 4 on the line with the <snh. name>
  2. Check scheduling of jobs
    1. Click 'Harvest status'->'All Jobs' in the left menu
    2. Select to view NEW jobs
    3. Check that a new snapshot harvest <snh. name> job has been generated (may take a minute before jobs appear)
    4. Click 'Systemstate' in the left menu
    5. Check that the HarvestJobManager application contains the message "INFO: Created X jobs for harvest definition" (choose Application HarvestJobManager and Show all lines)
    6. Check That there are no warnings on the different applications

15. Run Heritrix GUI and terminate a harvest

  1. Goto Harvest status/Running Jobs
  2. When the Host link appears for the job ID belonging to the selected harvest. This will bring you to the Heritrix login page.
  3. Fill login/password: admin/adminPassword
  4. Click on Terminate

16. Check the Heritrix terminated job is logged in the Job details in ADM GUI

  1. Click on refresh until the job disappears in system overview ( about 5 min.)
  2. Click 'Harvest status' and select your terminated job
  3. Click on Job ID number
  4. Verify that the under 'Included domains and configurations' and remember the number of domains which have Stopped due to = Harvesting aborted

17. Start a snapshot harvest with max 100000 bytes

  1.  Make a new snapshot harvest definition with a name you can remember
    1. Click 'Definitions'->'Snapshot Harvests' in the left menu
    2. Click 'Create new harvestdefinition' in the bottom of the main window
    3. Fill in the 'Harvest name' and note the name for later use (from now referred as <snh. name.2>)
    4. Set 'Max number of bytes per domain' to 100000.
    5. Click on the <snh.name> under 'Harvest only domains that were not completely harvest in a previous harvest'
    6. Click Save
    7. Click 'Activate' in column 4 on the line with the <snh. name.2>
  2. Check scheduling of jobs
    1. Click 'Harvest status'->'All Jobs' in the left menu
    2. Select to view NEW jobs
    3. Check that a new snapshot harvest <snh. name.2> job has been generated (may take a minute before jobs appear)
    4. Click 'System status' in the left menu
  3. Verify job status
    1. Click 'Harvest status'->'All Jobs' in the left menu
    2. Select "All" in "Only display job status" to the right from the menu
    3. Click the "Show" button, until the jobs have stepped through statuses "NEW", "SUBMITTED", "STARTED", "DONE"

18. Check that the domains stopped by Heritrix termination are not part of the next harvest.

  1. Click on refresh until the job disappears in system overview ( about 5 min.)
  2. Click 'Harvest status' and for each jobs in the snapshot harvest
    1. Click on Job ID number
    2. Verify that the 'Included domains and configurations' are without the domains which was stopped due to 'Harvesting aborted' in the previous harvest, and the rest are 'Domain Completed' or 'Max Bytes limit reached'