User`s manual

Utilities - DT6backup, DT6reload, DT6upgrade – Release 3.0
DT7backup, DT7reload
02/04/10 Datatek Applications Inc. 18
5 NOTES ON A PPLICATION O PERATION
The <filename> parameter on the command line is normally associated with the current host. If the –sa
option is not used, the <filename> parameter is associated with the FTP server. If the –sn <name>
option is used and that server is different from the support host running one of these utilities, then the
filename must be specified with a leading ‘/’. Otherwise, the filename can be augmented by the name of
the current directory on the support host where the utility is run.
These utilities normally operate with minimal output. Syntax errors generate an error description and a
usage summary. If any error is detected during operation, the complete transcript of the connection
session with the unit is output followed by a description of the type of error detected. To obtain a
minimal real time report of the stages of normal operation, the –V option may be used. To obtain a
detailed debug transcript in real time, the –d option may be used. Otherwise, the only output is a single
line report from the product that signifies the command completed successfully (multiple lines may be
generated from DT6upgrade). All error messages and connection transcripts are sent to “standard
error”; other output goes to “standard output”.
These utilities may be interrupted by using the appropriate key sequence on the support host. The
utilities forward the interrupt request to the unit (by sending ASCII DEL) and wait for the unit to terminate
its operation. Then the utilities attempt to terminate the connection gracefully. Interrupting the utility a
second time terminates the utility without waiting for the unit.
The DT6backup or DT7backup command is successful if the connection succeeds, login to the unit
succeeds, the unit responds to the back command, no failure messages are detected, and the unit
reports “Backup Complete” all within a reasonable time. If successful, the command exits with code ‘0’,
otherwise code ‘2’ for utility syntax errors or ‘1’ for runtime errors.
The DT6reload command is successful if the connection succeeds, login to the unit succeeds, the unit
responds to the retr command, no failure messages are detected, and the unit reports “Retrieve
complete” or “applications restarting” all within a reasonable time. Note that if no instance numbers
given in the command line have been configured on the unit, the completion message will say “No
applications restarting”, but that is not considered an error. If successful, the command exits with code
‘0’, otherwise code ‘2’ for utility syntax errors or ‘1’ for runtime errors.
The DT7reload command is successful if the connection succeeds, login to the unit succeeds, the unit
responds to the retr command, no failure messages are detected, and the unit reports “Removing
current configuration” and “Stopping bicon” all within a reasonable time. No “instance” parameters
should be supplied, since the DT-7000 unit does not have instances. If successful, the command exits
with code ‘0’, otherwise code ‘2’ for utility syntax errors or ‘1’ for runtime errors.
The DT6upgrade command is successful if the connection succeeds, login to the unit succeeds, the
unit responds to the internal command that initiates software upgrade, no failure messages are
detected, the unit reports the “Sum” of the downloaded file, and the unit reports install is successful.
These utilities depend on the support host
telnet or dkcu command, according to the command line
options given. Those commands must be executable (in the user’s PATH) for connections to be made
to unit consoles.