Difference between revisions of "Post Assessment"

From Tranzman Documentation
Jump to: navigation, search
(→‎Understanding Assessment Results)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
===Introduction===
+
__TOC__
−
There are two elements to the Post Assessment.
+
<br>
 +
<br>
 +
<div style="background-color:#edf7ff; padding: 1.5rem; border-radius:8px; max-width:80%; margin: 0 auto; margin-bottom:2rem;">
 +
  <h1 style="border-bottom:none; font-size:2.5em; font-weight:bold; text-align:center;">Post Assessment & Acceptance Report Overview</h1>
 +
  <p style="font-size:1.2em; text-align:left;">
 +
    The Tranzman Appliance provides a comprehensive <b>Post Assessment</b> to validate migration success.<br>
 +
    There are two elements to the Post Assessment: <b>Observational Tests</b> and <b>Automated Tests</b>.<br>
 +
    Tranzman generates a downloadable report and an archive (<i>evidence.zip</i>) containing all automated test data.
 +
  </p>
 +
</div>
  
−
* 10 Observational Tests
+
<div style="max-width:80%; margin: 0 auto;">
−
** User needs to select the test as passed or failed or NA if it is not applicable.
+
  <div style="background-color:#fffbf4; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
−
* 22 Automated Tests
+
    <h2 style="border-bottom:2px solid #ffe0b2; padding-bottom:0.5rem; font-size:1.5em;">Post Assessment Elements</h2>
−
** Tranzman will run the test and check the output of commands to determine if the test was a pass, fail or not applicable.
+
    <ul style="font-size:1.1em; margin-left:2em;">
 +
      <li>
 +
        <b>10 Observational Tests:</b> User selects each test as <b>Passed</b>, <b>Failed</b>, or <b>NA</b> (not applicable).
 +
      </li>
 +
      <li>
 +
        <b>22 Automated Tests:</b> Tranzman runs commands and checks outputs to determine pass/fail/NA.
 +
      </li>
 +
      <li>
 +
        Tranzman generates a report of findings and an <i>evidence.zip</i> archive for download.
 +
      </li>
 +
    </ul>
 +
    <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:Post_assessment_overview.jpg|700px]]</div>
 +
  </div>
  
−
Tranzman will generate a report of the Assessment findings that can be downloaded.
+
  <div style="background-color:#fef3f7; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
−
Tranzman will also generate an archive (<i>evidence.zip</i>) of all the data that was used for the automated tests so that can be downloaded too.
+
    <h2 style="border-bottom:2px solid #f8bbd0; padding-bottom:0.5rem; font-size:1.5em;">Understanding Assessment Results</h2>
 +
    <ul style="font-size:1.1em; margin-left:2em;">
 +
      <li>[[File:yellow_triangle_exclamation.jpg |15x15px]] Additional messages provided for this test; investigate further.</li>
 +
      <li>[[File:green_circle_tick.jpg |15x15px]] Issue acknowledged.</li>
 +
      <li>[[File:blue_circle_info.jpg |15x15px]] More information available about the check result.</li>
 +
      <li>[[File:grey_tick.jpg |15x15px]] Test ran without issue; no additional messages.</li>
 +
      <li>[[File:grey_dash.jpg |15x15px]] Test not applicable to environment; skipped.</li>
 +
      <li>Anything with [[File:yellow_triangle_exclamation.jpg |15x15px]] should be investigated and resolved if needed.</li>
 +
    </ul>
 +
    <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:selected_check.jpg |80x25px]]</div>
 +
    <span style="margin-left:1em;">Individual checks can be selected and rerun. Rerun is enabled [[File:Rerun_enabled.jpg|50x20px]] when checks are selected, otherwise disabled [[File:Rerun_disabled.jpg|50x20px]].</span>
 +
  </div>
  
 +
  <div style="background-color:#eff8f0; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
 +
    <h2 style="border-bottom:2px solid #c8e6c9; padding-bottom:0.5rem; font-size:1.5em;">Automated Tests (NetBackup)</h2>
 +
    <ul style="font-size:1.1em; margin-left:2em;">
 +
      <li><b>Catalog Structure:</b> Verify the Image directory structure</li>
 +
      <li><b>Master Name on Master Server:</b> Check master server name consistency between EMM and Host Properties</li>
 +
      <li><b>Master Name on Media Servers:</b> Verify media servers use the same master name in config</li>
 +
      <li><b>Media Server Connectivity:</b> Test media server connectivity</li>
 +
      <li><b>Host Connectivity:</b> Test host connectivity</li>
 +
      <li><b>Tape Devices States:</b> Check for pending or down tape drives</li>
 +
      <li><b>Disk Pools:</b> Check for DOWN disk pools</li>
 +
      <li><b>Catalog Backup:</b> Verify successful catalog backups</li>
 +
      <li><b>Policy Configuration:</b> Check all policies are valid</li>
 +
      <li><b>Residency Configuration:</b> Check residencies do not reference non-existent residencies/hosts</li>
 +
      <li><b>De-assign Empty:</b> Verify image/media clean-up functionality</li>
 +
      <li><b>Image and Media Consistency Check:</b> Check images and media consistency</li>
 +
      <li><b>Cluster Nodes Differ:</b> Check all cluster nodes use same OS/platform and NetBackup version</li>
 +
      <li><b>Foreign Media:</b> Check for foreign media entries in EMM listhosts output</li>
 +
      <li><b>Check Services/Processes:</b> Verify required services/processes are active on master server</li>
 +
      <li><b>Check Appliance Demoted:</b> Check demoted appliance is correctly configured as media server</li>
 +
      <li><b>Credentials:</b> Validate credentials are working</li>
 +
      <li><b>Images and Image Headers Check:</b> Check image header/files consistency and crosscheck destination vs origin</li>
 +
      <li><b>Clean up Temp Host File Content:</b> Verify no temporary host file entries left from Tranzman</li>
 +
      <li><b>Images Copies Consistency Check:</b> Check consistency between copies and retentions</li>
 +
      <li><b>Master Certificate Working:</b> Verify master can get its own certificate</li>
 +
      <li><b>Rogue Files/Folders in Catalog:</b> Verify no rogue files/folders in Images path; report unassociated folders/files</li>
 +
    </ul>
 +
  </div>
  
−
=== Understanding Assessment Results===
+
  <div style="background-color:#fffbf4; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
−
* [[File:yellow_triangle_exclamation.jpg |15x15px]] tells there are additional messages have been provided for that specific test that should be investigated.<br>
+
    <h2 style="border-bottom:2px solid #ffe0b2; padding-bottom:0.5rem; font-size:1.5em;">Downloading Tranzman Acceptance Report</h2>
−
* [[File:green_circle_tick.jpg |15x15px]] is the result of acknowledging the issues.
+
    <ul style="font-size:1.1em; margin-left:2em;">
−
* [[File:blue_circle_info.jpg |15x15px]] indicates about more information available about the check result. <br>
+
      <li>
−
* [[File:grey_tick.jpg |15x15px]] tells you that the Test ran without issue, and there are no additional messages<br>
+
        Download the Acceptance document from <b>Tasks &rarr; Download</b> in the Tranzman side menu.
−
* [[File:grey_dash.jpg |15x15px]] No entry sign means that the test was not applicable to that environment and was skipped. <br>
+
      </li>
−
* In most cases anything with [[File:yellow_triangle_exclamation.jpg |15x15px]] should be investigated further and resolved if needed. <br>
+
      <li>
−
[[File:Post_assessment_overview.jpg|700px]]
+
        If documents are not available, click [[File:generate_doc_icon.jpg|20x20px]] to generate Acceptance and evidence files.
 +
      </li>
 +
      <li>
 +
        Two documents per migration pair are generated:
 +
        <ul>
 +
          <li><i>TRANZMAN_Environments_&lt;ctime&gt;_&lt;origin name&gt;_&lt;destination name&gt;.odt</i></li>
 +
          <li><i>TRANZMAN_Environments_&lt;ctime&gt;_&lt;origin name&gt;_&lt;destination name&gt;.odt</i></li>
 +
        </ul>
 +
      </li>
 +
      <li>
 +
        A zip file of all gathered logs is generated as <i>evidence_&lt;ctime&gt;.tgz</i>.
 +
      </li>
 +
      <li>
 +
        Click the document to download locally.
 +
      </li>
 +
    </ul>
 +
  </div>
  
−
 
+
  <div style="background-color:#fef3f7; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
−
Individual checks can be selected [[File:selected_check.jpg |15x25px]]. One or more selections enable the rerun [[File:Rerun_enabled.jpg|15x20px]] from [[File:Rerun_disabled.jpg|15x20px]]
+
    <h2 style="border-bottom:2px solid #f8bbd0; padding-bottom:0.5rem; font-size:1.5em;">Acceptance & Sign-Off Guidance</h2>
−
 
+
    <ul style="font-size:1.1em; margin-left:2em;">
−
===Automated Tests (NBU)===
+
      <li>
−
* <b>Catalog Structure</b>  <i> Verify the Image directory structure</i>
+
        The document shows all tests and provides details for those marked with [[File:yellow_triangle_exclamation.jpg|20x20px]] (marked as FAIL).
−
* <b>Master Name on Master Server</b>  <i>Check Master Server name, is consistent between EMM and Host Properties.</i>
+
      </li>
−
* <b>Master Name on Media Servers</b>  Verify that Media servers use the same master name in their config</i>
+
      <li>
−
* <b>Media Server Connectivity</b> <i>Test Media server connectivity</i>
+
        Investigate all FAIL entries and resolve if possible.
−
* <b>Host Connectivity</b> <i>Test host connectivity</i>
+
      </li>
−
* <b>Tape Devices States</b> <i>Check if there pending or down tape drives</i>
+
      <li>
−
* <b>Disk pools</b> <i>Check if there are any DOWN disk pools</i>
+
        Documents with FAIL should <b>NOT</b> be signed off. Update any FAIL to ADV (advised) and provide customer with details about the test and reason for acceptance.
−
* <b>Catalog Backup</b> <i>Verify that Catalog backups was performed successfully</i>
+
      </li>
−
* <b>Policy Configuration</b> <i>Check that all Policies are valid.</i>
+
     </ul>
−
* <b>Residency Configuration</b> <i>Check that all Residencies do not reference non-existent residencies or hosts.</i>
+
  </div>
−
* <b>De-assign Empty</b> <i>Verify normal functionality for image / media clean-up</i>
+
</div>
−
* <b>Image and Media Consistency Check</b> <i>Check that images and media are consistent.</i>
+
<div style="display:flex; justify-content:space-between; margin-top:2rem; padding:1rem; background-color:#ffffff; max-width:90%; margin: 2rem auto 0;">
−
* <b>Cluster nodes differ</b> <i>Check that all Nodes in a Cluster use the same OS/Platform, and are at the same NetBackup Version.</i>
+
  <div style="text-align:left;">
−
* <b>Foreign Media</b>     <i>Check if there are any Foreign Media entries in EMM listhosts output.</i>
+
    [[File:prev_icon.jpg|30px|link=Finalize]] [[Finalize|Previous]]
−
* <b>Check Services / Processes</b>     <i>Verify that all required services / processes are active on the master server.</i>
+
  </div>
−
* <b>Check Appliance Demoted</b>     <i>Check that if appliance was demoted, it should now be correctly configured as a media server.</i>
+
  <div style="text-align:right;">
−
* <b>Credentials</b> <i>Validate Credentials are working</i>
+
    [[Troubleshooting|Next]] [[File:next_icon.jpg|30px|link=Troubleshooting]]
−
* <b>Images and Image Headers Check</b>  <i>Check for images header and files consistency, and crosscheck Destination against the Origin.</i>
+
  </div>
−
* <b>Clean up of Temp Host file content</b> <i>Verify that there are no temporary host file entries left over from running Tranzman.</i>
+
</div>
−
* <b>Images Copies Consistency Check</b>    <i>Check for consistency between copies and their retentions.</i>
 
−
* <b>Master Certificate Working</b>      <i>Verify that Master can get its own certificate.</i>
 
−
* <b>Rogue files / folders in catalog</b>        <i>Verify that there are no rogue files or folders in the Images path. Folders will be reported here if they are not associated with any valid images.  Files are reported if they are not a valid part of a catalog.</i>
 
−
 
 
−
 
 
−
===Downloading Tranzman Acceptance report===
 
−
* The Acceptance document can be downloaded from <b>Tasks</b>-><b>Download</b> section of Tranzman side menu.
 
−
* By clicking on the <i>Generate documents</i> icon on the top right, generates the Acceptance and evidence files.
 
−
* This generates two documents per pair as: <i>TRANZMAN_Environments_<nowiki><ctime>_<origin name>_<destination name></nowiki>.odt</i> and <i>TRANZMAN_Environments_<nowiki><ctime>_<origin name>_<destination name></nowiki>.odt</i>
 
−
* It also generates a zip file of all the gathered logs as <i>evidence<nowiki>_<ctime></nowiki></i>.tgz
 
−
* Clicking on the documents, lets to download the files locally.
 
−
 
 
−
 
 
−
The document will show ALL test and will provide more detail for the ones that had a YELLOW ! They will be marked as FAIL.<br>
 
−
Investigate all FAIL entries and resolve if possible.<br>
 
−
Document that has FAIL on it should NOT be signed off. Make sure to update any FAIL to ADV (advised) and provide the customer with details about test and the reason for its acceptance.<br>
 

Latest revision as of 10:46, 12 September 2025



Post Assessment & Acceptance Report Overview

The Tranzman Appliance provides a comprehensive Post Assessment to validate migration success.
There are two elements to the Post Assessment: Observational Tests and Automated Tests.
Tranzman generates a downloadable report and an archive (evidence.zip) containing all automated test data.

Post Assessment Elements

  • 10 Observational Tests: User selects each test as Passed, Failed, or NA (not applicable).
  • 22 Automated Tests: Tranzman runs commands and checks outputs to determine pass/fail/NA.
  • Tranzman generates a report of findings and an evidence.zip archive for download.
Post assessment overview.jpg

Understanding Assessment Results

  • Yellow triangle exclamation.jpg Additional messages provided for this test; investigate further.
  • Green circle tick.jpg Issue acknowledged.
  • Blue circle info.jpg More information available about the check result.
  • Grey tick.jpg Test ran without issue; no additional messages.
  • Grey dash.jpg Test not applicable to environment; skipped.
  • Anything with Yellow triangle exclamation.jpg should be investigated and resolved if needed.
Selected check.jpg
   Individual checks can be selected and rerun. Rerun is enabled Rerun enabled.jpg when checks are selected, otherwise disabled Rerun disabled.jpg.

Automated Tests (NetBackup)

  • Catalog Structure: Verify the Image directory structure
  • Master Name on Master Server: Check master server name consistency between EMM and Host Properties
  • Master Name on Media Servers: Verify media servers use the same master name in config
  • Media Server Connectivity: Test media server connectivity
  • Host Connectivity: Test host connectivity
  • Tape Devices States: Check for pending or down tape drives
  • Disk Pools: Check for DOWN disk pools
  • Catalog Backup: Verify successful catalog backups
  • Policy Configuration: Check all policies are valid
  • Residency Configuration: Check residencies do not reference non-existent residencies/hosts
  • De-assign Empty: Verify image/media clean-up functionality
  • Image and Media Consistency Check: Check images and media consistency
  • Cluster Nodes Differ: Check all cluster nodes use same OS/platform and NetBackup version
  • Foreign Media: Check for foreign media entries in EMM listhosts output
  • Check Services/Processes: Verify required services/processes are active on master server
  • Check Appliance Demoted: Check demoted appliance is correctly configured as media server
  • Credentials: Validate credentials are working
  • Images and Image Headers Check: Check image header/files consistency and crosscheck destination vs origin
  • Clean up Temp Host File Content: Verify no temporary host file entries left from Tranzman
  • Images Copies Consistency Check: Check consistency between copies and retentions
  • Master Certificate Working: Verify master can get its own certificate
  • Rogue Files/Folders in Catalog: Verify no rogue files/folders in Images path; report unassociated folders/files

Downloading Tranzman Acceptance Report

  • Download the Acceptance document from Tasks → Download in the Tranzman side menu.
  • If documents are not available, click Generate doc icon.jpg to generate Acceptance and evidence files.
  • Two documents per migration pair are generated:
    • TRANZMAN_Environments_<ctime>_<origin name>_<destination name>.odt
    • TRANZMAN_Environments_<ctime>_<origin name>_<destination name>.odt
  • A zip file of all gathered logs is generated as evidence_<ctime>.tgz.
  • Click the document to download locally.

Acceptance & Sign-Off Guidance

  • The document shows all tests and provides details for those marked with Yellow triangle exclamation.jpg (marked as FAIL).
  • Investigate all FAIL entries and resolve if possible.
  • Documents with FAIL should NOT be signed off. Update any FAIL to ADV (advised) and provide customer with details about the test and reason for acceptance. 
   Prev icon.jpg Previous

   Next Next icon.jpg
Retrieved from "https://docs.stoneram.com/index.php?title=Post_Assessment&oldid=3485"