2 Running and Configuring Oracle SFT

This chapter described how to run Oracle Secure File Transport (SFT) and the configuration options supported.

The following sections are provided:

2.1 Running Secure File Transport

To run SFT, enter the following command:

/opt/asrmanager/bin/sftransport start_listener

2.2 Configuring Secure File Transport and Components

The following configuration topics are presented:

2.2.1 Configure the HTTP Listener to Receive Files from Explorer

The HTTP Listener is a separate daemon process from the main transfer process that receives data. It can be setup and enabled during the SFT installation procedure. If the Listener is enabled, the Listener port can be verified or changed during the SFT installation.

You can send core files and other case-data files from Explorer to the SFT transfer directory using the HTTP Listener.

  1. In the /etc/opt/SUNWexplo/default/explorer configuration file, set the EXP_TRANSPORT variable to http://server:port.

  2. Run Explorer with the -p command line option.

  3. Configure then run Explorer with the -T http://server:port command line option.

You can also use the explorer -g option to specify the SFT transport server and port. The example below shows a sample output of this option.

Example: Using the 'explorer -g' Option

Automatic Submission
At the completion of Explorer, all output may be sent to Oracle or alternate
destinations.

Target: https://supportfiles.sun.com/curl
Send explorer output via HTTPS when -P is specified (y/n)?

Choose 'n' to specify an alternate target, such as your Secure File Transport
(SFT) listener
[]: n

When -P is specified, would you like Explorer output to be sent to an
alternate target destination, such as your Secure File Transport (SFT)
listener (y/n)?

If yes, then enter the http[s]://server:port
Otherwise, enter only a single '-' for your reply.
HTTPS destination or a '-'
[http://mysftransportlistener:88]:

2.2.2 Configure the HTTPS Listener to Receive Files from Explorer

The HTTPS Listener provides the same basic functionality as the HTTP listener, with added SSL encryption.

  1. In the /etc/opt/SUNWexplo/default/explorer configuration file, set the EXP_TRANSPORT variable to http://server:port.

  2. Run Explorer with the -p command line option.

  3. Configure then run Explorer with the -T http://server:port command line option.

  4. Generate the SSL certificate for the SFT host by following the SSL Certificate directions located at:

    http://www.eclipse.org/jetty/documentation/current/configuring-ssl.html
    
  5. Modify the /var/opt/asrmanager/sftransport/config/listener.xml configuration file to enable SSL as follows:

    1. The listener.xml file has a section for SslSocketConnector that is commented out by default; un-comment this section and add the appropriate port and key/password configuration.

    2. Ensure no conflict with port 443, the default port on the SFT host. If port 443 is already being used then change the Listener port to another acceptable value.

    3. Comment out the jetty.nio.SelectChannelConnector <Item> element, so that jetty.security.SslSocketConnector is the only active connector. For more information, see the Jetty documentation.

2.3 Using Command Line Options

The following sections describe command line options for modifying the SFT configuration and for managing the HTTP Listener:

2.3.1 Modify the Oracle Secure File Transport (SFT) Configuration

Table 2-1 describes the command line options you can use to change the SFT configuration (/opt/asrmanager/bin/sftransport):

Table 2-1 Oracle SFT (sftransport) Command Line Options

Option Description

enable

Enable Oracle Secure File Transport

disable

Disable Oracle Secure File Transport

start_listener

Start Oracle Secure File Transport listener

stop_listener

Stop Oracle Secure File Transport listener

show_listener_status

Show status of Oracle Secure File Transport listener

set_port

Set Oracle Secure File Transport listener port

set_directory

Set directory used for file transfer

show_config

Show configuration settings

info

Show current transfers

help

Display a list of commands

?

Display a list of commands


2.3.2 Manage the Oracle SFT Listener

Table shows commands and scripts you can use to manage the Oracle SFT Listener (/opt/asrmanager/bin/sftransport):

Table 2-2 Oracle SFT Listener Options

Option Description

start_listener

Start Oracle Secure File Transport listener

stop_listener

Stop Oracle Secure File Transport listener

show_listener_status

Show status of Oracle Secure File Transport listener