Using FTP Services

You can manage several aspects of the ICS appliance using ICS FTP services. Using an FTP client connected to a network where the ICS appliance is visible, you can get and put configuration files, log files, and the optional splash screen (which you can customize with your own HTML).

Starting an FTP Session with the Appliance

1. Launch your FTP application and enter a valid appliance IP address.

   For example:

   ftp 10.1.1.1

2. Log in to the appliance.

   The username is config and the password is either null (press Enter) or one space (press Spacebar and then Enter).

Managing Configuration Files with FTP

All ICS settings are contained in configuration text files with the extension .NAS. These files can be edited and sent through FTP back to the ICS appliance where they can be executed as a means of instant configuration.

By using several configuration files, you can apply different scenarios instantly, such as turning various proxy services on or off. ICS updates the default file CURRENT.NAS every time you apply a setting. Additionally, if you have created a file named AUTOLOAD.NAS on a floppy disk, it is updated with each change. From the browser-based management tool or the Telnet / command line interface, you can export other configuration files.

Downloading a Configuration File to Your Workstation Using FTP

1. Start FTP and log in as explained in Starting an FTP Session with the Appliance.

2. Enter the following:

   get filename.nas

   where filename is the name of your configuration file.

   The file is transferred to your FTP clients default directory.

Moving a Configuration File to the ICS Appliance from a Workstation

1. Start FTP and log in as explained in Starting an FTP Session with the Appliance.

2. Enter the following:

   put filename.nas

   where filename is the name of your configuration file.

   The file is transferred to the ICS appliance.

Moving a Configuration File to the ICS Appliance and Executing It

1. Start FTP and log in as explained in Starting an FTP Session with the Appliance.

2. Enter the following:

   put filesrc.nas filedst.nas, execute

   where FILESCR.NAS is the name of the source configuration file and FILEDST.NAS is the name used at the destination.

Downloading Log Files

You can use FTP to transfer log files for the various proxy services to your workstation. For example, to download a forward proxy log file, do the following:

1. Start FTP and log in as explained in Starting an FTP Session with the Appliance.

2. Enter the following:

   get log:/etc/proxy/data/logs/forward/common/99042-a.log

   The named log file is transferred to your local workstation FTP directory.

3. Open the file in your common log file processor (or in any text editor or viewer).

For more information about where log files are located, see Using ICS Logging Services.

Modifying the ICS Splash Screen

ICS has an optional splash screen that displays periodically before pages are vended. To alter the appearance of the splash screen, do the following:

1. Start FTP and log in as explained in Starting an FTP Session with the Appliance.

2. Do one of the following:

   • If the splash screen is turned on, enter

     get \etc\proxy\data\bmsplash.htm

   • If the splash screen is turned off, enter

     get \etc\proxy\data\ bmsplash.off

3. Modify the file.

4. Do one of the following:

   • If the splash screen is turned on, enter

     put bmsplash.htm \etc\proxy\data\bmsplash.htm

   • If the splash screen is turned off, enter

     put bmsplash.off \etc\proxy\data\bmsplash.off