TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • promedia_labels • reports • adding_connection_config • run_command_run_inventory_list • menu • installing • tmss10movelocation • cookbook • config_file • report_examples
cli:tmss10ping

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
cli:tmss10ping [2017/06/07 11:00] – Gerard Nicolcli:tmss10ping [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== TMSS10Ping ====== ====== TMSS10Ping ======
-Test the connection with a TapeTrack Framework Server.+ 
 +Command line programs are executed via a [[technote:commandline|Command Line Prompt]] or via a batch file.  They cannot be executed by double clicking or right click run
  
 ===== Synopsis ===== ===== Synopsis =====
-''TMSS10Ping [-n count] [-P port] [-?] [-v] host''+''TMSS10Ping [-n count] [-P port] host''
  
 ===== Description ===== ===== Description =====
-TMSS10Ping sends dummy packets to a TapeTrack Framework Server and receives a reply packet. It +''TMSS10Ping'' sends dummy packets to a TapeTrack Framework Server and receives a reply packet. 
-should be noted that unlike the ping command, TMSS10Ping sends payload packets via the TCP/IP protocol.+
  
 +<note tip>
 +Unlike the [[https://en.wikipedia.org/wiki/Ping_(networking_utility)|ping]] command which sends ICMP echo packets, ''TMSS10Ping'' sends payload packets via the TCP/IP protocol. This means that even if a firewall is configured to block ping requests, if TapeTrack connections are allowed, then ''TMSS10Ping'' packets will be successful.
 +</note>
 ===== Options ===== ===== Options =====
 The options which apply to the TMSS10Ping command are: The options which apply to the TMSS10Ping command are:
  
-  * Unordered List Item-n This option sets the number of test packets to send to an integer other than 4. +  * ''-n'' This option sets the number of test packets to send, set as an Integer (default=4). 
-  * -P This option sets the TCP/IP port to an integer other than 5000. +  * ''-P'' This option sets the TCP/IP port to, set as an Integer (default=5000). 
-  * host Host name or dotted IP address of TapeTrack Framework Server. +  * ''host'' Host name(DNS) or dotted IP address of the TapeTrack Framework Server. 
-  * +
 ===== Exit Status ===== ===== Exit Status =====
-  - zero Program has ended successfully. +  - **zero** Program has ended successfully. 
-  - non-zero Program was unable to connect to the TapeTrack Framework Server.+  - **non-zero** Program was unable to connect to the TapeTrack Framework Server.
 ===== Environment ===== ===== Environment =====
  
-TMSSSERVERPROXY If defined the program will route all TapeTrack TCP/IP traffic through +  * [[variable:tmssserverproxy|TMSSSERVERPROXY]]  
-a HTTPS proxy. The value of the variable should be in the format +  * [[variable:tmssapilogdir|TMSSAPILOGDIR]] 
-user:password@host:port. To debug the proxy connection use variable + 
-TMSSAPILOGDIR. +===== Files ===== 
-TMSSAPILOGDIR If defined the program will write out a trace file to this directory. + 
-Examples+  * ''stdout'' Program messages indicating statistics from ping. 
 + 
 +===== Examples ===== 
 This example tests a TapeTrack connection on port 443. This example tests a TapeTrack connection on port 443.
 +
 +<code>
 C:\>TMSS10Ping -P 443 tapetrack.ironmountain.com C:\>TMSS10Ping -P 443 tapetrack.ironmountain.com
 44 bytes from 216.229.153.104: seq=1 time=58.00 ms 44 bytes from 216.229.153.104: seq=1 time=58.00 ms
Line 35: Line 43:
 --- tapetrack.ironmountain.com TMSS10Ping statistics --- --- tapetrack.ironmountain.com TMSS10Ping statistics ---
 4 packets transmitted 4 packets transmitted
-TMSS10Ping +
-2+
 round-trip min/avg/max = 0.00/57.75/58.00 ms round-trip min/avg/max = 0.00/57.75/58.00 ms
 +</code>
 This example sends an email if a TapeTrack Server is down. This example sends an email if a TapeTrack Server is down.
 +
 +<code>
 #!/bin/bash #!/bin/bash
 TMSS10Ping -P 443 tapetrack.ironmountain.com > /dev/null TMSS10Ping -P 443 tapetrack.ironmountain.com > /dev/null
Line 44: Line 54:
 sendmail ..... sendmail .....
 fi fi
-Example 1. TMSS10Ping: send pings request via a proxy server, creates a trace file +</code> 
-and displays the trace file.+ 
 +This example sends ping request via a proxy server, creates a trace file and displays the trace file. 
 + 
 +<code>
 set PROXYIP=192.168.1.10 set PROXYIP=192.168.1.10
 set PROXYPORT=3128 set PROXYPORT=3128
Line 58: Line 71:
 type "%TMSSAPILOGDIR%\TMSSAPILOG-*.txt" type "%TMSSAPILOGDIR%\TMSSAPILOG-*.txt"
 pause pause
-Set variable for HTTP Proxy Server address. +</code>
-Set TCP/IP port of HTTP Proxy Server. +
-Set variable for HTTP Proxy Server User-ID (if any). +
-Set variable for HTTP Proxy Server password (if any). +
-Set variable for HTTP Proxy Server address. +
-Set variable for TapeTrack Server address. +
-Set variable for TapeTrack Server port. +
-Set variable for output directory to Windows temp folder. +
-Set variable that tells TMSS10Ping to go via a proxy. +
-Run TMSS10Ping command. +
-List the results. +
-Files +
-stdout Program messages indicating statistics from ping. +
-See Also +
-TMSS10(1) +
-Bugs +
-On the Linux platform all TapeTrack command line programs are compiled with static C runtimes. This +
-means that on some older Linux versions DNS name resolution does not work and you must use dotted +
-IP addresses. +
-TMSS10Ping +
-3+
  
 +--> Changelog
  
 +[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10Ping]
 +<--
 +<- ^ cli:introduction|Command Line Utilities^ ->
cli/tmss10ping.1496833253.txt.gz · Last modified: 2025/01/21 22:07 (external edit)