Tumbleweed

SecureTransport
Windows Client
User’s Guide

Version 4.5.1

Tumbleweed® Communications Corp.

700 Saginaw Drive
Redwood City, CA 94063
(650) 216-2000
http://www.tumbleweed.com
003-DOCSTUG451-002
Copyright Notice
The contents of this manual, the associated Tumbleweed Active Agents™, Tumbleweed SecureTransport™,
Integrated Messaging Exchange (IME) software, Messaging Management System (MMS), Tumbleweed Dynamic
Anti-spam Service™ and other computer programs (hereinafter collectively called “Tumbleweed Software”) offered
by Tumbleweed Communications Corp. (Tumbleweed) are the property of Tumbleweed and are copyrighted. Use
of Tumbleweed Software is governed by the license agreement accompanying the original media. Your right to copy
Tumbleweed Software and its documentation is limited by copyright law. Making copies, adaptations, or
compilation works (except copies of Tumbleweed Software for archival purposes or as an essential step in the
utilization of the program in conjunction with the equipment) without prior written authorization from Tumbleweed
is prohibited by law.
Tumbleweed may revise this publication from time to time without notice.
Copyright 1997-2004 Tumbleweed Communications Corp.
All rights reserved.
Some of the processes, arrangements, user interfaces, transaction sequences, site and system architectures, data
arrangements, and data processing algorithms, described or embodied in the Tumbleweed Software, are covered by
one or more of the following U.S. Patents Nos. 5,790,790; 6,061,448; 6,119,137; 6,151,675; 6,192,407; 399,836;
6,385,655; 6,470,086; 6,487,599; 6,502,191; 6,516,411; 6,529,956; 6,609,196 and 6,651,166.

Restricted Rights Legend

Use, duplication or disclosure by the Government is subject to restrictions set forth in subparagraphs (a) through (d),
excluding subparagraph (c)(2)(iv), of FAR 52.227-19 when applicable, or in DFARS 227.7202-3, and in similar
clauses in the NASA FAR Supplement.

Trademarks
Tumbleweed®, is a registered trademark, and Integrated Messaging Exchange™, IME™, Messaging Management
System (MMS)™, Secure Inbox™, Secure Envelope™, Secure Redirect™, Secure Response™, IME Statements™,
IME Developer™, IME Messenger™, Tumbleweed Secure Mail™, Tumbleweed Dynamic Anti-spam Service™,
Tumbleweed Message Protection Lab™, Tumbleweed Active Agents™ and Tumbleweed SecureTransport™ are
trademarks of Tumbleweed Communications Corp.
Contents
Preface vii

Conventions Used in This Guide ................................................... viii

Contact Information and Support ..................................................... ix
For Tumbleweed Global Support ............................................... ix
For General Information............................................................... x

Chapter 1 Introduction 1

1.1 The SecureTransport Family ............................................................................. 2

1.1.1 SecureTransport Clients .......................................................................... 2
SecureTransport Windows Client Features .......................................... 3
1.2 Related Documentation ..................................................................................... 4
1.3 Hardware and Software Requirements .............................................................. 5
1.3.1 Hardware ................................................................................................. 5
1.3.2 Operating System .................................................................................... 5
1.3.3 Software Requirements ........................................................................... 5
1.4 Installing SecureTransport Windows Client ..................................................... 7

Chapter 2 User Interface 13

2.1 SecureTransport Windows Client Interface .................................................... 14

2.1.1 Accessing the Remote Site Explorer ..................................................... 14
2.1.2 Remote Site Explorer Toolbar .............................................................. 16
2.1.3 Remote Site Explorer Menu Options .................................................... 17
2.1.4 Accessing the Transfer Queue .............................................................. 20
2.1.5 Transfer Queue Toolbar ........................................................................ 22
2.1.6 Transfer Queue Menu Options .............................................................. 23
2.1.7 Viewing the Local Resources Browser ................................................. 25
2.1.8 Shortcut Menu ....................................................................................... 27

Contents iii
 2.1.9 Hot Keys for Logging Information .......................................................27

Chapter 3 Setting Preferences 29

3.1 Overview .........................................................................................................30

3.2 General Preferences .........................................................................................31
3.3 Connection Preferences ...................................................................................35
3.4 File Transfer Preferences .................................................................................39
3.5 Notifications Preferences ................................................................................43
3.6 Advanced Preferences .....................................................................................46
3.6.1 Importing a Root Certificate .................................................................48

Chapter 4 Remote Sites 51

4.1 Overview .........................................................................................................52

4.2 Adding a Remote Site ......................................................................................53
4.2.1 Setting General Preferences for a Remote Site .....................................54
4.2.2 Setting Security Preferences ..................................................................57
4.2.3 Setting Notifications Preferences ..........................................................59
4.3 Connecting to Remote Sites ............................................................................66
4.4 Storing Frequently Used Remote Sites ...........................................................67
4.5 Creating a Desktop Shortcut ............................................................................68
4.6 Modifying a Remote Site ................................................................................69
4.7 Duplicating a Remote Site ...............................................................................70
4.8 Deleting a Remote Site ....................................................................................71

Chapter 5 Scheduling Transfers 73

5.1 Scheduling File Transfers ................................................................................74

5.1.1 Accessing the Schedule Feature ............................................................74
5.2 Setting an Absolute Schedule ..........................................................................75
5.3 Setting a Repeat Schedule ...............................................................................76
5.4 Setting a Limit Schedule .................................................................................79
5.5 Managing Advance Schedules ........................................................................81

iv Contents
Chapter 6 Managing Files and Folders 83

6.1 Overview ......................................................................................................... 84

6.2 Using the Remote Site Explorer for Uploads .................................................. 85
6.3 Performing a Drag-and-Drop of Files ............................................................. 86
6.4 Using the Schedule Upload Dialog Box for Uploads ..................................... 87
6.4.1 Adding Files to the Send Files List ....................................................... 90
6.4.2 Adding Folders to the Send Files List .................................................. 90
6.4.3 Moving Files or Folders ........................................................................ 90
6.4.4 Removing Files or Folders from the List .............................................. 91
6.5 Downloading Files and Folders ...................................................................... 92
6.6 Downloading Files and Folders Using Remote Site Explorer ........................ 93
6.7 Using the Drag-and-Drop Feature ................................................................... 94
6.8 Downloading Files Using Schedule Download Dialog Box ........................... 95

Chapter 7 Command-line Options 99

7.1 Overview ....................................................................................................... 100

7.2 Command-line Options ................................................................................. 101
7.2.1 Reserved Characters for URLs or Paths ............................................. 110
7.2.2 Examples of Command-line Commands ............................................ 111
Additional Examples ........................................................................ 113
7.2.3 Sample Batch Files .............................................................................. 116
Sample Batch File to Verify File Transfer Status ............................ 116
Sample Batch File to Perform Multiple File Transfers .................... 118

Appendix A Frequently Asked Questions 121

A.1 FAQ ............................................................................................................... 122

Index 125

Contents v
vi Contents
Preface

Welcome to the SecureTransport Windows Client 4.5.1 Online Help. This

online help provides a description of the components, capabilities, and
operation of the SecureTransport Windows client. It provides background,
conceptual, and procedural information for planning your SecureTransport
Windows Client installation, and provides instructions for setting up,
configuring, and maintaining the SecureTransport Windows Client.

Check the link for the most recent version of this online help:
http://www.tumbleweed.com/docs

This preface contains the following sections:

Conventions Used in This Guide......................................................... viii
Contact Information and Support.......................................................... ix

vii
 Conventions Used in This Guide
The following type and style conventions are used in this guide.

Table P.1: Conventions

Convention Meaning

body text This font is used for regular body text.

Bold Bold blue text indicates a menu, button, or
icon choice.

Italics Italics indicate a table title, book title, or cross-

reference.

Command The Courier New font indicates application

code or computer generated text.

<locale> Angle brackets indicate a user-specified com-

mand line parameter.

http://www.example.com Small blue print indicates a URL or email link

for additional relevant information.

1., 2., 3., ... Bold blue numbers indicate steps in a proce-
dure.

The Note icon signals additional relevant

information.

The Warning icon signals important informa-

tion that may affect the operation of or may be
a potential threat to the system.

The Tip icon signals a tip that may save time

or effort.

viii Preface
Contact Information and Support
You can use the following contact information.

For Tumbleweed Global Support

Table P.2: Global Support Contact Information

Type of Contact Description

Global Support Online http://www.tumbleweed.com/support/

Global Support Email [email protected]

Global Support Helpline 650-216-2109

Customer Service, [email protected]

License Keys and Ship-
ping Orders

If possible, try to install the Tumbleweed product before contacting a

Tumbleweed Global Support representative directly and have the following
information ready:
• Product version and operating system version.
• The text of the error or warning message.
• A description of the problem and attempts made to fix the problem.
Please include your name, email address, company, and server URL in all
correspondence.

ix
 For General Information
The following modes of contact can be used for general information.

Table P.3: General Contact Information

Type of Contact Description

World Wide Web Visit the Tumbleweed Web site for general informa-
tion and current issues.
http://www.tumbleweed.com

Email Address Send email to the following address:

[email protected]

Telephone Use the following telephone number for general

inquiries:
650-216-2000

Postal Address Send regular mail to the following address:

Tumbleweed Communications Corp.
700 Saginaw Drive
Redwood City, CA 94063

x Preface
1 Introduction

This chapter provides an overview of the SecureTransport family, comprising

of the server and client applications. You can also find information on the
features supported by SecureTransport Windows client, hardware and software
prerequisites, and installation procedure of the SecureTransport Windows client
in this chapter. This chapter is organized into the following sections:
1.1 The SecureTransport Family ................................................................2
1.3 Hardware and Software Requirements .................................................5
1.4 Installing SecureTransport Windows Client .........................................7

1
1.1 The SecureTransport Family
SecureTransport is a family of secure file transfer software products which
helps in critical data interchange and automated document processing.
SecureTransport products provide high performance file transfer capabilities
and facilitate large-volume data movement. The SecureTransport family is
designed for the distribution and collection of commercially valuable files over
the Internet. SecureTransport products are fully compatible with FTP and HTTP
standards. In addition, SecureTransport integrates state-of-the-art security
standards such as Secure Socket Layer (SSL) and digital certificates (X.509).
SecureTransport is a client/server software, which consists of the
SecureTransport server and the SecureTransport client. The SecureTransport
server allows you to set up and maintain a secure file transfer site.
SecureTransport client turns your PC or UNIX workstation into a powerful,
secure, and reliable download and upload manager. SecureTransport client runs
both as a stand-alone application and as a web browser plug-in. SecureTransport
is scalable, which makes it an ideal building block for industrial-strength
extranet applications.
SecureTransport also guarantees extranet data delivery and data integrity while
protecting corporate bandwidth. The Auto Restart feature automatically re-
establishes broken connections and resumes transfers from where they were left
off.
The functionality of SecureTransport can be easily extended through
ActiveAgents™. ActiveAgents are transactional software agents that can initiate
events based on file transfers and can also feed information into back-end
applications such as databases, enterprise scheduling software, and network
printing operations. ActiveAgents also enable adding third-party functionality
to SecureTransport such as virus scanning, file format conversion, or additional
security mechanisms.

1.1.1 SecureTransport Clients

SecureTransport client is available on the following platforms:
• Windows
• UNIX
You can also use a standard web-browser such as Internet Explorer 5.0 (or
higher versions) or Netscape 4.7 (or higher versions) as a client.

2 Chapter 1: Introduction
SecureTransport Windows Client Features
SecureTransport Windows client provides high performance, reliable, and
secure transfer of critical business documents from the SecureTransport server
through the intranet, business extranet, or the Internet. SecureTransport
Windows client connects with the SecureTransport server and safely transmits
large documents, graphics, software, and a range of other file types to or from a
remote network site.
SecureTransport Windows client provides the following features:
• Support for the Auto Restart technology that provides unparalleled
reliability when transferring large files (100 MB - 16 GB) through
unreliable network connections, dial-up connections, overloaded servers,
or the Internet. Auto Restart allows you to restart a file transfer from where
the last transfer was stopped when the connection was interrupted or the
transfer terminated.
• Support for FTP, FTP over SSL, HTTP, or HTTPS file transfers.
• Email notification feature to notify in the event of a file transfer failure.
• Security through encryption of all communications using SSL.
• X.509 certificate support for authentication of client and server identities.
• Tunnel Mode support, which provides a firewall friendly mode that allows
you to connect securely through a firewall or proxy server.
• Support for MD5 checksums that guarantee a secure delivery.
• Supports highly reliable, high performance, and secure transfer of large
files through the Internet or a private network when accessing a
SecureTransport server.
• Supports scheduling of file uploads and downloads for unattended
transfers.
• Support for pausing and resuming file transfers.

1.1 The SecureTransport Family 3

1.2 Related Documentation

SecureTransport Windows client 4.5.1 provides the following documentation.

Table 1.1: Related Documentation

Document Description

• SecureTransport Windows Client This guide provides information

Online Help about the SecureTransport Win-
• SecureTransport Windows Client dows client application. Information
User Guide covered includes: installation proce-
dure, features supported, tasks and
activities that you can perform using
the SecureTransport Windows cli-
ent, migration information, and fre-
quently asked questions.

SecureTransport Windows Client This document provides details on

Release Notes new features and enhancements in
the current version of SecureTrans-
port Windows client, the known
issues in the current version, and
the issues resolved in this version.

Third Party Credits Document This document provides information

on the third party software and utili-
ties used to develop SecureTrans-
port Windows client.

4 Chapter 1: Introduction
1.3 Hardware and Software Requirements
The following sections detail the hardware and software requirements for
installing SecureTransport Windows client 4.5.1.

This release of the product allows upgrades only from

SecureTransport 4.0, 4.2, and 4.2.1 versions.

1.3.1 Hardware
The following are the necessary hardware requirements:
• 133 MHz (or faster) Pentium-compatible processor.
• 64 MB RAM (or higher).
• 20 MB of free hard disk space.

1.3.2 Operating System

Any of the following operating systems is a prerequisite to install
SecureTransport Windows client:
• Windows XP Professional
• Windows 2000 Professional/Server
• Windows 2003 SE

To install SecureTransport Windows client, the user must

have administrative privileges on the system, or at least be
a member of the Administrator or Power user groups.

1.3.3 Software Requirements

Internet Explorer 6.0 or later versions, which includes the following DLLs
(Dynamic Link Library):

1.3 Hardware and Software Requirements 5

 • Cryptui.dll: This DLL is required to perform cryptographic operations.
• msxml3.dll: This DLL is required for sending the email notification in the
event of a file-transfer failure. A file transfer failure generates the
following error message if msxml3.dll is not present in the system32
directory: Error Initiating SAX reader.

6 Chapter 1: Introduction
1.4 Installing SecureTransport Windows Client
Install SecureTransport Windows client 4.5.1 from the installation CD.

This product is intended to function only in a single-user

environment.

To install SecureTransport Windows client 4.5.1:

1. In the installation CD provided, browse to the location where the
executable file, STWin32Client_451_EN.exe, is located.

1.4 Installing SecureTransport Windows Client 7

 2. Double-click on the STWin32Client_451_EN.exe file to start the installation
process of SecureTransport Windows client. The SecureTransport Client
Setup dialog box appears as shown in Figure 1.1.

Figure 1.1: SecureTransport Client Setup Dialog Box

8 Chapter 1: Introduction
3. Click Next. The SecureTransport Client License Agreement dialog box
appears as shown in Figure 1.2.

Figure 1.2: SecureTransport Client License Agreement Dialog Box

1.4 Installing SecureTransport Windows Client 9

 4. Click Yes to accept the license agreement. The Select destination directory
dialog box appears as shown in Figure 1.3.

Figure 1.3: Select Destination Directory Dialog Box

5. Click Next to install the SecureTransport Windows client in the default

folder (C:\Program Files\Tumbleweed\STClient). Alternatively, you can click
Browse to specify the installation folder for the SecureTransport Windows

10 Chapter 1: Introduction
 client. The SecureTransport Client Setup Complete dialog box appears as
shown in Figure 1.4.

Figure 1.4: SecureTransport Client Setup Complete Dialog Box

6. The View ReleaseNotes check box is selected by default. Clear this check
box if you do not want to view the release notes associated with the
product.
7. Click Finish. This completes the installation process of SecureTransport
Windows client 4.5.1.

1.4 Installing SecureTransport Windows Client 11

12 Chapter 1: Introduction
2 User Interface

This chapter provides information on the graphical user interface of the

SecureTransport Windows client. This chapter explains the following:
2.1 SecureTransport Windows Client Interface ........................................14

13
2.1 SecureTransport Windows Client Interface
The SecureTransport Windows client provides the following graphical user
interfaces:
• Remote Site Explorer
• Transfer Queue

2.1.1 Accessing the Remote Site Explorer

You can use the Remote Site Explorer interface to connect to a remote site,
schedule uploads or downloads, view the progress of file transfers, and set site-
specific preferences.

A remote site is a file transfer source or destination to which

the SecureTransport Windows client makes a connection.
For more information on remote sites, refer Chapter 4.

To access the Remote Site Explorer, do one of the following:

1. Select Start > Programs > Tumbleweed > SecureTransport Client >
SecureTransport.
2. Right-click the SecureTransport Client icon present in the system tray of
the taskbar. From the shortcut menu, select Connect.

14 Chapter 2: User Interface

3. Open the Transfer Queue (Refer 2.1.4 Accessing the Transfer Queue on
page 20 for accessing the Transfer Queue). From the Transfer Queue, click
the Connect icon on the toolbar.
The Remote Sites Explorer appears along with the Remote Sites dialog
box as shown in Figure 2.1.

Figure 2.1: Remote Sites Explorer with Remote Sites Dialog Box

The list of configured remote sites appear in the Remote Sites dialog box.
Select a remote site and click on Connect to establish a connection to that
specific site. For additional information, refer Chapter 4.

2.1 SecureTransport Windows Client Interface 15

 2.1.2 Remote Site Explorer Toolbar
The Remote Site Explorer toolbar has the following icons.

Table 2.1: Remote Site Explorer-Icons and Shortcuts

Icon Name Description

Connect (F10) Opens the Remote Sites dialog box using which
you can connect to remote sites.

Disconnect Disconnects the connection to the remote site.

(F12)

Transfer Queue Opens the Transfer Queue.

Progress Opens the Progress window, which displays the

current status of files being transferred.

Preferences... Displays the Preferences window using which you

can configure SecureTransport Windows client
settings.

Logging Use to enable or disable logging.

View Log Opens a window using which you can view the log
details.

View Local Use to view or close the local browser.

Browser

Refresh (F5) Use to refresh the current view.

Upload... Opens the Upload window to upload the selected

file(s).

Download Opens the Download window so that you can

specify the download directory for the selected
files.

Delete Deletes the selected file(s) or folder(s) both locally

and from the remote site.

16 Chapter 2: User Interface

 Table 2.1: Remote Site Explorer-Icons and Shortcuts

Icon Name Description

Views Displays the details of the file or folder. You can

choose one of the following options:
• Large Icons
• Small Icons
• List
• Details

Scheduled Opens the Schedule Upload dialog box.

Upload

Scheduled Opens the Schedule Download dialog box.

Download

Quick Help Launches the online help of SecureTransport Win-

dows client.

2.1.3 Remote Site Explorer Menu Options

The Remote Site Explorer menu provides the following options.

Table 2.2: Remote Site Explorer Menu Options

Menu Option Description

File Connect Displays the Remote Sites

dialog box.

Disconnect Disconnects from the cur-

rently active remote site
connection.

Download Displays the Schedule dia-

log box.

Upload Uploads the selected file to

the specified folder in the
remote site.

View File Displays the selected file.

New Folder Creates a new folder in the

remote site.

2.1 SecureTransport Windows Client Interface 17

 Table 2.2: Remote Site Explorer Menu Options

Menu Option Description

Delete Deletes a selected file after

confirmation.

Rename Renames a selected file.

Properties Displays the properties of a

selected file.

Close Closes the currently active

remote site connection and
minimizes the window to
system tray.

Exit Closes the SecureTransport

Windows client application.

Edit Select All Selects all the files and

directories listed in the
remote site.

Invert Selection Cancels the effect of the

Select All option.
Note: If the Select All option
was not selected earlier, this
option selects all the files
and directories listed in the
remote site.

Quote Sends a command typed by

you to the server.
Note: This option is non-
functional and will be
removed in a forthcoming
release.

Change Password Displays the Change Pass-

word dialog box.

Preferences Displays the Preferences

dialog box.

View Toolbar Display/Hide the toolbar.

Status Bar Display/Hide the Status Bar.

18 Chapter 2: User Interface

Table 2.2: Remote Site Explorer Menu Options

Menu Option Description

View Local Resources Display/Hide the Local

Resources Browser.

Large Icons Displays the files in the

remote site as large icons.

Small Icons Displays the files in the

remote site as small icons.

List Displays the files in the

remote site as a list.

Details Displays the files in the

remote site along with the
details of the file.

Transfer Queue Displays the Transfer Queue

window.

Arrange Icons Arranges the display of the

file icons in the remote site
based on any of the follow-
ing options:
• by Name
• by Size
• by Date
• by Type
• by URL

Refresh Refreshes the display of the

Remote Explorer window.

Schedule Uploads... Displays the Schedule

Upload dialog box.

Downloads... Displays the Schedule

Download dialog box.

Prompt on transfer Enables/Disables the

prompt when a file transfer
is initiated.

Help Quick Help Displays the SecureTrans-

port Windows client online
help.

2.1 SecureTransport Windows Client Interface 19

 Table 2.2: Remote Site Explorer Menu Options

Menu Option Description

About SecureTransport Displays the About Secure-

Transport dialog box, which
contains SecureTransport
Windows client version num-
ber and copyright duration.

2.1.4 Accessing the Transfer Queue

You can use the Transfer Queue interface for performing tasks related to file
transfer.

To access the Transfer Queue, do one of the following:

1. From the Remote Site Explorer, click the Transfer Queue icon on the
toolbar.
2. From the Remote Site Explorer menu, select View > Transfer Queue.
3. Right-click the SecureTransport Client icon in the system tray of the
taskbar. From the shortcut menu, choose Transfer Queue.

20 Chapter 2: User Interface

The Transfer Queue window is shown in Figure 2.2.

Figure 2.2: Transfer Queue Window

2.1 SecureTransport Windows Client Interface 21

 2.1.5 Transfer Queue Toolbar
The Transfer Queue toolbar has the following icons and shortcuts on the
toolbar.

Table 2.3: Transfer Queue--Icons and Shortcuts

Icon Name Description

View Displays the following information on

transfers:
• Scheduled Downloads
• Scheduled Uploads
• Downloaded Files
• Uploaded Files

Transfer now Performs the file transfer immedi-

ately.

Schedule Displays the Schedule dialog box to

schedule the transfer of files

Change Destination Allows to change the location to store

a received file.

Information... Displays the information on the files

to be transferred.

Remove Removes selected file(s) from the

Transfer Queue.

Connect...(F10) Opens the Remote Sites dialog box

using which you can connect to
remote sites.

Progress Opens the Progress window, which

displays the current status of files
being transferred.

22 Chapter 2: User Interface

 Table 2.3: Transfer Queue--Icons and Shortcuts

Icon Name Description

Preferences... Displays the Preferences window

using which you can configure
SecureTransport Windows client set-
tings.

Upload Opens the Schedule Upload dialog

box.

Download Opens the Schedule Download dialog

box.

Quick Help Launches the online help for Secure-

Transport Windows client.

2.1.6 Transfer Queue Menu Options

The Transfer Queue menu provides the following options.

Table 2.4: Transfer Queue Menu Options

Menu Option Description

File Connect Displays the Remote Sites

dialog box.

Transfer Now Performs the selected file

transfer immediately.

Schedule... Displays the Schedule dia-

log box.

Change Destination... Allows you to change the

target directory for file trans-
fer.

Information... Displays information about

the file scheduled for trans-
fer.

Remove Deletes a scheduled file

transfer.

2.1 SecureTransport Windows Client Interface 23

 Table 2.4: Transfer Queue Menu Options

Menu Option Description

Open URL Displays the Open URL dia-

log box.

Close Closes the Transfer Queue

window.

Edit Undo Cancels the previous action.

Cut Removes the file from the

list in the Transfer Queue
and places the file in the
clipboard.

Copy Copies the file to a clip-

board.

Paste Pastes the file from the clip-

board to the specified locat-
tion.

Select All Selects all the files and

directories listed in the
Transfer Queue window.

Invert Selection Cancels the effect of the

Select All option.
Note: If the Select All option
was not selected earlier, this
option selects all the files
and directories listed in the
remote site.

Preferences... Displays the Preferences

dialog box, using which you
can specify the preferences
for SecureTransport Win-
dows client.

View Toolbar Displays or hides the Tool-

bar.

Status Bar Displays or hides the Status

Bar.

Progress Window Displays the Progress win-

dow.

24 Chapter 2: User Interface

 Table 2.4: Transfer Queue Menu Options

Menu Option Description

Scheduled Downloads Displays the list of files

scheduled for download.

Scheduled Uploads Displays the list of files

scheduled for upload.

Downloaded Files Displays the list of down-

loaded files.

Uploaded Files Displays the list of uploaded

files.

Schedule Uploads... Displays the Schedule

Upload dialog box.

Downloads... Displays the Schedule

Download dialog box.

Help Quick Help Displays the SecureTrans-

port Windows client online
help.

About SecureTransport Displays the About Secure-

Transport dialog box, which
contains SecureTransport
Windows client version num-
ber and copyright duration.

2.1.7 Viewing the Local Resources Browser

When you launch the SecureTransport Windows client, the Local Resources
Browser appears on the left pane of the Remote Site Explorer window.

To use the Local Resources Browser as a floating window (see Figure 2.3 on
page 26), do one of the following:
1. Place the Local Resources Browser anywhere on the Remote Site
Explorer.
2. Double-click on the title bar of the Local Resources Browser.

2.1 SecureTransport Windows Client Interface 25

 Figure 2.3: Floating Local Resources Browser

To dock the Local Resources Browser, do one of the following actions:

1. Drag the Local Resources Browser to the left side of the Remote Site
Explorer.
2. Double-click the title bar of the Local Resources Browser.

The Local Resources Browser displays the folder you visited

in your previous session using SecureTransport Windows
client.

26 Chapter 2: User Interface

2.1.8 Shortcut Menu
The shortcut menu provides easy access to tasks that you need to perform
frequently.
To access the shortcut menu, select the file or folder and right click.

2.1.9 Hot Keys for Logging Information

SecureTransport Windows client provides hot keys to:
• Enable or disable logging
• View log files
Enabling logging helps you in maintaining the details of the file transfer and
command execution when you are connected to a remote site. A log file is
generated for each remote site that you connect to.
The hot keys provided by SecureTransport Windows client for logging are
listed in Table 2.5.

Table 2.5: Hot Key Combinations

Key Combination Description

Ctrl+Alt+L Enables or disables logging.

Ctrl+Alt+V Displays the list of log files generated

for all remote sites to which you con-
nected.
Note: If you are already connected to
a remote site, pressing this hot key
combination displays the log file for
that remote site. This hot key
combination functions only when the
Remote Site Explorer window is
active.

2.1 SecureTransport Windows Client Interface 27

28 Chapter 2: User Interface
3 Setting Preferences

This chapter gives an overview of the preferences that you can set for the
SecureTransport Windows client. This chapter is organized into the following
sections:
3.1 Overview ............................................................................................30
3.2 General Preferences ...........................................................................31
3.3 Connection Preferences......................................................................35
3.4 File Transfer Preferences ...................................................................39
3.5 Notifications Preferences ...................................................................43
3.6 Advanced Preferences ........................................................................46

29
3.1 Overview
You can customize the SecureTransport Windows client using the Preferences
dialog box. Preferences are specified in the following tabs on the Preferences
dialog box:
• General preferences
• Connection preferences
• File Transfer preferences
• Notifications preferences
• Advanced preferences

To access the Preferences dialog box, do one of the following:

• Right-click on the SecureTransport icon on the Task bar. From the shortcut
menu, select Preferences.
• From the Transfer Queue menu, select Edit > Preferences.
• From the Remote Site Explorer menu, select Edit > Preferences.

30 Chapter 3: Setting Preferences

3.2 General Preferences
You can access the general preferences pane by clicking on the General tab. The
General preferences pane is shown in Figure 3.1.
The General preferences pane allows you to:
• Specify the user identification
• Set auto-startup options
• Customize general display options

3.2 General Preferences 31

 Figure 3.1: General Preferences Pane

32 Chapter 3: Setting Preferences

To specify General preferences:
1. Click on the General tab in the Preferences dialog box. The General
preferences pane appears.
2. Type your email address in the User Identification: Email address box. This
email address is used as your password when you login to remote sites as
an anonymous user.
3. Select any one of the following option buttons to determine how you want
SecureTransport Windows client to start automatically at system startup:
• Select the Always option button to launch SecureTransport
Windows client at startup always.
• Select the Only when scheduled transfers are pending option button
to launch SecureTransport Windows client at startup, only if
scheduled file transfers are pending. This option is enabled by
default.
• Select the Never option button to specify that SecureTransport must
not be launched at startup.
4. Choose one or all of the following check boxes:
• Select the Show list of remote sites when starting Secure Transport
check box to display the list of configured remote sites after the
SecureTransport Windows client application is opened. This option
is selected by default.
• Select the Show welcome message when connecting to remote sites
check box to display the welcome message set by the remote site
administrator while connecting to remote sites.
The welcome message can also be a legal message specific to an
organization, which is specified at the remote SecureTransport
server site. For FTP protocol, the welcome message must be
configured at the SecureTransport Administrator User Interface and
for HTTP or HTTPS protocols, a login agent has to be configured to
display the welcome message.
• Select the Show folder messages when entering folders check box to
display folder messages (set by the administrator) specific to a
folder when you access the folder through SecureTransport
Windows client. This option is enabled by default.
• Select the Share connections across explorer and transfer sessions
check box to use a single login session for all activities for the
current profile, instead of leaving the SecureTransport Client to log
on and off for every single transfer. This option is especially useful
when you transfer multiple files using the internal scheduler,

3.2 General Preferences 33

 because no redundant log records are made and any potential
troubleshooting of transfer events using the log files is much easier.
5. Type a specific log file path in the Path box, or leave the box empty if you
want to keep the default log file path - <STCLIENTHOME>\Cache (by
default this is the folder C:\Program
Files\Tumbleweed\STClient\Cache).

The log path is stored in the Windows registry as a LogPath

value under the following key:
HKEY_CURRENT_USER\Software\Tumbleweed\Secur
eTransport\Explorer

If the log path directory specified does not exist, it will not be
created and the system cache will be used instead.

You must restart the SecureTransport Windows Client for a

log path change to take effect.

6. Click Apply. This applies the settings specified for the SecureTransport
Windows client.
7. Click OK. This completes the process of specifying the General
preferences for SecureTransport Windows client.

34 Chapter 3: Setting Preferences

3.3 Connection Preferences
Click on the Connection tab on the Preferences dialog box to access the
Connection preferences pane. The Connection preferences pane appears as
shown in Figure 3.2.
The Connection preferences pane allows you to:
• Specify the mode of connection between the client and the server
• Define the proxy connection settings
• Specify the firewall login method to be used

3.3 Connection Preferences 35

 Figure 3.2: Connection Preferences Pane

To specify Connection preferences:

1. Click on the Connection tab in the Preferences dialog box. The Connection
preferences pane appears.

36 Chapter 3: Setting Preferences

2. Check the Use PASV mode check box if the SecureTransport server
provides the address and port for the client to connect during a file transfer.

This option is enabled by default and is applicable only for

the FTP protocol.

If the Use PASV mode option is not selected, the client is assigned the
PORT mode and the client provides the address and port for the server to
connect during a file transfer. You can specify a custom range of ports to
be used for the data channel for active ftp connections in the respective
boxes under the Use PASV mode check box.

The default starting and end port numbers for the active ftp
range of ports are respectively 1024 and 65535.

The option to set the port range for active ftp connections
data channel is the client-side equivalent of the
SecureTransport server-side passive port range
specification option.

3. Select the Use Dial-up Connection check box if you want to use a dial-up
account. If you select this option, do the following: select your phone list
entries (that have been set up through your control panel) from the
Connection drop-down list.

The Use Dial-up Connection option is enabled only if you

have configured a dial-up connection successfully.

4. Select the Disconnect after transferring scheduled files check box to

automatically disconnect the dialup connection after the scheduled transfer
of files is complete.
5. Select the Use Proxy/Firewall check box if you want to configure the client
to connect to other local network computers through a proxy server or a
firewall.
6. Click Import if you want to import the default proxy settings from
Microsoft Internet Options.

3.3 Connection Preferences 37

 7. Type the FTP or the HTTP proxy server address in the respective Proxy
address box.
8. Type the port number in the Port box.
By default, the following ports are assigned to the FTP and HTTP proxy
servers:
• FTP proxy server-21
• HTTP proxy server-80
9. Click Login to specify the user name and password to connect to the
appropriate proxy server.
10. In the Proxy Exceptions box, type addresses for which you do not want to
use a Proxy server. Use commas to separate multiple entries. Wildcards
can be used in this field.
11. Select the firewall type from the FTP Firewall drop-down list if you want to
enable FTP firewalls.
12. Click Apply. This applies the settings specified for the SecureTransport
Windows client.
13. Click OK. This completes the process of specifying the Connection
preferences for SecureTransport Windows client.

38 Chapter 3: Setting Preferences

3.4 File Transfer Preferences
Click on the File Transfer tab on the Preferences dialog box to access the File
Transfer preferences pane. The File Transfer preferences pane appears as shown
in Figure 3.3.
The File Transfer preferences pane allows you to:
• Specify the file transfer mode
• Set the download and upload options
• Specify the retry settings
• Enable prompts

3.4 File Transfer Preferences 39

 Figure 3.3: File Transfer Preferences Pane

To specify File Transfer preferences:

1. Click on the File Transfer tab in the Preferences dialog box. The File
Transfer preferences pane appears.
2. Choose any of the following option buttons to specify the required file
transfer mode:

40 Chapter 3: Setting Preferences

 • Select the Transfer ALL files as BINARY option button to transfer all
files in the binary format.
• Select the Transfer ALL files as ASCII(text) option button to transfer
all files in ASCII format.
• Select the Transfer only files with the following file endings as
ASCII(text) to specify file suffixes (separated by commas) in the box
provided. For example, if you specify the .html or .txt file suffixes,
all files having a .html or a .txt suffix are transferred in the ASCII
(text) mode and files having other suffixes are transferred in the
binary mode.
This option is enabled by default.
3. Select either or both of the following check boxes:
• Select the Compress files before uploading using check box to have
the client compress files that you are sending. If you select this
option, use the drop-down list (located adjacent to the check box) to
select a compression utility.
• Select the Expand compressed files after downloading check box to
have the client decompress compressed files after download.

Tumbleweed recommends using WinZip® to compress and

decompress files with SecureTransport Windows client.

If a file being downloaded already exists on the local folder (that is, filenames
are the same on both the remote and local folders), you can either overwrite or
use the rename option to prevent the local file from being overwritten.
4. Select the Enable day logging check box if you want to enable daily
logging of transfers.
5. Choose either of the following option buttons to specify download options:
• Select the Overwrite existing file option button to overwrite an
existing file on the local folder if the downloaded file has the same
name as the file present on the local folder. This option is selected
by default.
• Select the Rename existing file option button if you do not want to
overwrite the local file. SecureTransport downloads the remote file

3.4 File Transfer Preferences 41

 to the local folder as filename.<N>.extension, where <N> is a numeric
value in the range 0-9999.
For example, if HelloWorld.txt exists on both the local and remote
folders, SecureTransport downloads the remote file as
HelloWorld.0.txt. The local file remains unchanged.

If the Rename existing file option is selected and a file

download fails, the partially downloaded file is deleted from
the local folder.

6. In the boxes provided under Retry Settings, specify the number of times to
retry a file transfer at specified intervals of time in the event of a file
transfer failure.
You can specify the values in the appropriate text boxes provided. If you
specify 2 as the number of retries to attempt, SecureTransport Windows
client attempts the file transfer thrice. The retry settings interval you spec-
ify is in minutes.
7. Select the Remove from transfer queue when the retry number is exceeded
check box if you want the SecureTransport Windows client to
automatically remove a scheduled transfer from the transfer queue when
the retry number is exceeded.
8. You can choose either or both of the following options to enable prompts:
• Select the Prompt for schedule when transferring files check box if
you want to be prompted for a schedule when you initiate a file
transfer. This option is selected by default.
• Select the Prompt for confirmation when deleting scheduled file
transfers check box if you want a prompt for confirmation when
you delete a scheduled file transfer. This option is selected by
default.
9. Click Apply. This applies the settings specified for the SecureTransport
Windows client.
10. Click OK. This completes the process of specifying the File Transfer
preferences for SecureTransport Windows client.

42 Chapter 3: Setting Preferences

3.5 Notifications Preferences
Click on the Notifications tab on the Preferences dialog box to access the
Notifications preferences pane. The Notifications preferences pane appears as
shown in Figure 3.4.
The Notifications preferences pane allows you to configure the mail server
settings that enable to send email notification in the event of a file transfer
failure. For additional information on configuring notification, refer 4.2.3
Setting Notifications Preferences on page 59.

3.5 Notifications Preferences 43

 Figure 3.4: Notifications Preferences Pane

To specify Notifications preferences:

1. Click on the Notifications tab in the Preferences dialog box. The
Notifications preferences pane appears.
2. Type the hostname or the IP address of the server in the Host box of the
mail server.

44 Chapter 3: Setting Preferences

3. Type the port number of the mail server in the Port box. By default, the
mail server is assigned port 25.
4. Click Apply. This applies the settings specified for the SecureTransport
Windows client.
5. Click OK. This completes the process of specifying the Notifications
preferences for SecureTransport Windows client.

3.5 Notifications Preferences 45

3.6 Advanced Preferences
Click on the Advanced tab on the Preferences dialog box to access the Advanced
preferences pane. The Advanced preferences pane appears as shown in
Figure 3.5.
The Advanced preferences pane allows you to:
• Specify the refresh settings
• Import a root certificate to SecureTransport

46 Chapter 3: Setting Preferences

Figure 3.5: Advanced Preferences Pane

To specify Advanced preferences:

1. Click on the Advanced tab in the Preferences dialog box. The Advanced
preferences pane appears.
2. Specify the time interval to refresh the contents of the folder you access (if
the folder has not been synchronized with its corresponding remote site
folder within a time interval specified). You can set the time interval (from

3.6 Advanced Preferences 47

 the drop-down list) in Hour(s), Minute(s), or Day(s) and specify the value in
the text box provided.
3. Select the Refresh current folder view every check box if you want to
specify the interval in minutes at which you want the folder contents to be
refreshed. Specify the interval in the box provided.
4. Click Import if you want to import a Root Certificate to the Secure
Transport client.
5. Click Apply. This applies the settings specified for the SecureTransport
Windows client.
6. Click OK. This completes the process of specifying the Advanced
preferences for SecureTransport Windows client.

3.6.1 Importing a Root Certificate

Perform the following steps to import a root certificate.

To import a root certificate:

1. Click the Import button to display the Certificates dialog box.

Figure 3.6: Certificates Dialog Box

48 Chapter 3: Setting Preferences

2. Click on the Trusted Root Certification Authorities tab. This lists the trusted
root certificates.
3. Select the required root certificate and click Import. The Certificate Import
Wizard is initiated.
4. Follow the instructions of the Certificate Import Wizard to import the
certificate. For additional information, refer to the corresponding
Microsoft documentation.
If you import a Root Certificate to SecureTransport, SecureTransport identifies
and trusts all hosts that use the Root Certificate. In addition, SecureTransport
also trusts the certificates issued by the Root Certificate.

3.6 Advanced Preferences 49

50 Chapter 3: Setting Preferences
4 Remote Sites

This chapter defines what a remote site is and explains the procedures to add
remote sites, store frequently used remote sites, modify remote site settings, and
delete remote sites. This chapter is organized into the following sections:
4.1 Overview ............................................................................................52
4.2 Adding a Remote Site .........................................................................53
4.3 Connecting to Remote Sites................................................................66
4.4 Storing Frequently Used Remote Sites ...............................................67
4.5 Creating a Desktop Shortcut ..............................................................68
4.6 Modifying a Remote Site ....................................................................69
4.7 Duplicating a Remote Site .................................................................70
4.8 Deleting a Remote Site.......................................................................71

51
4.1 Overview
Remote sites are directories on a SecureTransport server that can be used to
transfer files. You can configure remote sites using the SecureTransport
Windows client. The configured remote sites are displayed in the Remote Sites
dialog box, from where you can access the remote sites for future sessions. This
is similar to adding a web site address as a bookmark in your Internet browser
application, from where you can access the web site for future use.
To access the Remote Sites dialog box dialog box, refer 2.1.1 Accessing the
Remote Site Explorer on page 14. SecureTransport allows you to:
• Add a remote site.
• Connect to a remote site.
• Store frequently used remote sites.
• Create a desktop shortcut for the remote site.
• Modify the details of an existing remote site.
• Duplicate an existing remote site.
• Delete a remote site from the list of configured remote sites.

52 Chapter 4: Remote Sites

4.2 Adding a Remote Site
Click on Add in the Remote Sites dialog box to configure a new remote site.
Refer 2.1.1 Accessing the Remote Site Explorer on page 14 to display the
Remote Sites dialog box. The Explore Remote Sites dialog box appears as
shown in Figure 4.1.

Figure 4.1: Explore Remote Sites Dialog Box

4.2 Adding a Remote Site 53

 The Explore Remote Sites dialog box provides the following tabs using which
you can set the remote site preferences:
• General
• Security
• Notifications

4.2.1 Setting General Preferences for a Remote Site

The General preferences pane appears by default when you access the Explore
Remote Sites dialog box. Alternatively, you can access the General preferences
pane by clicking on the General tab. The General preferences pane appears as
shown in Figure 4.1.
The General preferences pane allows you to:
• Specify the Remote Site settings
• Set the type of login
• Label the remote site

To specify the General preferences:

1. Click on the General tab in the Explore Remote Sites dialog box. The
General Preferences pane appears.
2. Type the name of the Remote Site in the Site Label text box. This name
appears in the Remote Sites dialog box after the remote site is configured.

The Site Label has to be unique and the user interface does
not allow two sites to have the same Site Label.

3. Choose the required transfer protocol for the remote site from the Transfer
Protocoldrop-down list. You can choose the FTP, HTTP, or HTTPS protocol.
4. Type the address of the remote site in the Site Host Address box.
5. Type the port number of the remote site in the Port box. By default,
SecureTransport Windows client assigns the following port numbers to
sites that are configured to use the FTP, HTTP, or HTTPS protocol:
• Port 21-FTP protocol
• Port 80-HTTP protocol
• Port 443-HTTPS protocol

54 Chapter 4: Remote Sites

6. Do either of the following to specify the default local folder:
• Type the name of the default local folder for file transfers in the
Default Local Folder text box.
• Click Browse to select the default local folder.
7. Type the name of the default remote site folder for file transfers in the
Default Remote Folder text box.
8. Choose either of the following option buttons to specify the mode of login:
• Select the as Anonymous option button if you want to use the
anonymous mode to login. The email address you specified in the
3.2 General Preferences on page 31 is used as the password if this
option is enabled.
For anonymous login profiles, the Login and Password fields are
generated automatically by the SecureTransport Windows client.
If you attempt to log in anonymously and do not provide a password
that conforms to the server’s password policy, you will not receive a
warning message.
• Select the using the following identification option button to specify a
login name and password to connect to the remote site. Use the
following fields to specify the login information to the remote site.

If the using the following identification option is selected, you

should either specify a login name and password or select a
user certificate.

Select Login and Password to specify a login name and password

that must be used to connect to the remote site. You have to type the
login name and password in the respective text boxes provided.
Refer the section, To change the password to connect to a remote
site: on page 56, for information on changing a remote site
password after you have set it.
Select User Certificate if you want to identify the user with the help
of a trusted User Certificate. Refer the section, To select a user
certificate: on page 57, for information on selecting a user
certificate.
9. Click Apply. This applies the settings specified for the remote site.
10. Click OK. This completes the process of specifying the General
preferences for a remote site.

4.2 Adding a Remote Site 55

 To change the password to connect to a remote site:
1. From the Remote Site Explorer menu, choose Edit > Change Password.
This displays the Change Password dialog box as shown in Figure 4.2.
You must be connected to the remote site to change the password
associated with that site.

Figure 4.2: Change Password Dialog Box

2. Type the old password and the new password in the respective text boxes
provided.
3. Type the new password for confirmation in the Retype Password text box.
4. Click OK to complete the process of changing the password.

The password change is applied to the site preferences only

after the password is changed successfully at the remote
site server. Ensure that the SecureTransport Windows client
application is closed and opened again for the password
change to be effective.

56 Chapter 4: Remote Sites

 To select a user certificate:
1. Click Choose to select the required User Certificate. The Select Certificate
dialog box appears as shown in Figure 4.3.

Figure 4.3: Select Certificate Dialog Box

2. Select the required certificate and click OK to complete the process of

specifying the User Certificate to be used.

It must be ensured that the user certificate being imported is

set in the medium mode or in a mode that does not prompt
for a password when the certificate key (certkey) is
accessed.

4.2.2 Setting Security Preferences

You can access the Security preferences pane by clicking on the Security tab.
The Security preferences pane appears as shown in Figure 4.4.
The Security preferences pane allows you to:
• Specify the FTP options for the remote site

4.2 Adding a Remote Site 57

 • Set the certificate settings for the remote site

Figure 4.4: Security Preferences Pane

To specify Security preferences:

1. Click on the Security tab in the Explore Remote Sites dialog box. The
Security preferences pane appears.
2. Select either or both of the following check boxes:

58 Chapter 4: Remote Sites

 • Select the Use FTP if FTPS is not supported by the server check box
to instruct SecureTransport to use FTP for the remote site if FTPS is
not supported by the SecureTransport server. This option is enabled
by default.

If this option is not selected and FTPS is not configured to

be supported by the SecureTransport server, a mismatch
error occurs during file transfer.

• Select the Always use firewall-friendly FTP connections check box to

instruct SecureTransport to use firewall-friendly FTP connections.
This option is recommended for use. If firewall-friendly FTP
connections are used, file-transfer instructions are sent unencrypted,
which is identified by the firewall.
3. Select one of the following option buttons to specify an action to be
performed if the root certificate of SecureTransport server is not trusted by
the SecureTransport Windows client:
• Select the Reject connection option button to reject the connection
of a client to the SecureTransport server.
• Select the Prompt for confirmation option button to prompt for a
confirmation before connecting the client to the SecureTransport
server.
• Select the Accept connection option button to allow connection of
the client to the SecureTransport server.
4. Click Apply. This applies the settings specified for the remote site.
5. Click OK. This completes the process of specifying the Security
preferences for a remote site.

4.2.3 Setting Notifications Preferences

Setting the notifications preference allows you to send email notifications to
recipients such as the end user or administrator in the event of a file transfer
failure. You can access the Notifications preferences pane by clicking on the
Notifications tab. The Notifications preferences pane appears as shown in
Figure 4.5.
The Notifications preferences pane allows you to:
• Enable email notification in the event of a file or folder transfer failure.

4.2 Adding a Remote Site 59

 • Specify the email addresses which have to be emailed in the event of a file
or folder transfer failure.
• Select an email notification template.

Figure 4.5: Notifications Preferences Pane

60 Chapter 4: Remote Sites

 You must configure the mail server settings as described in
3.5 Notifications Preferences for notification to function
properly.

To specify Notifications preferences:

1. Click on the Notifications tab in the Explore Remote Sites dialog box. The
Notifications preferences pane appears.
2. Select the Enable Email Notification check box to enable the email
notification feature.
3. Type the email addresses of the people who are authorized to send the
notification in the From box.
4. Type the email addresses of the main recipients of the notification in the To
box.
5. Type the email addresses of the additional recipients, who should also be
notified, in the Cc box.
6. Type the email addresses of the recipients, who should be notified without
publicizing their email addresses, in the Bcc box.
7. Choose an email notification template from the Notification Template drop-
down list. This template will be used to send email notifications to the
specified email addresses.

To create a new email notification template and add it to the

list, create a file named alert-template<number>.xml and
copy it into the following folder:
<LOCAL SYSTEM DRIVE>:\Program
Files\Tumbleweed\STClient\notify
For more information about the content of such a file, check
the list and descriptions of the email notification attributes in
Table 4.1.

8. Click Apply. This applies the settings specified for the remote site.
9. Click the Check Notification button if you want to test your email
notification settings. A test email will be sent to the specified recepient(s).

4.2 Adding a Remote Site 61

 10. Click OK. This completes the process of specifying the Notifications
preferences for a remote site.

SecureTransport Windows client does not store the

notification email if the mail server is nonfunctional at the
time of file or folder transfer failure. Therefore, the mail
server must be functional for the email notification to be sent
to the intended recipients.

The notification template is an XML template file. The XML template file
contains a group of substitution tokens, which are substituted automati-
cally with the attributes related to a file or folder transfer before sending
the email notification. Table 4.1 lists the tokens, based on the email notifi-
cation attributes.

For a folder upload or download failure, individual email

notifications for each file present in the particular folder are
sent to the intended recipients.

62 Chapter 4: Remote Sites

 The following attributes related to a file or folder transfer are included in
the notification template as tokens.

Table 4.1: Email Notification Attributes

Attribute Description Tokens

Profile Attribute Profile attributes are • ${event.profile,name}

attributes specific to a Profile name
remote site such as: • ${event.server.name}
• Profile Name Server to which the client con-
• Server Name nects.
• URL • ${event.server.userid}
• User ID
User ID to login to the server
• Sender
• ${event.profile.email.from}
• Recipients
Sender of the notification.
• ${event.profile.email.to}
Recipients of the notification.
• ${event.profile.email.cc}
Recipients of the notification.
• ${event.server.protocol}
The protocol specified for the
profile.
• ${event.localhost.name}
The local machine name
• ${event.localhost.ip}
IP address of the local
machine.

Transfer Attribute Transfer attributes are • ${event.server.trans-

attributes specific to the fer.type}
file transfer such as: File transfer type (upload or
• Transfer Type download)
(upload/download) • ${event.server.transfer.file-
• File Name name}
Name of the file that is trans-
ferred.

4.2 Adding a Remote Site 63

 Table 4.1: Email Notification Attributes

Attribute Description Tokens

Schedule Schedule attributes are • ${event.server.trans-

Attribute attributes specific to a file fer.schedule}
transfer schedule such as: Schedule attributes specified
• Schedule type for the file transfer
• Schedule date/time
• Schedule destination

Global Attribute Global attributes are • ${event.server.name}

attributes specified for the Host mail server name speci-
SecureTransport Win- fied for the SecureTransport
dows client as Notifica- Windows client.
tions Preferences: • ${event.server.port}
• Host Mail server port.
• Port

General Attribute General attributes are • ${event.date}

attributes specific to a file Date of failure
transfer failure such as: • ${event.time}
• Date and Time of fail- Time of failure
ure.
• ${event.failure.description}
• Description of failure.
Description of failure
• Detailed description of
failure. • ${event.failure.body}
Detailed description of failure
• ${event.failure.subject}
Subject of the notification mail.

It is recommended to set the encoding to UTF-8 for the email notification

templates.
A sample XML template file is shown on the next page.

<?xml version="1.0" encoding=”UTF-8”?>

- <email>
- <header>
<from address="${event.profile.mail.from}" />
<to address="${event.profile.mail.to}" />
<cc address="${event.profile.mail.cc}" />

64 Chapter 4: Remote Sites

<bcc address="${event.profile.mail.bcc}" />
<subject>Failure Alert</subject>
</header>
<body>The transfer type (${event.server.transfer.type})
failed at ${event.time} on ${event.date}. Description:
${event.failure.description}</body>
</email>

The tokens shown in the sample XML file shown above are substituted with the
attributes related to a file transfer automatically and the email notification is sent
to the specified recipients.
Shown below is an example of email notification after the tokens are substituted
with the attributes in the XML template file.
<?xml version="1.0" encoding=”UTF-8”?>
<email>
<header>
<from address="[email protected]"/>
<to address="[email protected]"/>
<cc address="[email protected]"/>
<bcc address="[email protected]"/>
<subject>Failure Alert</subject>
</header>

<body>
The transfer type (Upload) failed at 11:0:26 on
January:21st:2004.
Description: Upload error: MV1.JPG: Access is denied.[(no
error string)]
</body>
</email>

The email notification templates, alert-template1.xml and

alert-template2.xml, are located in the following directory
structure in your system:<Local Drive>:\Program
Files\Tumbleweed\STClient\notify

4.2 Adding a Remote Site 65

4.3 Connecting to Remote Sites
You can connect to a remote site using the Remote Sites dialog box. To access
the Remote Sites dialog box, do one of the following:
• Right-click on the SecureTransport icon in the task bar and from the
shortcut menu, select Connect.
• From the Remote Site Explorer or the Transfer Queue menu, select File >
Connect.

• Click on the Connect icon on the Remote Site toolbar.

The Remote Sites dialog box appears with a list of configured remote sites as
shown in Figure 4.6.

Figure 4.6: Remote Sites Dialog Box

Select the remote site and click Connect to connect to the remote site.
After you are connected to a remote site you can view, upload, or download files
from the remote site.

66 Chapter 4: Remote Sites

4.4 Storing Frequently Used Remote Sites
Every time you add a remote site, the SecureTransport Windows client adds it
to the list that appears on the Remote Sites dialog box. The contents of this list
is stored in a text file named, ExploreProfiles.txt. You can find this file in your
SecureTransport Windows client installation folder (for example, C:\Program
Files\Tumbleweed\STClient\).

If you are re-installing the SecureTransport Windows client,

you must ensure that a copy of the ExploreProfiles.txt file
exists in another location on your hard disk. Once the
upgrade/re-install is complete, you can copy the file back
into the installation folder of SecureTransport Windows
client.
If you do not follow this procedure, you will lose the list of
remote sites you had configured.

4.4 Storing Frequently Used Remote Sites 67

4.5 Creating a Desktop Shortcut
To create a shortcut for the remote site on your desktop:
Select a remote site from the Remote Sites dialog box and click Shortcut. A
shortcut for the remote site is added to your desktop.

68 Chapter 4: Remote Sites

4.6 Modifying a Remote Site
Perform the following steps to modify the configuration details of a remote site.

To modify details of a remote site:

1. Select a remote site from the Remote Sites dialog box.
2. Click Modify. The Explore Remote Sites dialog box appears.
3. Make the required changes using the three tabs provided on the Explore
Remote Sites dialog box.
4. Click Apply to apply the modifications to the remote site.
5. Click OK to accept the modifications. This completes the process of
modifying the details of a remote site.

4.6 Modifying a Remote Site 69

4.7 Duplicating a Remote Site
Perform the following steps to duplicate a remote site that is displayed in the
Remote Sites dialog box.

To duplicate a remote site:

1. Select a remote site from the Remote Sites dialog box.
2. Click Duplicate. A copy of the remote site is added to the list of remote
sites. The name appears with a suffix that indicates the copy number. For
example, the first copy of a remote site named New Remote Site appears as
New Remote Site-1.

70 Chapter 4: Remote Sites

4.8 Deleting a Remote Site
Perform the following steps to delete a remote site from the list of configured
remote sites in the Remote Sites dialog box.

To delete a remote site:

1. Select a remote site from the Remote Sites dialog box.
2. Click Delete. The remote site is removed from the Remote Sites dialog
box.

4.8 Deleting a Remote Site 71

72 Chapter 4: Remote Sites
5 Scheduling Transfers

This chapter provides you information on specifying preferences for scheduling

file transfers. This chapter is organized into the following sections:
5.1 Scheduling File Transfers ..................................................................74
5.2 Setting an Absolute Schedule .............................................................75
5.3 Setting a Repeat Schedule ..................................................................76
5.4 Setting a Limit Schedule ....................................................................79
5.5 Managing Advance Schedules............................................................81

73
5.1 Scheduling File Transfers
You can schedule file transfers (upload or download) using the Schedule feature
provided by SecureTransport Windows client. The Schedule feature supports
the following types of file transfer schedules:
• A transfer that occurs once in the future, known as an Absolute schedule.
• A transfer that is repeated at specific intervals, known as a Repeat
schedule.
• A transfer that is performed only when the specified conditions are
satisfied, known as a Limit schedule.

5.1.1 Accessing the Schedule Feature

To access the schedule feature, click on or the icon present in the
Remote Site Explorer window. The Schedule dialog box allows you to specify
schedules under the following tabs:
• Absolute
• Repeat
• Limit

To perform the schedule immediately, click the (Now icon) present on any
of the tab panes of the Schedule dialog box.

74 Chapter 5: Scheduling Transfers

5.2 Setting an Absolute Schedule
You must use an Absolute schedule when you want to perform a file transfer
once in the future - on a specific day at a specific time.

To setup an Absolute schedule:

1. Click the Absolute tab on the Schedule dialog box. This displays the
Absolute pane as shown in Figure 5.1. This pane appears by default in the
Schedule dialog box.
2. Select the date of transfer from the Date drop-down calendar.
3. Specify the time of transfer in the Time box.

Figure 5.1: Absolute Schedule Dialog Box

4. Click OK to set the schedule. This completes the process of specifying an

Absolute schedule.
According to the absolute schedule shown in Figure 5.1, the SecureTrans-
port Windows client transfers the files on October 21st, 2005 at 2.43 PM.

5.2 Setting an Absolute Schedule 75

5.3 Setting a Repeat Schedule
You can use a Repeat schedule to perform a file transfer repeatedly at regular
intervals.

To setup a Repeat schedule:

1. Click the Repeat tab on the Schedule dialog box. This displays the Repeat
pane as shown in Figure 5.2.
2. Select the start date of file transfer from the Start Date drop-down calendar.
3. Select the end date of file transfer from the End Date drop-down calendar,
or enable the Infinite option above the calendar to schedule an infinite
transfer cycle.

When the Infinite option is enabled, the End Date drop-down

calendar is not accessible.

Figure 5.2: Repeat Schedule Dialog Box

76 Chapter 5: Scheduling Transfers

4. Select the time to start the transfer from the Start Time box.
5. Select the time to end the transfer from the End Time box, or enable the
Infinite option above the calendar to schedule an infinite transfer cycle.

When the Infinite option is enabled, the End Time drop-down

calendar is not accessible.

6. Specify the frequency at which the transfer is to be repeated in the Repeat

every fields provided. You can specify the schedule in Minute(s), Hour(s), or
Day(s).
7. Optionally, you can exclude specific days of the week by selecting the
desired ones in the Excluding list at the right-hand side of the tab page.

Each successive click on the same day of the week

alternatively selects or deselects it for exclusion from the
schedule.

8. Click OK to set the schedule. This completes the process of specifying a

Repeat schedule.
According to the repeat schedule shown in Figure 5.2, the SecureTransport
Windows client transfers the files every day at 6:05 PM to 8:30 PM from
October 21, 2005 onwards, excluding Saturdays and Sundays.

If you configure the end hour of the scheduled transfer only,

without defining an end date, the transfer will be performed
once in every repeat interval, between the specified start
and end hours.

If you only configure the end date without the end hour, the
transfer will be performed once in every repeat interval,
regardless of the current hour. When the specified end date
is reached, it will be deleted from the scheduler.

5.3 Setting a Repeat Schedule 77

 If you configure both the end date and hour, the transfer will
be performed once in every repeat interval during the period
between the specified start and end hours. When the
specified end date is reached, it will be deleted from the
scheduler.

If you exclude specific days from the schedule, no transfers

defined in the respective schedule will be performed on the
exclude days.

78 Chapter 5: Scheduling Transfers

5.4 Setting a Limit Schedule
Using a limit schedule, you can perform transfers based on the conditions
specified for the transfer in the Limit schedule.

To setup a Limit schedule:

1. Click the Limit tab. The Limit pane appears as shown in Figure 5.3.
2. Select the appropriate check boxes and specify the value to be applied as
the limits for the transfer. The options are as follows:
• Year
• Month
• Weekday
• Day
• Hour
• Minute

Figure 5.3: Limit Schedule Dialog Box

5.4 Setting a Limit Schedule 79

 3. Click OK to set the schedule. This completes the process of specifying a
Limit schedule.
According to the limit schedule shown in Figure 5.3, the SecureTransport
Windows client transfers the file on Friday, October 2005, at 18 hours and
2 minutes, on the ninth day of the month.

80 Chapter 5: Scheduling Transfers

5.5 Managing Advance Schedules
Over a period of time, you may accumulate a number of schedules for absolute,
repeated, and limited transfers. The Advance Schedules dialog box displays the
list of scheduled transfers for a file. If you want to modify or remove any of
these schedules, you can do it using the Advance Schedules dialog box.

To manage advance schedules:

1. Click Advance on the Schedule dialog box. The Advance Schedule dialog
box appears as shown in Figure 5.4.
2. Do one of the following:
• Click Add to add a new transfer schedule for the selected file or
folder.
• Click Edit to modify the transfer schedule of the selected file or
folder.
• Click Delete to delete the transfer schedule of the selected file or
folder.

Figure 5.4: Advance Schedule

5.5 Managing Advance Schedules 81

 3. Click OK to confirm the action.

The client does not perform Repeat or Limit schedules that

occur at the Transition Time on the day of the Daylight
Saving Time (DST). This behavior is strictly applicable for
schedules between 2.00AM and 2.59AM PST on DST
Transition Day.
The schedules function normally after the system clock is
adjusted for DST.

82 Chapter 5: Scheduling Transfers

6 Managing Files and Folders

This chapter provides information on performing uploads and downloads of

files using the SecureTransport Windows client. This chapter is organized into
the following sections:
6.1 Overview ............................................................................................84
6.2 Using the Remote Site Explorer for Uploads.....................................85
6.3 Performing a Drag-and-Drop of Files...............................................86
6.4 Using the Schedule Upload Dialog Box for Uploads ........................87
6.5 Downloading Files and Folders.........................................................92
6.6 Downloading Files and Folders Using Remote Site Explorer ...........93
6.7 Using the Drag-and-Drop Feature ....................................................94
6.8 Downloading Files Using Schedule Download Dialog Box ..............95

83
6.1 Overview
You can use SecureTransport Windows client to upload or download single
files or groups of files or folders from your machine or network to a server
through the Internet, intranet, or a corporate extranet.

To upload files or folders, do one of the following:

• Use the Remote Site Explorer.
• Use the Schedule menu of the Transfer Queue.
• Move the files or folders from the Local Resources Browser to the Remote
Site Explorer.
• Move the files or folders from the Windows Explorer to the Remote Site
Explorer.
• Move the files or folders from the desktop to the Remote Site Explorer.

84 Chapter 6: Managing Files and Folders

6.2 Using the Remote Site Explorer for Uploads
You can upload files using the Remote Site Explorer. You can use icons on the
toolbar, options in the shortcut menu, or drag and drop files directly into the
appropriate location to perform a file upload.

To upload files or folders using the Remote Site Explorer:

1. Locate the directory or folder in the remote site where you want to upload
a file.
2. Select the files from the Local Resources Browser and start the upload
using one of the following options:
• Right-click and from the shortcut menu, select Upload.
• Choose File > Upload.

• Click the (Upload icon) on the Remote Site Explorer toolbar.

The Schedule dialog box appears.
3. Choose any of the following options:
• Click Now. The selected items are uploaded immediately to the
current directory that appears in the remote site. You can
alternatively click OK to transfer the selected file immediately.
• Select a tab from the Schedule dialog box to set a schedule. For
more information on setting transfer schedules, refer Chapter 5.
This completes the process of uploading files or folders using the remote site
explorer.

Folder uploads are applicable only for the FTP protocol.

6.2 Using the Remote Site Explorer for Uploads 85

6.3 Performing a Drag-and-Drop of Files
To upload or download files and folders, you can select files with your mouse
and place the files or folders at the required location.

To upload files:
1. Select files with the mouse from one of the following locations and place
them on the remote site:
• The desktop
• The SecureTransport Local Resources Browser
• Windows Explorer
The Schedule dialog box appears.
2. Do one of the following:
• Click Now to start the upload.
• Select a tab from the Schedule dialog box to set a schedule. For
more information on preparing transfer schedules, refer Chapter 5.
The selected items are uploaded to the current directory that appears
in the Local Resources Browser.

86 Chapter 6: Managing Files and Folders

6.4 Using the Schedule Upload Dialog Box for
Uploads
You can schedule transfers to optimize resources for transfers that occur
regularly.

To send a file using the Schedule Upload dialog box:

1. Select Schedule > Uploads from either the Remote Site Explorer or the
Transfer Queue menu. The Schedule Upload dialog box appears as shown
in Figure 6.1.

Figure 6.1: Schedule Upload Dialog Box

2. Select a connection profile from the Connection Profiles drop down list.
The URL Settings display the information from the selected profile. You
can change any information needed for the upload.

If you modify any of the fields, the profile name does not
appear in the Connection Profiles field.

3. Use the Protocol list to select a transfer protocol: FTP, HTTP or HTTPS.

6.4 Using the Schedule Upload Dialog Box for Uploads 87

 4. Enter the address of the server to which you would like to send files, in the
Address field. You can specify either the hostname of the server or the
exact IP address of the server using the standard dot format, for example
205.164.115.160.
5. Enter the port on which the server is assigned a connection in the Port
field.
The default port numbers assigned for each protocol are as follows:
• FTP-21
• HTTP-80
• HTTPS-443
6. Do one of the following activities:
• Enter your user name in the User field.
• Select the Anonymous check box if this upload uses an anonymous
login. The email address specified by you while setting the
preferences as discussed in 3.2 General Preferences on page 31 is
taken as the password if this option is selected.
7. Enter the path where you want the file to be uploaded in the Path field.
The path is the name of the directory to which you want to upload files.
Path names are generally case-sensitive.
If you specify a directory in the Scheduled Upload dialog box, the path can
be left empty to specify the root path. Path names in this dialog box must
be separated only with forward slashes (/). The FTP standard requires the
use of forward slashes, even on operating systems that use the backslash (\)
for filename separation, such as Windows.
Some examples of path names are as follows:
• /example/joe/
• /pub/test/samples/
• /incoming/
Path names entered in this dialog box are treated as URLs and therefore,
all path names must be specified relative to the root level of the server and
not the login directory. Paths relative to the root level (also called absolute
paths) must start with a forward slash (/).

When performing uploads to a folder on the remote site,

ensure that you include the forward slash (/) at the end of the
path specified.

88 Chapter 6: Managing Files and Folders

 The URL to which the file is being sent appears in the Schedule Upload
dialog box.
8. Click OK to start the transfer. The Schedule Upload (Send files to:) dialog
box appears as shown in Figure 6.2. Use this dialog box to select the files
or folders to transfer.

Figure 6.2: Schedule Upload (Send Files to:) Dialog Box

9. Do one of the following actions:

• Click Send to upload the files immediately.
• Select the file and click Schedule if you want to specify a schedule
for the upload. The Schedule dialog box appears. For more
information on setting transfer schedules, refer Chapter 5.
This completes the process of uploading files or folders using the Schedule
Upload dialog box.

Folder uploads are applicable only for the FTP protocol.

6.4 Using the Schedule Upload Dialog Box for Uploads 89

 6.4.1 Adding Files to the Send Files List

To add a file to the list of files to be uploaded:

1. Click Add Files on the Schedule Upload (Send files to:) dialog box. The
Open dialog box appears.
2. Select the files you want to upload.
3. Click Open to add the chosen files to the list of files to be uploaded. The
files appear in the Schedule Upload (Send files to:) dialog box.

You can specify wildcards to list a specific type of files. For

example, if you specify *.txt, all the files that have a .txt
extension are displayed in the Open dialog box.

This completes the process of adding files to the Send Files list.

6.4.2 Adding Folders to the Send Files List

To add a folder to the list of files to be uploaded:

1. Click Add Folder on the Schedule Upload (Send files to:) dialog box. The
Select Folder dialog box appears.
2. Browse to locate a folder you want to upload.

You can specify wildcards to specify the folders you want to

add to the Send Files list.

3. Click OK to add the selected folder to the list of folders to be uploaded.

This completes the process of adding folders to the Send Files list.

6.4.3 Moving Files or Folders

To move files or folders from the local folder:

1. From the Schedule Upload (Send files to:) dialog box, select the items you
want to move.

90 Chapter 6: Managing Files and Folders

 2. Click Toggle Move. The Move column of the Schedule Upload (Send files
to:) dialog box displays Yes.

Folder uploads are applicable only for the FTP protocol.

This completes the process of moving files or folders in the Schedule Upload
dialog box.
If you choose to move files, the files are removed from the local directory and
placed in the remote site. If you choose to move the folders, the empty folders
are retained at the local directory after the transfer is completed.
If you do not want to remove the files or folders, click the Toggle Move button
again. The Move column now displays No.

6.4.4 Removing Files or Folders from the List

To remove files or folders from the list:

1. Select a file or folder from the list of files on the Schedule Upload (Send
files to:) dialog box.
2. Click Remove.
This completes the process of removing files or folders from the list of files in
the Schedule Upload dialog box.

6.4 Using the Schedule Upload Dialog Box for Uploads 91

6.5 Downloading Files and Folders
You can download files using the Remote Site Explorer. You can use icons on
the toolbar, options in the shortcut menu, or drag and drop files directly into the
appropriate location to perform a file download.

To download files or folders, do one of the following:

• Use the Remote Sites Explorer.
• Use the Schedule menu of the Transfer Queue or the Remote Site Explorer.
• Drag and drop from the Remote Site Explorer into the Local Resources
Browser.
• Drag and drop from the Remote Site Explorer into the Windows Explorer.

92 Chapter 6: Managing Files and Folders

6.6 Downloading Files and Folders Using
Remote Site Explorer
You can transfer files using the Remote Site Explorer in the following manner.

To download files or folders using the Remote Site Explorer:

1. Use the Local Resources Browser to locate the directory into which you
want to download a file.
2. Select the files in Remote Site Explorer and do one of the following:
• Right-click and from the shortcut menu, select Download.
• Select File > Download.

• Click the (Download icon) on the Remote Site Explorer toolbar.

The Schedule dialog box appears.
The Local Resources Browser displays the download path specified
in the Remote Site dialog box. If the download path is not specified,
except for the drag-and-drop option, the files are downloaded to the
default location, which is the desktop.
3. Do one of the following:
• Click Now. The selected items are downloaded immediately to the
current directory that appears in the Local Resources Browser. You
can alternatively click OK to transfer the selected file immediately.
• Select a tab from the Schedule dialog box to set a schedule. For
more information on setting transfer schedules, refer Chapter 5.
This completes the process of downloading files and folders using the
Remote Site Explorer.

6.6 Downloading Files and Folders Using Remote Site Explorer 93

6.7 Using the Drag-and-Drop Feature
To download files and folders, you can select files with your mouse and place
the files or folders at the required location.

To download files:
1. Select files with the mouse and place them at one of the following
locations:
• The desktop
• The Transfer Queue
• Windows Explorer
The Schedule dialog box appears.
2. Do one of the following:
• Click Now to start the download.
• Select a tab from the Schedule dialog box to set a schedule. For
more information on preparing transfer schedules, refer Chapter 5.
The selected items are downloaded to the current directory that
appears in the Local Resources Browser.

94 Chapter 6: Managing Files and Folders

6.8 Downloading Files Using Schedule
Download Dialog Box
To optimize resources, you can schedule downloads that occur regularly.

To download files and folders using the Schedule Download dialog box:
1. Do one of the following:
• Access the Remote Site Explorer.
• Access the Transfer Queue.
2. Select Schedule > Downloads. The Schedule Download dialog box appears
as shown in Figure 6.3.

Figure 6.3: Schedule Download Dialog Box

3. Select a connection profile from the Connection Profiles drop-down list.

6.8 Downloading Files Using Schedule Download Dialog Box 95

 The URL Settings display the information from the selected profile. You
can change any of the information required for the download.

If you change any of the fields, the profile name does not
appear in the Connection Profiles field.

4. Use the Protocol list to select a transfer protocol: FTP, HTTP or HTTPS.
5. Enter the address of the server to which you want to send files, in the
Address field. You can specify the exact IP address of the server using the
standard dot format, for example, 205.164.115.160.
6. Enter the port which is assigned to the server for a connection, in the Port
field.
7. Do one of the following:
• Enter your user name in the User field
• Select the Anonymous check box if this download uses an
anonymous login. The email address specified by you while setting
the preferences as discussed in 3.2 General Preferences on page 31
is taken as the password if this option is selected.
8. Enter the path to the files you want to download in the Host Path field.
Path names are generally case-sensitive. If you specify a directory in the
Scheduled Downloads dialog box, the path can be left empty to specify the
root path. On Windows, the backslash (\) character is used in the file paths.
However, do not use the backslash character in the path field to delimit
path names. The FTP standard is the forward slash (/).
Some examples of path names are as follows:
• /example/joe/
• /pub/test/samples/
• /incoming/
When specifying path names, ensure that all path names are absolute path
names, from the root directory of the server. A path name that starts with a
forward slash (/) is not relative to the login directory. This dialog box fol-

96 Chapter 6: Managing Files and Folders

 lows a form-based way to specify a URL, and the URL standard does not
allow usage of relative path names from the login directory.

When performing downloads to a folder, ensure that you

include the forward slash (/) at the end of the path specified.

9. Type the names of the files you wish to download in the File(s)/Folder(s)
field. Press Enter after you type each file name.

You can specify wildcards to download files or folders.

10. Select the Move check box if you want to move the files from the remote
directory. If you choose to move files, the files are removed from the
remote site and placed in the local directory. If you choose to move
folders, the empty folders are retained at the remote site after the transfer is
completed.
11. Enter the path to the local directory where you want the files to be
downloaded, in the Download Path field.
12. Enable the Print file(s) after they are downloaded option if you want the
client to send all downloaded files to the default printer for printing them
out automatically.
13. Do one of the following:
• Click OK to start the download immediately.
• Click Schedule if you want to specify a schedule for the download.
The Schedule dialog box appears. For more information on
preparing transfer schedules, refer Chapter 5.

6.8 Downloading Files Using Schedule Download Dialog Box 97

98 Chapter 6: Managing Files and Folders
7 Command-line Options

This chapter describes the command line options available with the
SecureTransport Windows client and provides examples for using some of the
commands. In addition, examples of batch files written using command-line
options are also provided in this chapter. This chapter is organized into the
following sections:
7.1 Overview ..........................................................................................100
7.2 Command-line Options.....................................................................101

99
7.1 Overview
SecureTransport Windows client provides command-line options, which allow
you to use the command-line interface in Windows to communicate with the
SecureTransport Windows client. The command-line interface can be used as
an alternative to the Graphical User Interface (GUI) of SecureTransport
Windows client. Command line options are also useful for performing
unattended file transfers automatically using a series of command-line options
in a batch file.
If you are upgrading from a previous version of SecureTransport Windows
client to the current version (4.5.1), note that the persistent command line
options are not supported in this version. The options provided are active only
till the command-line interface window is open.

100 Chapter 7: Command-line Options

7.2 Command-line Options
The following command line options are supported by SecureTransport
Windows client 4.5.1.

Table 7.1: Command-line Options

Command Line Option Description

/prefASC If this option is used, it does the fol-

lowing:
• If you are downloading a file
from a UNIX host, this option
converts any linefeeds (ASCII
10, hex 0A) into carriage return
or linefeed pairs (ASCII 13/10,
hex 0D/0A).
• If you are uploading a file to a
UNIX host, this option converts
carriage return or linefeed pairs
into linefeeds.

/prefASCExt “list of ASCII extensions” Use this option to specify a list of file
extensions for which text-mode
transfer must be used (see under
/prefASC).
Each extension must be prefixed
with a period, the extensions must
be separated with commas (no
spaces), and the entire list should
be surrounded by double quotes.
For example:
".txt,.log,.html,.htm"

/prefAskSched Use this option to prompt for sched-

ules by displaying the Schedule dia-
log box when a file transfer is
initiated.

/prefBinary Use this option to perform an exact

byte-by-byte copy of the file.

7.2 Command-line Options 101

 Table 7.1: Command-line Options

Command Line Option Description

/prefExpand If a compressed file is downloaded

and the corresponding decompres-
sion utility is installed in the client
machine, use this option to launch
the decompression utility. Refer the
documentation of the decompres-
sion program to know how extrac-
tion is handled and where the
extracted files are placed after
decompression.

/prefFireType n Use this option to specify the firewall

type to be used. The valid values for
n, and the firewall types to which
they correspond, are:
• 0 USER userID@Host
• 1 USER fireID | PASS firePW |
USER userID@host
• 2 SITE host
• 3 OPEN host
• 4 USER userID@fireID@host |
PASS userPW@firePW
• 5 USER fireID@host | PASS
firePW
• 6 USER userID@host fireID |
PASS userPW | CCT firePW
For example, if you are using a fire-
wall that prompts for the user’s fire-
wall login, followed by the user’s
firewall password and the hostname
login information, use the following
option: /prefFireType 1.

/prefForceSec This option is applicable only to FTP

connections. Use this option to
specify the use of secure connec-
tions.

/prefFriendFire This option is applicable only to FTP

connections. Use this option to
specify the use of firewall-friendly
FTP connections.

102 Chapter 7: Command-line Options

Table 7.1: Command-line Options

Command Line Option Description

/prefMultiple Use this option to set the Secure-

Transport Windows client to re-login
when an attempt to connect to multi-
ple sites is made. This option slows
the transfer rate slightly, but allows
you to explore multiple sites.

/prefNoAskSched Use this option to suppress the

prompts for schedules before initiat-
ing a file transfer.

/prefNoExpand If this option is used, compressed

files that you download are placed in
the target directory and the decom-
pression program is not launched.

/prefNoForceSec Using this option allows both secure

and non-secure FTP connections.

/prefNoFriendFire This option is relevant only for

secure FTP connections. Non-
secure FTP and HTTP connections
are not affected. This option dis-
ables the use of firewall-friendly
FTP connections.

/prefNoProxy This option disables the option to

connect to a remote server through
a proxy server or firewall.

/prefNoUploadCompress Use this option if you want to upload

a file without compressing it first.

/prefOverwrite For a download, if a file with the

same name (but with different con-
tents) exists in the target directory,
SecureTransport overwrites it with
the contents of the transferred file.
Note: If the file already exists in the
target directory and has the same
contents as the file you are
downloading, SecureTransport
Windows client detects this and
does not transfer the file.

7.2 Command-line Options 103

 Table 7.1: Command-line Options

Command Line Option Description

/prefPASV This option forces the server to sug-

gest the port to be used for trans-
mission of FTP data.

/prefPORT If this option is used, the client pro-

vides the port to be used for trans-
mission using FTP.

/prefProxy This option allows to set the proxy

server parameters. Proxy server
parameters cannot be set or
changed from the command line
(except for FTP firewall type, which
controls the order and syntax in
which it accepts user login informa-
tion. For details, see /prefFire-
Type in this table).

/prefRetries n This option specifies the number of

times a file transfer must be
attempted in the event of a file
transfer failure. A value of 0 disables
this option. The minimum value
must be set to 1 to enable this
option. Refer 3.4 File Transfer Pref-
erences on page 39 for additional
information on retry settings.

104 Chapter 7: Command-line Options

Table 7.1: Command-line Options

Command Line Option Description

/prefUnique Use this option if you do not wish to

overwrite the local file when down-
loading the same file from a remote
site. SecureTransport downloads
the remote file to the local folder as
filename.<N>.extension, where <N>
is a numeric value in the range 0-
9999.
For example, if HelloWorld.txt exists
on both the local and remote fold-
ers, SecureTransport downloads the
remote file as HelloWorld.0.txt. The
local file remains unchanged. if you
download it again, the new copy is
named HelloWorld.1.txt; and so
forth.

/prefUploadCompress Use this option if you want to com-

press a file before uploading it.

/log This option is used to enable client-

side connection logging. For every
transfer, a log file is created in the
STClient\Cache directory. The log
file name is a combination of the
host address and port number. For
example, if connected to exam-
ple.com, port 21, the name of the
log file would be example.com-
21.log.

/prefDayLog Use this option to enable day log-

ging of file transfers.

/prefNoDayLog Use this option to disable day log-

ging of file transfers.

7.2 Command-line Options 105

 Table 7.1: Command-line Options

Command Line Option Description

/cmdlineDebugFile file This option appends the command

line to the given file, as it is exe-
cuted (that is, with variables
resolved to their values). This can
be used to debug what is being
passed into the command line. For
example, STClient.exe /cmd-
lineDebugFile c:\temp\cmdline.txt

/deleteAllReceived This option deletes all log entries for

transfers received on the client
machine. This is equivalent to
/deleteReceived 0.

/deleteAllSent This option deletes all log entries for

transfers sent from the client machine.
This is equivalent to /deleteSent
0.

/deleteReceived n This option deletes all log entries for

transfers received on the client machine
n days ago and earlier. For example,
/deleteReceived 1 deletes all log
entries for transfers received before the
current date.

/deleteSent n This option deletes all log entries for

transfers sent from the client
machine n days ago and earlier. For
example, /deleteSent 1 deletes
all log entries for transfers sent
before the current date.

/hidden This option hides the SecureTrans-

port Windows client. If an instance
of the client GUI is already running
when this command is issued, it will
hide that instance.

106 Chapter 7: Command-line Options

Table 7.1: Command-line Options

Command Line Option Description

/move This option performs a move opera-

tion on the specified files or folders.
After the transfer is completed, the
files or folders are removed from the
source directory and placed in the
destination directory. However, If
you move a recursive folder or spec-
ify a wildcard combination to specify
the folders to be moved, the folders
are not removed from the source
directory (empty folders are retained
at the source directory after comple-
tion of transfer).
Note: This command is not sup-
ported for the HTTPS protocol.
Folder uploads are applicable only
for the FTP protocol.

/progress This option shows the progress win-

dow even if the /hidden flag is
enabled.

/quit This option terminates the Secure-

Transport Windows client if it is cur-
rently running. Use this option with
caution, because it will stop the cli-
ent immediately and halt all trans-
fers, including any that are currently
running.

/quitWhenDone This option terminates the Secure-

Transport Windows client when all
transfers are completed.

/RemoveOnError This option removes the task from

the Transfer Queue if an error
occurs for a transfer after exceeding
the number of retries specified using
one of the following:
• Scheduling tab of the Prefer-
ences dialog box
• /prefRetries command-line
option.

7.2 Command-line Options 107

 Table 7.1: Command-line Options

Command Line Option Description

/schedule “date time” This option schedules a transfer for

a later time. The format for date is
m/d/[yy]yy, and the format for time
is h:mm[AM/PM]. For example, the
following command-line fragments
are all equivalent:
• /schedule “5/15/01 1:00PM"
• /schedule "05/15/01 13:00"
• /schedule "5/15/2001 01:00PM"
Note: There is no command-line
equivalent for repeat or limit
schedules.

108 Chapter 7: Command-line Options

Table 7.1: Command-line Options

Command Line Option Description

/statusBAT filename.bat This option creates a batch file to

capture the return status of the ses-
sion. The file pointed at, file-
name.bat is deleted each time the
transfer state of the SecureTrans-
port Windows client changes, and
filename.bat is automatically recre-
ated with the following two lines:
• set SecureTransportSta-
tus=FileDriveStatus
• del filename.bat
where FileDriveStatus is one of
the following values:
• DONE-Transfer is done
• ACTIVE-Transfer is active
• STOP- Transfer has been
stopped
• INVALID-The URL or local path
is invalid
• ERROR-An error has occurred
• WAITING-Waiting to re-transfer
• NOTEXIST-Cannot find the
source file(s) to be transferred
You can execute the SecureTrans-
port Windows client from a batch file
and use the value of
FileDriveStatus to control a
loop that retries a file transfer till the
transfer is performed completely.
For an example, see 7.2.3 Sample
Batch Files on page 116.

7.2 Command-line Options 109

 Table 7.1: Command-line Options

Command Line Option Description

/Remote-Site This option is used to extract the fol-

lowing parameters from the site
(called as profile in earlier versions):
• User name
• Password
• Certificate settings specified for
the site. (Refer4.2.2 Setting
Security Preferences on page 57
for information on the certificate
settings specified for a site.)
• Email notification settings

7.2.1 Reserved Characters for URLs or Paths

You must not use the characters listed in Table 7.2 in a URL or a path you
specify using command-line options. These characters are reserved and you
must substitute the characters with the appropriate character combination to use
them in URLs or paths.

Table 7.2: Reserved Characters and Substitutes

Reserved Character Substitute Characters

; %3B

, %2C

/ %2F

? %3F

: %3A

@ %40

& %26

= %3D

blank space character %20

110 Chapter 7: Command-line Options

 For example, if the user name is user1@example, password is
password@example, address is my.example.com, and path is /my
folder/my?file, you must supply the URL as follows:
ftp://user1%40example:password%40example%40my.example.com/
my%20folder/my%3Ffile

To use the substitute characters (without making them a

substitute for the reserved characters) as such in URLs or
paths, you must prefix a % (percentage) symbol before the
substitute characters.

For example, if you want to specify %40 in the URL, without making it a
substitute for @, you must specify %40 as %%40

7.2.2 Examples of Command-line Commands

Listed below are examples of the /Remote-Site command and its description:

For each example, ensure that the command given is typed

in one line.

stclient.exe ftpu:<URL> <File Path> /prefASC /prefRetries 50

The command shown in the example above performs a file upload using the FTP
protocol and requires you to supply a valid user name and password. The
options given in angled brackets (< >) have to be substituted with the respective
option provided in Table 7.3.
The following are the options passed to the command-line command.

Table 7.3: Options Passed to the Command -line Command

Option Description

stclient.exe Name of the executable file to

start SecureTransport Windows
client 4.5.1.

ftpu This option specifies the FTP

upload instruction.

7.2 Command-line Options 111

 Table 7.3: Options Passed to the Command -line Command

Option Description

Substitute <URL> with the This option specifies the source

following: //username:pass- FTP server identification, port,
word@host- and user name.
name:port/homedir/user/

Substitute <File Path> with Name of the file to upload.

the following: c:\temp\file-
name.txt

prefASC This option converts carriage

return or linefeed pairs into line-
feeds if the file is uploaded to a
UNIX host.

prefRetries 50 This option sets the number of

retry attempts for the file transfer
to 50.

stclient.exe ftpu://192.168.112.95:21/ <File Path> /log /prefNoAskSched

/quitWhenDone /hidden /progress /Remote-Site tumbleweed

The command shown in the example above uploads a file using the FTP
protocol and does not require you to supply the user name and password. The
Remote-Site command extracts the user name and password automatically from
the profile used, which is specified as tumbleweed in the command.
The following are the options passed to the command-line command:

Table 7.4: Options Passed to the Command -line Command

Option Description

stclient.exe Name of the executable file to

start SecureTransport Windows
client 4.5.1.

log This option is used to enable cli-

ent-side logging. For every
transfer, a log file is created in
the STClient\Cache directory.

prefNoAskSched This option disables the dialog

box that prompts for a schedule
before initiating a file transfer.

112 Chapter 7: Command-line Options

Table 7.4: Options Passed to the Command -line Command

Option Description

quitWhenDone This option terminates the

SecureTransport Windows client
when all transfers are com-
pleted.

hidden This option hides the Secure-

Transport Windows client.

progress This option enables the file-

transfer progress window.

Remote-Site This command extracts the site-

specific parameters from the
remote FTP site.

ftpu This option specifies the FTP

upload instruction.

Substitute <File Path> with Name of the file to upload.

the following:
c:\upload\logs.txt

Additional Examples
Listed below are additional examples of command line options. For examples
that contain two alternatives to perform the task, the first command requires you
to supply the login details. The second command, however, does not require you
to supply the login details. The command uses the Remote-Site option that
extracts the login details from the remote site specified in the command:

For each example, ensure that the command given is typed

in one line.

To upload a file using https protocol, use the following command:

stclient.exe httpsu://username:password@hostname:port/homedir/user/
c:\temp\filename.exe

To upload a file using ftp protocol, use the following command:

stclient.exe ftpu://username:password@hostname:port/homedir/user/
c:\temp\filename.txt

7.2 Command-line Options 113

 To upload a file using ftp protocol with the /progress and /log options, use
the following command:
stclient.exe ftpu://username:password@hostname:port/homedir/user/ c:\temp\filename
/progress /log

To upload a file using ftp protocol with the /move, /log, and the /progress
options, use either of the following commands:
• stclient.exe ftpu://username:password@hostname:port/homedir/user/
c:\temp\filename /progress /log /move
• stclient.exe ftpu://hostname:port/homedir/user/ c:\temp\filename /progress /log
/move /Remote-Site sitename

To upload a file using https protocol with the /log, /hidden, and /prefBinary
options, use either of the following commands:
• stclient.exe httpsu://username:password@hostname:port/homedir/user/
c:\temp\filename.exe /hidden /log /prefBinary
• stclient.exe httpsu://hostname:port/homedir/user/ c:\temp\filename.exe /hidden
/log /prefBinary /Remote-Site sitename

To upload a file using https protocol, with /log, /hidden, /prefASC, and
/prefRetries options, use either of the following commands:
• stclient.exe httpsu://username:password@hostname:port/homedir/user/
c:\temp\filename.txt /hidden /log /prefASC /prefRetries 5
• stclient.exe httpsu://hostname:port/homedir/user/ c:\temp\filename.txt /hidden /log
/prefASC /prefRetries 5 /Remote-Site sitename

To download a file using https protocol and the /prefASC, /hidden, and /log
options, use either of the following commands:
• stclient.exe https://username:password@hostname:port/homedir/user/filename.txt
c:\temp /hidden /log /prefASC
• stclient.exe https://hostname:port/homedir/user/filename.txt c:\temp /hidden /log
/prefASC /Remote-Site sitename

To download a file using https protocol with the /log, /hidden, and
/prefBinary options, use either of the following commands:
• stclient.exe
https://username:password@hostname:port/homedir/user/filename.exe c:\temp
/hidden /log /prefBinary
• stclient.exe https://hostname:port/homedir/user/filename.exe c:\temp /hidden /log
/prefBinary /Remote-Site sitename

114 Chapter 7: Command-line Options

To upload a file using ftp protocol with the /hidden, /log, and /prefASC
options, use either of the following commands:
• stclient.exe ftpu://username:password@hostname:port/homedir/user/
c:\temp\filename.txt /hidden /log /prefASC
• stclient.exe ftpu://hostname:port/homedir/user/ c:\temp\filename.txt /hidden /log
/prefASC /Remote-Site sitename

To upload a file using ftp protocol with the /hidden, /log, /prefPASV,
prefRetries, and /prefASC options, use either of the following commands:
• stclient.exe ftpu://username:password@hostname:port/homedir/user/
c:\temp\filename.txt /hidden /log /prefASC /prefPASV /prefRetries 5
/RemoveOnError
• stclient.exe ftpu://hostname:port/homedir/user/ c:\temp\filename.txt /hidden /log
/prefASC /prefPASV /prefRetries 5 /RemoveOnError /Remote-Site sitename

To download a file using ftp protocol with the /hidden, /log, and /prefASC
options, use either of the following commands:
• stclient.exe ftp://username:password@hostname:port/homedir/user/filename.txt
c:\temp /hidden /log /prefASC
• stclient.exe ftp://hostname:port/homedir/user/filename.txt c:\temp /hidden /log
/prefASC /Remote-Site sitename

To upload a file using ftp protocol with the /hidden, /log, /prefBinary, and
/quitWhenDone options, use either of the following commands:
• stclient.exe ftpu://username:password@hostname:port/homedir/user/
c:\temp\filename.exe /hidden /log /prefBinary /quitWhenDone
• stclient.exe ftpu://hostname:port/homedir/user/ c:\temp\filename.exe /hidden /log
/prefBinary /Remote-Site sitename

To download a file using ftp protocol with the /hidden, /log, /prefBinary,
and /prefFriendFire options, use either of the following commands:
• stclient.exe ftp://username:password@hostname:port/homedir/user/filename.exe
c:\temp /hidden /log /prefBinary /prefFriendFire
• stclient.exe ftp://hostname:port/homedir/user/filename.exe c:\temp /hidden /log
/prefBinary /prefFriendFire /Remote-Site sitename

To upload a file containing spaces in the file name, use either of the
following commands:
• stclient.exe ftpu://username:password@hostname:port/homedir/user/ c:\temp\"x y
z.txt"
• stclient.exe ftpu://hostname:port/homedir/user/ c:\temp\"x y z.txt" /Remote-Site
sitename

7.2 Command-line Options 115

 To download a file containing spaces in file name, use either of the
following commands:
• stclient.exe ftp://username:password@hostname:port/homedir/user/"x y z.txt"
c:\temp
• stclient.exe ftp://hostname:port/homedir/user/"x y z.txt" c:\temp /Remote-Site
sitename

For uploads and downloads of files containing blank spaces

in the file name, ensure that the file name is enclosed in
double quotes.

7.2.3 Sample Batch Files

The following sections contain sample batch files that can be used to:
• Verify the file transfer status-transfer.bat
• Perform multiple upload of files-runjobs.bat

Sample Batch File to Verify File Transfer Status

The file, transfer.bat, which verifies the file transfer status can be scripted in the
following way:

In the following sample batch file, sections in boldface must

be typed in one line.

@echo off
set statusbat=%3
del %statusbat%
C:\Progra~1\Tumbleweed\STClient\STclient.exe %1 %2 /progress /prefPORT
/prefNoAskSched /prefRetries 2 /log /statusBAT %statusbat%
echo off
:mainloop
if NOT EXIST %statusbat% goto mainloop

116 Chapter 7: Command-line Options

call %statusbat%
echo "status.bat returned status of" %FileDriveStatus%
if '%FileDriveStatus%'=='ACTIVE' goto mainloop
goto checkbatf
:dodelete
echo "Status not deleted ...."
del %statusbat%
:checkbatf
if EXIST %statusbat% goto dodelete
echo "status deleted ..."
rem Terminate loop if done or if an error condition is reported.
if '%FileDriveStatus%'=='DONE' goto done
if '%FileDriveStatus%'=='ERROR' goto error
if '%FileDriveStatus%'=='STOP' goto stop
if '%FileDriveStatus%'=='INVALID' goto invalid
if '%FileDriveStatus%'=='NOTEXIST' goto notexist
echo "BAD STATUS"
exit -4
:done
echo "Status=DONE"
goto finished
:notexist
echo "Status=NOTEXIST"
goto finished

:error
echo "Status=ERROR"
goto finished
:stop
echo "Status=STOP"
goto finished

7.2 Command-line Options 117

 :invalid
echo "Status=INVALID"
goto finished
:finished
echo "transfer.bat completed"

Sample Batch File to Perform Multiple File Transfers

The file, runjobs.bat, which performs multiple file transfers can be scripted in
the following way:

In the following sample batch file, sections in boldface must

be typed in one line.

@echo off
REM Upload using https
start C:\transfer.bat httpsu://<user>:<passwd>@<host>:<port>/home/<user>/
C:\file.txt /statusBAT C:\result1.bat
REM download using https
start C:\transfer.bat
https://<user>:<passwd>@<host>:<port>/home/<user>/file.txt C:\ /statusBAT
C:\result2.bat
REM Upload using ftp
start C:\transfer.bat ftpu://<user>:<passwd>@<host>:<port>/home/<user>/
C:\file.txt /statusBAT C:\result3.bat
REM download using ftp
start C:\transfer.bat ftp://<user>:<passwd>@<host>:<port>/home/<user>/file.txt
C:\ /statusBAT C:\result4.bat

118 Chapter 7: Command-line Options

119
120 Appendix A:
B Frequently Asked Questions

This appendix lists the Frequently Asked Questions (FAQs) and their solutions.
The following section lists the FAQs:
B.1 FAQ ..................................................................................................122

121
B.1 FAQ

How does SecureTransport Windows client handle ASCII transfers?

During an upload in ASCII format, SecureTransport Windows client con-
verts all line-termination instances (CR or LF) in the file to the line-termi-
nation instance used by the target operating system. For an ASCII
download, SecureTransport Windows client converts all line-termination
instances in the file to CR or LF. The SecureTransport Windows client
uses a transformation algorithm to handle ASCII transfers.

If you perform a binary file upload using HTTPS protocol for

a file containing only CR characters, the file transfer is
successful from the source to the destination. However, if
the same file is transferred back to the source in ASCII mode
using HTTPS protocol and if the file exists at the source, the
file transfer fails.

Why is the drag-and-drop file or folder option not functioning for uploads
or downloads?
Ensure that you have restarted the system after installing or upgrading
SecureTransport Windows client.
I selected the Show welcome message when connecting to remote sites option
in the General Preferences pane. When I connect to a remote site, I get the
<user> successfully logged in message box instead of the welcome message
I specified. How do I solve this?
If you are using the HTTP protocol, ensure that you have configured a
login agent in the HTTP server. For FTP protocol, ensure that the welcome
message is specified at the FTP server.
The SecureTransport server supports RFC 2228. How do I set this in the
SecureTransport Windows client?
SecureTransport Windows client does not support RFC 2228 FTP security
extensions.
When performing file upload to a remote directory, the file gets uploaded
under the remote directory if the remote directory exists. If the remote
directory does not exist, the file gets uploaded with the name of the remote
directory at the remote site. What must be done to resolve this?

122 Appendix B: Frequently Asked Questions

 When performing uploads to a folder on the remote site, ensure that you
include the forward slash (/) at the end of the path specified.
Why do my command line transfers fail when I attempt the transfers as a
virtual user?
Ensure that you have used a ‘/’ for specifying the path to the home direc-
tory instead of supplying the actual path to the home directory. For virtual
users, ‘/’ signifies the full path to the home directory.
While transferring large files (100 MB or more in size), the file transfer is
attempted in the retry mode and the log file displays a timed out message
for the file transfer. What must be done to prevent this?
Ensure that the time-out value in the SecureTransport server configuration
is set to 60 seconds or more.
After configuring the SecureTransport Windows client to send an email
notification, the notification is not sent after a file transfer failure. The log
for the file transfer displays the following message: Error in initiating SAX
reader. How do I solve this issue?
You might not be having the correct version of the Microsoft XML Parser
installed in your computer. Refer 1.3 Hardware and Software Require-
ments on page 5 for additional information.

B.1 FAQ 123

124 Appendix B: Frequently Asked Questions
Index
A
Access the Schedule Feature 74
Adding Files 90
Adding Folders 90
Additional Examples 113
Address 88, 96
Advanced Preferences 46
Specify 47
Anonymous 88, 96

C
Clients 2

125
Command-line Options 101 Contact Information, Tumbleweed x
/cmdlineDebugFile 106 Conventions Used in This Guide viii
/deleteAllReceived 106
/deleteAllSent 106 D
/deleteReceived n 106
/deleteSent n 106 Delete 16, 22
/hidden 106 Disconnect 16
/log 105 Download 16
/move 107 Downloading Files
/prefASC 101 Using Remote Site Explorer 93
/prefASCExt 101 Dragging and Dropping 86, 94
/prefAskSched 101
/prefBinary 101
E
/prefDayLog 105
/prefExpand 102 Examples 111
/prefFireType n 102
/prefForceSec 102 F
/prefFriendFire 102
/prefMultiple 103 FAQs 122
/prefNoAskSched 103 File Transfer Preferences 39
/prefNoDayLog 105 Specify 40
/prefNoExpand 103 Files
/prefNoForceSec 103 Adding to Send 90
/prefNoFriendFire 103 Files to Receive 16
/prefNoProxy 103 Files to Send 16
/prefNoUploadCompress 103 Firewalls
/prefOverwrite 103 FTP 38
/prefPASV 104 FTP 3, 87, 96
/prefPORT 104
FTP Firewall Type 38
/prefProxy 104
/prefRetries n 104
/prefUnique 105 G
/prefUploadCompress 105 General Preferences 30, 31
/progress 107 Access 30
/quit 107 Overview 30
/quitWhenDone 107 Specify 33
/Remote-Site 110
/RemoveOnError 107
/schedule 108
H
/statusBAT 109 Help 17, 23
Additional Examples 113 Host Path 96
Examples 111 Hot Keys 27
Overview 100 HTTP 3, 87, 96
Sample Batch Files 116
HTTPS 3, 87, 96
Connect 16, 22
Connection Preferences 35
Specify 36
I
Connection Profile 87, 95 Identification 33

126
Import a Root Certificate 48 Remote Site Explorer 14
Installing SecureTransport 7 Access 14
Interface 14 Downloading Files 93
Hot Keys 27 Menu Options 17
Uploading Files 85
Remote Site Explorer 14
Remote Site Explorer Toolbar 16
Shortcut Menu 27
Remote Sites 52
Transfer Queue 14
Adding Remote Sites 53
Change Password 56
L Connecting to Remote Sites 52
Create a Desktop Shortcut 68
Local Resources Browser 25
Delete 71
Dock 26
Duplicate 70
View 25
Modify 69
Logging 16 Overview 52
Select a User Certificate 57
M Set General Preferences 54
Setting Notifications Preferences 61
Managing Schedules 81 Setting Security Preferences 58
Storing Frequently Used Remote Sites 67
N Removing Files or Folders 91
Reserved Characters 110
Notifications Preferences 43
Specify 44
S
P Sample Batch Files 116
Schedule Download Dialog 89, 97
PASV 37 Schedule Upload Dialog 89
Path 88 Upload Files 87
Port 88, 96 Scheduling Transfers 74
PORT Mode 37 SecureTransport 2
Preferences 16, 23 SecureTransport Client
General 31 Features 3
Prerequisites 5 Sending Files
Hardware 5 Adding Folders 90
Operating System 5 Removing 91
Software 5 Using Schedule Upload Dialog 87
Setting Schedules
Progress 16, 22
Absolute 75
Protocol 87, 96 Limit 79
Proxy Exceptions 38 Repeat 76
Storing Frequently Used Remote Sites 67
R Support, Technical ix
Refresh 16
Related Documentation 4
T
Remote Site Technical Support ix
Connect 66 Transfer Protocol 87, 96

127
Transfer Queue 14, 16
Access 20
Menu Options 23
Toolbar 22
Tumbleweed Contact Information x
Tunnel Mode 3

U
UNIX Client 2
Upload 16
Upload Files or Folders 85
Uploading Files
Using Remote Site Explorer 85
Using Schedule Upload Dialog 87
URL Settings 87, 96
Use PASV Mode 37
User 88, 96
Using Remote Site Explorer
Download Files 93
Upload Files 85

V
View Local Browser 16
View Log 16

X
X.509 3

128