Differences

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

--- cookbook:networker [2018/09/19 03:24] – [Example Command Line Arguments] 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.
-===== default.ttidef =====
+==== Example Synchronization Definition ====
-default.ttidef file sample with code to:
+<code plain;>
-  * Set CSV file delimiter (2)
+#
-  * Exclude any string that starts with barcode (5)
+# Set the Customer and Media as literal values as they never change
-  * Set customer ID to US01 (8)
+#
-  * Set media ID to LTO (9)
+SetLiteral(CUSTOMER, "ACME");
-  * Set default repository to LIBR (12)
+SetLiteral(MEDIA, "LTO");
-  * extract volume ID from column 1, length 8 characters (15)
+#
-  * extract volume description from column 6, length 50 characters (18)
+# Set the delimiter to a CSV
-  * 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}}