Differences

This shows you the differences between two versions of the page.

--- cookbook:networker [2018/09/19 03:22] – [Synchronization] Scott Cunliffe
+++ cookbook:networker [2025/01/23 03:50] (current) – [Example Synchronization Definition] Gerard Nicol
@@ Line 3: / Line 3: @@
 [[https://en.wikipedia.org/wiki/EMC_NetWorker|NetWorker]] is a Dell EMC backup solution and is available for Linux, Windows, macOS, NetWare, OpenVMS and Unix.
+===== Data Extraction From Networker =====
+The first step in Synchronizing your Networker Library with TapeTrack is to extract the Volume data from your Networker instance.
+Using the administrative tool mminfo, the Volume data needs to be extracted from the Networker save sets and exported into CSV file format.
+{{mminfo_extract.png}}
 ===== The mminfo command =====
@@ Line 9: / Line 16: @@
 To get a report that is suitable for the TapeTrack Sync command, the following minimum arguments should be used:
-<sxh plain;>
+<code plain;>
 mminfo -xc, -a -r "volume,barcode,family,type,location,pool" > report.csv
-</sxh>
+</code>
 ==== Example mminfo output ====
-<sxh plain;>
+=== Output With Suffix ===
+<code plain;>
 volume,barcode,family,type,location,pool
 L6,000000L6,tape,LTO,Offsite,weekly_full
@@ Line 25: / Line 34: @@
 L6,000006L6,tape,LTO,Offsite,weekly_full
 L6,000007L6,tape,LTO,Offsite,weekly_full
-</sxh>
+</code>
+=== Output Without Suffix ===
+<code plain;>
+volume,barcode,family,type,location,pool
+,000000,tape,LTO,Offsite,weekly_full
+,000001,tape,LTO,Offsite,weekly_full
+,000002,tape,LTO,Offsite,weekly_full
+,000003,tape,LTO,Offsite,weekly_full
+,000004,tape,LTO,Offsite,weekly_full
+,000005,tape,LTO,Offsite,weekly_full
+,000006,tape,LTO,Offsite,weekly_full
+,000007,tape,LTO,Offsite,weekly_full
+</code>
 ==== Post-processing ====
@@ Line 34: / Line 56: @@
 It possible for NetWorker barcodes to be missing the LTO L-Suffix.
-It is always recommended that where possible volumes be loaded into TapeTrack with their L-Suffix, and this suffix can be established by:
+It is always recommended that where possible volumes are loaded into TapeTrack with their L-Suffix, and this suffix can be established by:
-  - The Media ID value if it includes the suffix.
+  - The Media-ID value if it includes the suffix.
-  - Adding an appropriate suffix to the Media ID based upon the value of the Media Type field.
+  - Adding an appropriate suffix to the Media-ID based upon the value of the Media Type field.
-  - Adding an appropriate suffix based upon the range of the Media ID.
+  - Adding an appropriate suffix based upon the range of the Media-ID.
   - Using TapeTrack's Constructive Barcode feature.
 ===== Synchronization =====
-Synchronization with TapeTrack is performed by calling the [[cli:TMSS10Sync|TMSS10Sync]] command line program, along with:
+Synchronization with TapeTrack is performed by calling the [[cli:TMSS10Sync|TMSS10Sync]] command-line program, along with:
   - The CSV file produced by pre-processing the mminfo output.
-  - Command line arguments that instruct the program how to process volumes.
+  - Command-line arguments that instruct the program how to process volumes.
   - A synchronization definition file that instructs the program how to interpret the mminfo output.
+{{networker_sync.png}}
 ==== Example Command Line Arguments ====
-<sxh>
+<code>
-TMSS10Sync -d NetWorker.ttidef -a -S user:-password@server < report.csv
+TMSS10Sync -d Volume.ttidef -a -S user:-password@server < report.csv
-</sxh>
+</code>
 Where:
   * ''-d'' is the path to the Synchronization Definition File.
   * ''-a'' tells the program to add new tape volumes if they are encountered.
-  * ''-S'' tells the program what server to connect to.
+  * ''-S'' tells the program what [[cli:server_argument|Server]] to connect to.
-  * ''Inventory.csv'' is the ''mminfo'' output file.
+  * ''report.csv'' is the ''mminfo'' output file.
+==== Example Synchronization Definition ====
-To interpret the output in the file we use a definition file (default.ttidef) which reads the data in the Networker file, line by line, and parses the information which TMSS10Sync then uses to update the volumes location (and other data as specified) in the TapeTrack Server.  It is best practice to write the definition file in a program like Notepad or Vi to ensure it is plain text and has no hidden control characters.
+<code plain;>
+#
-===== default.ttidef =====
+# Set the Customer and Media as literal values as they never change
+#
-default.ttidef file sample with code to:
+SetLiteral(CUSTOMER, "ACME");
-  * Set CSV file delimiter (2)
+SetLiteral(MEDIA, "LTO");
-  * Exclude any string that starts with barcode (5)
+#
-  * Set customer ID to US01 (8)
+# Set the delimiter to a CSV
-  * Set media ID to LTO (9)
+#
-  * Set default repository to LIBR (12)
-  * extract volume ID from column 1, length 8 characters (15)
-  * extract volume description from column 6, length 50 characters (18)
-  * If description contains the string "Offsite" set repository to **OFFS** (21)
-<sxh plain;>
-# Set CSV delimiter
 SetCSVDelimiter(",");
+#
-# Skip any line that begins with barcode (header)
+# Skip any line that begins with string volume (header)
-AddString(EXCLUSION, 0, "barcode*");
+AddString(EXCLUSION, 0, "volume*");
+#
-# Set customer ID and media ID to sync with
+# Set the Description to the Pool Name
-setLiteral(CUSTOMER, "US01");
+#
-setLiteral(MEDIA, "LTO");
+Extract(DESCRIPTION, 6, 20, 0);
+RemoveSpaces(DESCRIPTION);
-# All volumes initially set to library
+#
-setLiteral(REPOSITORY, "LIBR");
+# Get the Volume-ID from the report
-# Extract Volume ID from column 1 (up to eight characters long)
 Extract(VOLUME, 1, 8, 0);
+#
+# Get the Repository from a translated location
+Extract(REPOSITORY, 5, 20, 0);
+RemoveSpaces(REPOSITORY);
+#
+# Send any volume from the pool **offsite** to OFFS repository, all others to LIBR
+AddTranslation(REPOSITORY, "Offsite*", "OFFS");
+AddTranslation(REPOSITORY, *, "LIBR");
-# Extract volume Description from column 6 (up to fifty characters long)
+</code>
-Extract(DESCRIPTION, 6, 50, 0);
-# Send any volume from the pool **offsite** to OFFS repository
-AddTranslation2(REPOSITORY, DESCRIPTION, "Offsite*", "OFFS");
-</sxh>
-===== Sync Information =====
-Create a batch file with code to run Networkers mminfo command and then TMSS10Sync with the required parameters to input the report.csv file and default.ttidef file.  Running with the -M command will place the Sync in dump mode, which allows you to check the output from the process without executing any alterations in the TapeTrack Server.
-Sample batch file to run mminfo, pass the information to TMSS10Sync and output a dump of information.
-<sxh plain;>
-mminfo -xc, -a -r "volume,barcode,family,type,location,pool" > report.csv
-TMSS10Sync -M < report.csv > stdout.txt 2> stderr.txt
-</sxh>
-When you are happy with the output, remove the -M attribute and insert -S attribute and access credentials for the TMSS10Sync command line.  Adding an attribute -a will add any new volumes in Networker not present in TapeTrack.
-<sxh plain;>
-mminfo -xc, -a -r "volume,barcode,family,type,location,pool" > report.csv
-TMSS10Sync -S user:-password@server -a < report.csv > stdout.txt 2> stderr.txt
-</sxh>
+<- :cookbook:netbackup|NetBackup Sync Cookbook ^ :cookbook:introduction|Cookbook ^ :cookbook:tsm|Tivoli Storage Management Sync Cookbook->
+{{tag> cookbook}}