Difference between revisions of "Virtual Agent"

From Tranzman Documentation
Jump to: navigation, search
 
(8 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>
  
===Introduction===
+
<div style="max-width:80%; margin: 0 auto;">
Tranzman recordings can be used as a Virtual agent to perform a dry run of a Transition (till 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;">
Virtual agent replicates the same process of a real Transition scenario, thus helps in understanding the selection and mapping of configurations. <br>
+
    <h2 style="border-bottom:2px solid #f8bbd0; padding-bottom:0.5rem; font-size:1.5em;">Create Virtual Agent from Recordings on Disk</h2>
These selections can also be exported or imported on to a production Transition.
+
    <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>
  
Virtual agent can be created from the recordings on a disk or on a tape. Both the methods are detailed below.
+
  <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;">
 +
    <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>
  
 +
  <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 Virtual Agent from recordings on Disk===
+
<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;">
As a pre-requisite, recordings must be generated. Follow the steps mentioned here [[ Tranzman_Recorder| Using Recorder ]] to generate recordings. <br>
+
    [[File:prev_icon.jpg|30px|link=Tranzman_Recorder]] [[Tranzman_Recorder|Previous]]
 
+
  </div>
Use flag <b>-export_db</b> with tzm_recorder to generate recordings for Virtual agents.
+
  <div style="text-align:right;">
<table style="width:50%;color:white;background-color:black;font-family:monospace,monospace;border-collapse:seperate;border-radius:5px 5px;border:3px solid #000;box-shadow: 5px 5px 10px grey;">
+
    [[Installation|Next]] [[File:next_icon.jpg|30px|link=Installation]]
<tr><td><font style="color:blue">> </font> tzm_recorder.exe -export_db <br></td></tr>
+
  </div>
</table>
+
</div>
 
 
This will create a zip file e.g. '''TZM_recording_1606735043.zip'''. Copy the file to the system from where Tranzman GUI can be accessed.
 
 
 
 
 
<table style="width:50%;border-collapse:seperate;border-radius:5px 5px;box-shadow: 5px 5px 10px #750000;">
 
<tr><td>[[File:Note.png|30px]]</td><td> Below steps are based on TZM Recorder ran on a NetBackup Backup Server </td></tr>
 
</table>
 
 
 
 
 
* From Tranzman dashboard, click on  <b>+</b> icon. In the pop-up box, enter an IP address (loopback IP for virtual agent) and select a platform from dropdown list and click commit.
 
[[File:virtual_agent_add_env.jpg|1100x800px]]
 
 
 
* An environment is now added. Loopback IP is reserved for Virtual agent in Tranzman and GUI  provides option to upload the TZM recordings of the environment.<br>
 
* Click on the <b>Upload Recordings</b> icon to upload the zip file.
 
[[File:virtual_agent_upload_rec.jpg|1100x800px]]
 
 
 
*Above process starts the virtual agent creation. Creation may take few minutes to complete. A successful upload should trigger the Init job and four Query jobs i.e., <b> QueryProduct, QueryConfig, QueryImages, QueryMedia </b>.
 
[[File:virtual_agent_init_job.jpg|1100x800px]]
 
 
 
* Once the above step completes, all the details related to the environment uploaded will be visible (as per image).
 
[[File:virtual_agent_add_status.jpg|1100x800px]]
 
 
 
* The environment is now ready for Selections and Pre-Assessment.
 
 
 
 
 
===To create Virtual Agent from Recordings on Tape===
 
 
 
Virtual Agent can also be created from recordings backed up to tapes. This is helpful in scenarios where actual recording is larger to be transferred or shared across network.
 
 
 
* Uncompress (if compressed) the recordings before backing up it to tape.
 
 
 
TZM Recorder has an option to create recording in unzipped format by using <b>-no_zip</b> argument.
 
<table style="width:50%;color:white;background-color:black;font-family:monospace,monospace;border-collapse:seperate;border-radius:5px 5px;border:3px solid #000;box-shadow: 5px 5px 10px grey;">
 
<tr><td><font style="color:blue">> </font> tzm_recorder.exe -export_db -no_zip <br></td></tr>
 
</table>
 
Refer [[ Using Recorder | Using Recorder ]] for more details.
 
 
 
* Backup the recording folder to a dedicated tape. Once complete, share the Tape Library with Tranzman Server. Please refer [[ Devices | Devices Page ]] for sharing the Tape Library with Tranzman Server.
 
 
 
 
 
<table style="width:50%;border-collapse:seperate;border-radius:5px 5px;box-shadow: 5px 5px 10px #750000;">
 
<tr><td>[[File:Note.png|30px]]</td><td> Below steps are based on TZM Recorder ran on a Data Protector Backup Server</td></tr>
 
</table>
 
 
 
 
 
* On Tranzman dashboard , click <b>+</b> and enter a loopback IP address and select platform of the recordings in the pop-up menu.
 
[[File:virtual_agent_add_env.jpg|1100x800px]]
 
 
 
* Click the <b>commit</b> button and hit on <b>Upload Recordings</b> icon to upload the recordings.
 
[[File:virtual_agent_upload_rec_dp.jpg|1100x800px]]
 
 
 
* In <b>Choose media</b> section enter the mediaID of the tape used for backing up the recordings and click on <b>Upload</b>. This should start the process of virtual agent creation, and the process takes a few minute to complete. A successful upload should trigger the Init action and other actions like QueryProduct, QueryConfig, QueryImages, QueryMedia.
 
[[File:virtual_agent_select_media.jpg|1100x800px]]
 
 
 
[[File:virtual_agent_init_job_dp.jpg|1100x800px]]
 
 
 
* Once the action completes, all the corresponding fields on Dashboard will be populated with environment details from the recordings uploaded.
 
Example shown below.
 
[[File:virtual_agent_dashboard.jpg|1100x800px]]
 
 
 
 
 
===Creating Virtual Agent from Recordings Using Tranzman Shares Over SMB===
 
 
 
This method requires a share opened from Tranzman Appliance. Please follow the topic [[ Tranzman Shares | Tranzman Shares]] for more detailed information.
 
* Execute the recorder tool on the backup server and create the recording.
 
* Create a recording in unzipped format. Refer [[ Using Recorder | Using Recorder ]] for more info.
 
* From Tranzman dashboard , click on  <b>+</b> and enter a loopback IP and select the platform of the recordings.
 
[[File:virtual_agent_add_env.jpg|1100x800px]]
 
 
 
* Share open creates a directory in the /data path.
 
<table style="width:50%;color:white;background-color:black;font-family:monospace,monospace;border-collapse:seperate;border-radius:5px 5px;border:3px solid #000;box-shadow: 5px 5px 10px grey;">
 
<tr><td><font style="color:blue">> </font> ls /data/7F000101/<br>
 
data  images  jobs  process run  tools <br>
 
</td></tr></table>
 
 
 
* Copy the recordings to the directory using the mounted share.
 
<table style="width:50%;color:white;background-color:black;font-family:monospace,monospace;border-collapse:seperate;border-radius:5px 5px;border:3px solid #000;box-shadow: 5px 5px 10px grey;">
 
<tr><td>
 
<font style="color:blue">> </font> ls 7F000101/<br>
 
data  images  jobs  process  TZM_recording_1606735043  run  tools
 
</td></tr></table>
 
 
 
* Rename the folder to '''recording'''.
 
<table style="width:50%;color:white;background-color:black;font-family:monospace,monospace;border-collapse:seperate;border-radius:5px 5px;border:3px solid #000;box-shadow: 5px 5px 10px grey;">
 
<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>
 
 
 
* The above process updates all the fields on the dashboard for the respective recordings uploaded.
 
[[File:virtual_agent_dashboard_NAS.jpg|1100x800px]]
 
 
 
This is another method to create Tranzman Virtual agent.
 
 
 
 
 
 
 
 
 
{| class="wikitable"  style="margin:auto;width:100%;color:blue;text-align:center;borderstyle=ridge;"
 
|-
 
| [[Image:prev_icon.jpg|30px|link=Tranzman_Recorder]]
 
|| [[Image:next_icon.jpg|30px|link=Installation]]
 
|}
 

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.