TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • extensions • volume_notes • replication • promedia_labels • barcode • adding_connection_reg • hiding_media_ids • report_tmss10listusage • reports • tmss10back
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 10:58] – Gerard Nicolcli:tmss10ping [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== TMSS10Ping ====== ====== 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] host''
  
-TMSS10Ping [-n count] [-P port] [-?] [-v] host 
 ===== Description ===== ===== Description =====
 +''TMSS10Ping'' sends dummy packets to a TapeTrack Framework Server and receives a reply packet. 
  
-TMSS10Ping sends dummy packets to a TapeTrack Framework Server and receives a reply packet. It +<note tip> 
-should be noted that unlike the ping(1) command, TMSS10Ping(1) sends payload packets via the TCP/ +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. 
-IP protocol. +</note> 
-Options+===== Options =====
 The options which apply to the TMSS10Ping command are: The options which apply to the TMSS10Ping command are:
--n This option sets the number of test packets to send to an integer other than 4. + 
--P This option sets the TCP/IP port to an integer other than 5000. +  * ''-n'' This option sets the number of test packets to send, set as an Integer (default=4). 
-host Host name or dotted IP address of TapeTrack Framework Server. +  * ''-P'' This option sets the TCP/IP port to, set as an Integer (default=5000). 
-Exit Status +  * ''host'' Host name(DNS) or dotted IP address of the TapeTrack Framework Server. 
-zero Program has ended successfully. + 
-non-zero Program was unable to connect to the TapeTrack Framework Server. +===== Exit Status ===== 
-Environment +  - **zero** Program has ended successfully. 
-TMSSSERVERPROXY If defined the program will route all TapeTrack TCP/IP traffic through +  - **non-zero** Program was unable to connect to the TapeTrack Framework Server. 
-a HTTPS proxy. The value of the variable should be in the format +===== Environment ===== 
-user:password@host:port. To debug the proxy connection use variable + 
-TMSSAPILOGDIR. +  * [[variable:tmssserverproxy|TMSSSERVERPROXY]]  
-TMSSAPILOGDIR If defined the program will write out a trace file to this directory. +  * [[variable:tmssapilogdir|TMSSAPILOGDIR]] 
-Examples+ 
 +===== Files ===== 
 + 
 +  * ''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 34: 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 43: 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 57: 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.1496833130.txt.gz · Last modified: 2025/01/21 22:07 (external edit)