Difference between revisions of "Virtual Agent"

From Tranzman Documentation
Jump to: navigation, search
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
__TOC__
 +
<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;">Creating a Tranzman Virtual Agent from Recordings</h1>
 +
  <p style="font-size:1.2em; text-align:left;">
 +
    Tranzman recordings can be used as a <b>Virtual Agent</b> to perform a dry run of a Transition (up to selections).<br>
 +
    The Virtual Agent replicates the process of a real Transition scenario, helping to understand selection and mapping of configurations.<br>
 +
    Selections can be exported or imported onto a production Transition.<br>
 +
    <br>
 +
    Virtual Agents can be created from recordings on <b>Disk</b>, <b>Tape</b>, or via <b>Tranzman Shares over SMB</b>. All methods are detailed below.
 +
  </p>
 +
</div>
  
βˆ’
Tranzman recording can be used as a Virtual agent to perform a dry run of a Transition (till selections). <br>
+
<div style="max-width:80%; margin: 0 auto;">
βˆ’
Virtual agent replicates the same process as production servers Transition and helps to understand the selections rules, mappings and verification of the selections.<br>
+
  <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;">
βˆ’
The selections can also be exported and imported for the production Transition.
+
    <h2 style="border-bottom:2px solid #f8bbd0; padding-bottom:0.5rem; font-size:1.5em;">Create Virtual Agent from Recordings on Disk</h2>
 +
    <ol style="font-size:1.1em; margin-left:2em;">
 +
      <li>Generate recordings using <b>tzm_recorder</b>. See [[ Tranzman_Recorder| Using Recorder ]] for details.</li>
 +
      <li>Use the <b>-export_db</b> flag to generate recordings for Virtual Agents.<br>
 +
        <table style="width:60%;color:white;background-color:black;font-family:monospace,monospace;border-radius:5px;box-shadow: 5px 5px 10px grey; margin:1em 0;">
 +
          <tr><td><font style="color:blue">> </font> tzm_recorder.exe -export_db</td></tr>
 +
        </table>
 +
      </li>
 +
      <li>This creates a zip file (e.g., <b>TZM_recording_1606735043.zip</b>). Copy it to the system with Tranzman GUI access.</li>
 +
      <!-- <li> -->
 +
        <div style="background-color:#f8e2b3; padding:0.2rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); font-size:1em; margin: 0 auto;">
 +
          <p>πŸ›ˆ <i>Below steps are based on TZM Recorder run on a NetBackup Backup Server.</i></p>
 +
        </div>
 +
      <!-- </li> -->
 +
      <li>From Tranzman dashboard, click <b>+</b>. Enter a loopback IP (for virtual agent), select platform, and click <b>commit</b>.<br>
 +
        [[File:virtual_agent_add_env.jpg|700px]]
 +
      </li>
 +
      <li>Click <b>Upload Recordings</b> to upload the zip file.<br>
 +
        [[File:virtual_agent_upload_rec.jpg|700px]]
 +
      </li>
 +
      <li>Creation may take a few minutes. A successful upload triggers the Init job and four Query jobs (<b>QueryProduct, QueryConfig, QueryImages, QueryMedia</b>).<br>
 +
        [[File:virtual_agent_init_job.jpg|700px]]
 +
      </li>
 +
      <li>Once complete, environment details will be visible.<br>
 +
        [[File:virtual_agent_add_status.jpg|700px]]
 +
      </li>
 +
      <li>The environment is now ready for Selections and Pre-Assessment.</li>
 +
    </ol>
 +
  </div>
  
βˆ’
__NOTOC__
+
  <div style="background-color:#edf7ff; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
βˆ’
Virtual agent could be created using the recordings on a disk or on a tape. Please follow the respective approach as required.
+
    <h2 style="border-bottom:2px solid #bbdefb; padding-bottom:0.5rem; font-size:1.5em;">Create Virtual Agent from Recordings on Tape</h2>
 +
    <ol style="font-size:1.1em; margin-left:2em;">
 +
      <li>Uncompress recordings before backing up to tape.<br>
 +
        Use <b>-no_zip</b> argument to create unzipped recordings.<br>
 +
        <table style="width:60%;color:white;background-color:black;font-family:monospace,monospace;border-radius:5px;box-shadow: 5px 5px 10px grey; margin:1em 0;">
 +
          <tr><td><font style="color:blue">> </font> tzm_recorder.exe -export_db -no_zip</td></tr>
 +
        </table>
 +
        <p>See [[ Tranzman_Recorder| Using Recorder ]] for details.</p>
 +
      </li>
 +
      <li>Backup the recording folder to a dedicated tape. Share the Tape Library with Tranzman Server ([[ Devices | Devices Page ]]).</li>
 +
      <div style="background-color:#f8e2b3; padding:0.2rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); font-size:1em; margin: 0 auto;">
 +
          <p>πŸ›ˆ <i>Below steps are based on TZM Recorder run on a Data Protector Backup Server.</i></p>
 +
      </div>
 +
      <li>On Tranzman dashboard, click <b>+</b>, enter loopback IP, select platform.<br>
 +
        [[File:virtual_agent_add_env.jpg|700px]]
 +
      </li>
 +
      <li>Click <b>commit</b> and <b>Upload Recordings</b>.<br>
 +
        [[File:virtual_agent_upload_rec_dp.jpg|700px]]
 +
      </li>
 +
      <li>In <b>Choose media</b>, enter the mediaID of the tape and click <b>Upload</b>. Creation starts and triggers Init and Query actions.<br>
 +
        [[File:virtual_agent_init_job_dp.jpg|700px]]
 +
      </li>
 +
      <li>Once complete, dashboard fields are populated with environment details.<br>
 +
        [[File:virtual_agent_dashboard.jpg|700px]]
 +
      </li>
 +
    </ol>
 +
  </div>
  
βˆ’
== Create Virtual Agent from Recordings on Disk ==
+
  <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;">
 +
    <h2 style="border-bottom:2px solid #ffe0b2; padding-bottom:0.5rem; font-size:1.5em;">Create Virtual Agent from Recordings Using Tranzman Shares Over SMB</h2>
 +
    <ol style="font-size:1.1em; margin-left:2em;">
 +
      <li>Open a share from Tranzman Appliance ([[ Tranzman Shares | Tranzman Shares]]).</li>
 +
      <li>Run the recorder tool on the backup server and create the recording (uncompressed). See [[ Using Recorder | Using Recorder ]].</li>
 +
      <li>On Tranzman dashboard, click <b>+</b>, enter loopback IP, select platform.<br>
 +
        [[File:virtual_agent_add_env.jpg|700px]]
 +
      </li>
 +
      <li>Share open creates a directory in <b>/data</b> path.<br>
 +
        <table style="width:60%;color:white;background-color:black;font-family:monospace,monospace;border-radius:5px;box-shadow: 5px 5px 10px grey; margin:1em 0;">
 +
          <tr><td><font style="color:blue">> </font> ls /data/7F000101/<br>data  images  jobs  process  run  tools</td></tr>
 +
        </table>
 +
      </li>
 +
      <li>Copy recordings to the directory using the mounted share.<br>
 +
        <table style="width:60%;color:white;background-color:black;font-family:monospace,monospace;border-radius:5px;box-shadow: 5px 5px 10px grey; margin:1em 0;">
 +
          <tr><td><font style="color:blue">> </font> ls 7F000101/<br>data  images  jobs  process  TZM_recording_1606735043  run  tools</td></tr>
 +
        </table>
 +
      </li>
 +
      <li>Rename the folder to <b>recording</b>.<br>
 +
        <table style="width:60%;color:white;background-color:black;font-family:monospace,monospace;border-radius:5px;box-shadow: 5px 5px 10px grey; margin:1em 0;">
 +
          <tr><td><font style="color:blue">> </font> mv TZM_recording_1606735043/ recording/<br>ls 7F000101/<br>data  images  jobs  process  recording  run  tools</td></tr>
 +
        </table>
 +
      </li>
 +
      <li>Dashboard fields are updated for the respective recordings uploaded.</li>
 +
    </ol>
 +
    <div style="background-color:#f8e2b3; padding:0.7em; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-top:1em;">
 +
      <p>This is another method to create Tranzman Virtual Agent.</p>
 +
    </div>
 +
  </div>
  
βˆ’
To create a recording please follow the steps here [[ Tranzman_Recorder| Using Recorder]]. But while running the tzm_recorder executable adds a flag of export_db.
+
<div style="display:flex; justify-content:space-between; margin-top:2rem; padding:1rem; background-color:#ffffff; max-width:90%; margin: 2rem auto 0;">
βˆ’
 
+
  <div style="text-align:left;">
βˆ’
Please enter the command like shown below.
+
    [[File:prev_icon.jpg|30px|link=Tranzman_Recorder]] [[Tranzman_Recorder|Previous]]
βˆ’
Please enter the command like shown below.
+
  </div>
βˆ’
 
+
  <div style="text-align:right;">
βˆ’
<table style="width:50%;color:white;background-color:black;font-family:monospace,monospace;border-collapse:seperate;border-radius:15px 15px;border:3px solid #000;">
+
    [[Installation|Next]] [[File:next_icon.jpg|30px|link=Installation]]
βˆ’
<tr>
+
  </div>
βˆ’
<td>
+
</div>
βˆ’
<font style="color:blue">> </font> tzm_recorder.exe -export_db <br>
 
βˆ’
</td>
 
βˆ’
</tr>
 
βˆ’
</table>
 
βˆ’
 
 
βˆ’
 
 
βˆ’
 
 
βˆ’
Following above steps will give you .zip file e.g. '''TZM_recording_1606735043.zip'''. Copy the output to a location visible to Tranzman Server GUI.
 
βˆ’
 
 
βˆ’
{|style="padding: 5px; width: 85%;"
 
βˆ’
| style="width: 1%;"|[[File:Note.png|30px]]|| style="padding: 10px; width: 85%;"|'''Note:'''  Below steps are based on TZM Recorder ran on a NetBackup Backup Server.
 
βˆ’
|
 
βˆ’
|}
 
βˆ’
 
 
βˆ’
===Step 1===
 
βˆ’
 
 
βˆ’
From Tranzman dashboard , click on  <b>+</b> , enter any IP from Loopback IP Addresses(localhost address) and select platform of the recordings.
 
βˆ’
 
 
βˆ’
[[File:Step1.jpg|border|1100x800px]]
 
βˆ’
[[File:virtual_agent_add_env.gif]]
 
βˆ’
 
 
βˆ’
===Step 2===
 
βˆ’
 
 
βˆ’
Hit the Commit button and click the upload button against the entry created.
 
βˆ’
 
 
βˆ’
[[File:Step2.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 3===
 
βˆ’
 
 
βˆ’
Clink on Choose file and select the recordings taken. Once done, click on upload. This should start the process of creation of virutal agent. Wait for few minutes before the whole process completes. A successfull upload should trigger the Init job and other Query jobs like QueryProduct, QueryConfig, QueryImages, QueryMedia.
 
βˆ’
 
 
βˆ’
 
 
βˆ’
[[File:Step3.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
[[File:Step2_1.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 4===
 
βˆ’
 
 
βˆ’
By now if step 3 is successfull then you should see all the columns on the dashboard being populated for the respective recordings uploaded.
 
βˆ’
Example shown below.
 
βˆ’
 
 
βˆ’
 
 
βˆ’
[[File:Step4.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
So this is how basically a TZM Recorder could be used to create a Virtual Agent for Migrations/Recoveries , from recordings on a disk.
 
βˆ’
 
 
βˆ’
 
 
βˆ’
 
 
βˆ’
== Create Virtual Agent from Recordings on Tape ==
 
βˆ’
 
 
βˆ’
 
 
βˆ’
Now Virtual Agent could also be created using a recording backed up to tapes. This is really helpful in situations where actual recording is huge in size and could not be transferred or shared across network.
 
βˆ’
 
 
βˆ’
But rather than backing up the zip file '''TZM_recording_1606735043.zip''' we have to create a recording in uncompressed format.
 
βˆ’
 
 
βˆ’
For creating a recording in unzipped format please follow the steps here [[ Using Recorder | Using Recorder ]] but before running the tzm_recorder executable add couple of flags with that command.
 
βˆ’
 
 
βˆ’
 
 
βˆ’
Please enter the command like shown below.
 
βˆ’
 
 
βˆ’
{| class="wikitable" style="padding-left: auto; color:#FFFFFF; background-color: black; width: 600px; FONT-FAMILY:monospace,monospace; LINE-HEIGHT:15px; white-space: pre-wrap;
 
βˆ’
|
 
βˆ’
tzm_recorder.exe -export_db -no_zip
 
βˆ’
|}
 
βˆ’
 
 
βˆ’
Above should give you a recording output in uncompressed format. e.g. '''TZM_recording_1606735043'''
 
βˆ’
 
 
βˆ’
Backup the recording to a dedicated tape. Once done, share the Tape Library with Tranzman Server. You could follow [[ Devices | Devices Page ]] for sharing the Tape Library with Tranzman Server.
 
βˆ’
 
 
βˆ’
{|style="padding: 5px; width: 85%;"
 
βˆ’
| style="width: 1%;"|[[File:Note.png|30px]]|| style="padding: 10px; width: 85%;"|'''Note:'''  Below steps are based on TZM Recorder ran on a Data Protector Backup Server.
 
βˆ’
|
 
βˆ’
|}
 
βˆ’
 
 
βˆ’
===Step 1===
 
βˆ’
 
 
βˆ’
From Tranzman dashboard , click on  <b>+</b> , enter any IP from Loopback IP Addresses(localhost address) and select platform of the recordings.
 
βˆ’
 
 
βˆ’
[[File:Step1.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 2===
 
βˆ’
 
 
βˆ’
Hit the Commit button and click the upload button against the entry created.
 
βˆ’
 
 
βˆ’
[[File:Step2.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 3===
 
βˆ’
 
 
βˆ’
In Choose media section enter the mediaID of the tape used for backing up the recorders and click on upload.This should start the process of creation of virutal agent. Wait for few minutes before the whole process completes. A successfull upload should trigger the Init job and other Query jobs like QueryProduct, QueryConfig, QueryImages, QueryMedia.
 
βˆ’
 
 
βˆ’
 
 
βˆ’
[[File:Tape_step3.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
[[File:Tape_step3_1.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 4===
 
βˆ’
 
 
βˆ’
By now if step 3 is successfull then you should see all the columns on the dashboard being populated for the respective recordings uploaded.
 
βˆ’
Example shown below.
 
βˆ’
 
 
βˆ’
[[File:Tape_step4.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
So this is how basically a '''TZM Recorder''' could be used to create a Virtual Agent for Migrations/Recoveries , from recordings on a tape.
 
βˆ’
 
 
βˆ’
 
 
βˆ’
== Create Virtual Agent from Recordings Using Tranzman Shares Over SMB ==
 
βˆ’
 
 
βˆ’
This steps requires to open shares from Tranzman Appliance. Please follow the instructions on [[ Tranzman Shares | Tranzman Shares]] and open the shares accordingly.
 
βˆ’
 
 
βˆ’
Once done run the recorder tool on the backup server and create the recording.
 
βˆ’
 
 
βˆ’
Create a recording in unzipped format by following the steps here [[ Using Recorder | Using Recorder ]] but before running the tzm_recorder executable add couple of flags with that command.
 
βˆ’
 
 
βˆ’
Please enter the command like shown below.
 
βˆ’
 
 
βˆ’
{| class="wikitable" style="padding-left: auto; color:#FFFFFF; background-color: black; width: 600px; FONT-FAMILY:monospace,monospace; LINE-HEIGHT:15px; white-space: pre-wrap;
 
βˆ’
|
 
βˆ’
tzm_recorder.exe -export_db -no_zip
 
βˆ’
|}
 
βˆ’
 
 
βˆ’
Above should give you a recording output in uncompressed format. e.g. '''TZM_recording_1606735043'''
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 1===
 
βˆ’
 
 
βˆ’
From Tranzman dashboard , click on  <b>+</b> , enter any IP from Loopback IP Addresses(localhost address) and select platform of the recordings.
 
βˆ’
 
 
βˆ’
[[File:Step1.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 2===
 
βˆ’
 
 
βˆ’
Previous step should have created a folder in the /data path.
 
βˆ’
 
 
βˆ’
{| class="wikitable" style="padding-left: auto; color:#FFFFFF; background-color: black; width: 600px; FONT-FAMILY:monospace,monospace; LINE-HEIGHT:15px; white-space: pre-wrap;
 
βˆ’
|
 
βˆ’
ls /data/7F000101/
 
βˆ’
data  images  jobs  process run  tools
 
βˆ’
|}
 
βˆ’
 
 
βˆ’
Copy the recordings generated in step 1 to that folder using the mounted share.
 
βˆ’
 
 
βˆ’
e.g.
 
βˆ’
 
 
βˆ’
{| class="wikitable" style="padding-left: auto; color:#FFFFFF; background-color: black; width: 600px; FONT-FAMILY:monospace,monospace; LINE-HEIGHT:15px; white-space: pre-wrap;
 
βˆ’
|
 
βˆ’
ls 7F000101/
 
βˆ’
data  images  jobs  process  TZM_recording_1606735043  run  tools
 
βˆ’
|}
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 3===
 
βˆ’
 
 
βˆ’
Rename the copied folder to recording.
 
βˆ’
mv TZM_recording_1606735043 recording
 
βˆ’
 
 
βˆ’
e.g.
 
βˆ’
 
 
βˆ’
{| class="wikitable" style="padding-left: auto; color:#FFFFFF; background-color: black; width: 600px; FONT-FAMILY:monospace,monospace; LINE-HEIGHT:15px; white-space: pre-wrap;
 
βˆ’
|
 
βˆ’
mv TZM_recording_1606735043/ recording/
 
βˆ’
ls 7F000101/
 
βˆ’
data  images  jobs  process  recording  run  tools
 
βˆ’
|}
 
βˆ’
 
 
βˆ’
 
 
βˆ’
===Step 4===
 
βˆ’
 
 
βˆ’
By now if step 3 is successfull then you should see all the columns on the dashboard being populated for the respective recordings uploaded.
 
βˆ’
Example shown below.
 
βˆ’
 
 
βˆ’
 
 
βˆ’
[[File:Tape_step4.jpg|border|1100x800px]]
 
βˆ’
 
 
βˆ’
 
 
βˆ’
So this is another method of creating a Virtual Agent using Tranzman Shares.
 
βˆ’
 
 
βˆ’
 
 
βˆ’
[[ Recorder | Back to Overview ]]
 

Latest revision as of 16:27, 11 September 2025



Creating a Tranzman Virtual Agent from Recordings

Tranzman recordings can be used as a Virtual Agent to perform a dry run of a Transition (up to selections).
The Virtual Agent replicates the process of a real Transition scenario, helping to understand selection and mapping of configurations.
Selections can be exported or imported onto a production Transition.

Virtual Agents can be created from recordings on Disk, Tape, or via Tranzman Shares over SMB. All methods are detailed below.

Create Virtual Agent from Recordings on Disk

  1. Generate recordings using tzm_recorder. See Using Recorder for details.
  2. Use the -export_db flag to generate recordings for Virtual Agents.
    > tzm_recorder.exe -export_db
  3. This creates a zip file (e.g., TZM_recording_1606735043.zip). Copy it to the system with Tranzman GUI access.
  4. πŸ›ˆ Below steps are based on TZM Recorder run on a NetBackup Backup Server.

  5. From Tranzman dashboard, click +. Enter a loopback IP (for virtual agent), select platform, and click commit.
    Virtual agent add env.jpg
  6. Click Upload Recordings to upload the zip file.
    Virtual agent upload rec.jpg
  7. Creation may take a few minutes. A successful upload triggers the Init job and four Query jobs (QueryProduct, QueryConfig, QueryImages, QueryMedia).
    Virtual agent init job.jpg
  8. Once complete, environment details will be visible.
    Virtual agent add status.jpg
  9. The environment is now ready for Selections and Pre-Assessment.

Create Virtual Agent from Recordings on Tape

  1. Uncompress recordings before backing up to tape.
    Use -no_zip argument to create unzipped recordings.
    > tzm_recorder.exe -export_db -no_zip

    See Using Recorder for details.

  2. Backup the recording folder to a dedicated tape. Share the Tape Library with Tranzman Server ( Devices Page ).
  3. πŸ›ˆ Below steps are based on TZM Recorder run on a Data Protector Backup Server.

  4. On Tranzman dashboard, click +, enter loopback IP, select platform.
    Virtual agent add env.jpg
  5. Click commit and Upload Recordings.
    Virtual agent upload rec dp.jpg
  6. In Choose media, enter the mediaID of the tape and click Upload. Creation starts and triggers Init and Query actions.
    Virtual agent init job dp.jpg
  7. Once complete, dashboard fields are populated with environment details.
    Virtual agent dashboard.jpg

Create Virtual Agent from Recordings Using Tranzman Shares Over SMB

  1. Open a share from Tranzman Appliance ( Tranzman Shares).
  2. Run the recorder tool on the backup server and create the recording (uncompressed). See Using Recorder .
  3. On Tranzman dashboard, click +, enter loopback IP, select platform.
    Virtual agent add env.jpg
  4. Share open creates a directory in /data path.
    > ls /data/7F000101/
    data images jobs process run tools
  5. Copy recordings to the directory using the mounted share.
    > ls 7F000101/
    data images jobs process TZM_recording_1606735043 run tools
  6. Rename the folder to recording.
    > mv TZM_recording_1606735043/ recording/
    ls 7F000101/
    data images jobs process recording run tools
  7. Dashboard fields are updated for the respective recordings uploaded.

This is another method to create Tranzman Virtual Agent.