GoodTech FTP Server for Windows 95/98 V3.0


Installing GoodTech Ftp Server

Configuring the GoodTech Ftp Server

Administrating the GoodTech Ftp Server

Working with GoodTech Ftp Server

Trouble Shooting


Screen Shots

Screen Shot 1– Windows 95/98 System Properties, Setting Environment Variables

Screen Shot 2– The Command "ftpd status"

Screen Shot 3– The ftpd Log File

Screen Shot 4- Absolute FTP

Screen Shot 5- MS FTP client

Screen Shot 6- Using FTP in Netscape




This help document gives you an introduction to ftp and to our Ftp Server, describes how to install, set up and use the ftp server, and has a trouble shooting chapter to help you overcome problems. We hope you will find it helpful.

Although we did our best to proofread this help, we are unfortunately not immune to mistakes and omissions. If you find any mistake or have suggestions to improve this help, please let us know.


Introduction to Ftp

Ftp (File Transfer Protocol) is a set of commands of how comupters might share files over the Internet/inranet. Due to the design of the protocol, different machines, using different operating systems and different hardware, can exchange files efficiantly in a safe manner. The FTP protocol require two programs, a server program, and a client program. Normally the server program offer files to the client program. But in some cases, the server will also allow the client to upload files.

Ftp server is a server application that runs on a host computer and allows remote users to transfer files between the clinet and the host machine.

Ftp client is a client application that allows a user to communicate with the ftp server and transfer/receive files over the network.


Introduction to GoodTech Ftp Server

GoodTech Ftp Server for Windows 95/98 is an ftp server application that runs on a host computer and allows remote users to Ftp in to the host. Microsoft Windows 95/98 networking has a built-in Ftp client, but does not have a built-in Ftp server, so Goodtech Ftp Server can be used to provide the missing build-in Ftp Server functionality.

When Goodtech Ftp Server is installed on your Windows 95/98 system, you can Ftp from remote systems and exchange files to/from your Windows 95/98 system. It is a functional, easy to use and high performance tool, that is written based on open standards (RFC 959), can communicate with any standard ftp client and is highly integrated with Windows 95/98 operating system.

By using an Ftp client, you can connect to GoodTech Ftp Server from anywhere in the world and send/receive files to/from the Windows 95/98 system. Whether you are a system administrator, a programmer or a DOS application user, GoodTech ftp server can provide you with the Ftp Server functionality that you need.


How the GoodTech Ftp Server Works

The installation program creates a ftp service called ftpd and adds it to the list of services available on your 95/98 system.

When the Ftp Server service is started, it executes a program named ftpdstart.exe.

The program ftpdstart.exe opens a log file ftpd.log in the Ftp server installation directory.

Ftpdstart.exe is now ready for connection requests. It listens to requests on the default ftp port (#21) or on other port if a different port was specified when the ftp service was started.

When a user wants to connect to the host running GoodTech ftp server, he runs an ftp client program. The ftp client program sends a connection request to port #21 (or to any other port the ftp server was configured to listen).

The ftpdstart.exe program gets the request and opens a thread, which is responsible for this connection with the client. This thread relieves ftpdstart.exe from communicating with the client and let ftpdstart.exe focus on listening to other connection requests.

The client thread starts the authentication process. It asks the ftp client for login information. The login information consists of a User ID and Password. The client thread then uses the file PASSWD.DAT to check if the user is allowed to the host. If the user passes authentication, he is logged onto the host system, and is now ready to work on the host. The user privileges (the commands allowed for this user) are taken from the file GT_PERMISSIONS.DAT.


GoodTech Ftp Server Key Features



Registration is very simple - you are automatically registered when you order from GoodTech Systems. When we receive your order, we will send you back your registration number along with your registered copy of the product. Our simple licensing policy lets you purchase as many copies as you need and get a single license for all copies.


Installing GoodTech Ftp Server

System Requirements

GoodTech Ftp Server requires Windows 95/98.

The TCP/IP protocol must be installed on your Windows 95/98 system. This protocol is included with the Windows 95/98 operating system but is not always installed on all systems. You can check if TCP/IP is installed on your system by choosing Network from the Control Panel. If TCP/IP is installed on your system it should show up in the list of Installed Network Software.


Running the Installation Program

After downloading the evaluation copy of the GoodTech Ftp Server or receiving the registered copy, you have to perform the following steps:

  1. Unzip the Ftpd zip file to your installation directory. (The installation directory should be created on any of your local drives. Installation on a network drive is not supported)

    After extracting the zipped file you will see the following files in your Ftp Server installation directory:

  • README.htm - Make sure you read this file before proceeding with the installation process.
  • Help95983.0.htm - An HTML help file.
  • Install.exe - The GoodTech Ftp Server installation program.
  • Uninstall.exe - The GoodTech Ftp Server uninstall program.
  • Ftpdstart.exe - This program is executed by the Ftp Server service after it is started.
  • Ftpdstop.exe - This program stops the GoodTech Ftp server
  • Gt_pass.exe - The password utility
  • Gif/Jpg files
  • gt_permissions_dat.sample
  1. Run install.exe to install GoodTech Ftp server.

    The installation creates a new service with the internal name ftpd. If a service with a name ftpd is already in use in your system, you have to uninstall the existing service before you install GoodTech Ftp server.

      Note: The FTP server service starts automatically every time you reboot your machine.


Upgrading to a New Version

If you want to install a new version of the Ftp Server but have a previous version currently on your system, you have to do the following:

  1. Stop the GoodTech Ftp Server Service. Please refer to "stopping the GoodTech Ftp Server" for information on how to stop the service.
  2. Uninstall your current version of GoodTech Ftp server. Please refer to "Running the Uninstall Program".
  3. Follow the installation steps for the new version.


Running the Uninstall Program

If you want to uninstall the GoodTech Ftp Server from your system, all you have to do is:

  1. Make sure the ftpd service is not running by executing the program ftpdstop.exe
  2. Run uninstall.exe to uninstall your current version of GoodTech Ftp server.


Configuring the GoodTech Ftp Server

Creating and Configuring Accounts

Using gt_pass utility

When a Ftp user logs into your system via GoodTech Ftp Server, he must be a valid user that was created by the gt_pass.exe utility program. All users created with this utility are kept in the passwd.dat file.


Working with gt_permissions.dat

The gt_permissions.dat file is used to define the permissions for each user created in the passwd.dat file (A sample file is included with the product) . Valid permissions are:

N - No access

R - Gives a read permission to the loggoed in user. Write/delete commands are denied.

U - Gives read/write/delete permissions to the loggoed in user. Administration comands are denied.

C - Full control. Any command is accepted.

A record in this file should look like this: username:X were X is N,R,U or C.

For exaple the gt_permissions.dat file contains the following:


Ftpd user (the FTP server administration account) has full control.
Mark has read/write/delete permissions on all directories/files.
Steve has only read permission.
Greg has NO access.

Please note that any user that not listed with a specific permission in this file will get the READ/WRITE access as the default permission. 


Using the Anonymous account

The GoodTech FTP server, supports the Anonymous account. It uses the guest account found in your passwd.dat file when a user logs in as an 'Anonymous' user. If you want to enable the Anonymous account, you should define gt_ftpd_anonymous_allowed to 'y' in your autoexec.bat file ('set gt_ftpd_anonymous_allowed=y'), create the guest account in your password file and set this account without a password. When a user try to log in as 'Anonymous', a message for this specific account is displayed on the FTP client application saying if this user is allowed to the system. A user should put his email address as the password for this special account.


User Home Directory

If a user's home directory variable is specified in the autoexec.bat file (set gt_ftpd_XXXX_home=YYYY Were XXXX is the username and YYYY is the full path for the user home directory), GoodTech Ftp Server changes to that home directory when the user logs in.

If the user home directory variable is not specified in the autoexec.bat file, the variable gt_ftpd_user_home is used by GoodTech Ftp Server. Please refer to "Setting Environment Variables in Windows 95/98" for information on how to set a variable.

If no home directory is specified (gt_ftpd_user_home variable is not defined), the C:\ is assumed as the home directory.


Creating the Ftp Administrator Account – ftpd

ftpd is the ftp administrator account. Administration commands can be performed only from the ftpd account. You have to create an account for the user ftpd (in lower case!), using the password utility (gt_pass.exe).


Controling the number of users connected at the same time

You can limit the number of concurrent connections (users) that can access and use GoodTech FTP server. By creating an environment variable named gt_ftpd_max_users and set it to a nuber less or equal to the number of your registered product.

Setting up parameters to GoodTech Ftp Service

Ftp Port

The default ftp port is port number 21. However, in case port 21 is used by another application, you can set up the GoodTech Ftp Server to use a different port. If you start your Ftp Server manually, you specify the port number as a parameter to the ftpdstart.exe program. You issue the command:

ftpdstart 25

If you start your Ftp Server automatically, you have to change the port number in the registry. To update the registry:

Run the program regedit.exe and goto HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\RunServices

Double click the FTPD key and change the port number value from 21 to a different port number.

The Ftp client program must be set up to use the same port as the Ftp Server. If you set up the Ftp Server to use a port different than the default (#21), you have to also set up the ftp client to use the same port.


Login and Session Timeout

Two environment variables are used to control idle sessions:

    gt_ftpd_login_idle_time - specifies the time period, in seconds, allowed for the login process before it is automatically disconnected from the host.

    For example, if you set gt_login_idle_time to 30 seconds and a user doesn’t provide login input in the timeout period (30 seconds), the session is closed by the Ftp Server. In case a session is disconnected, the message "Timeout period expired" is displayed on the user's ftp window.

    If this variable is not defined, or if it has a value of 0, there is no time limit for the login process.

    gt_ftpd_session_idle_time – specifies the time period, in minutes, allowed for a session to be idle before it is automatically disconnected from the ftp server. In case a session is disconnected, the message "Timeout period expired" is displayed on the user’s ftp window.

    If this variable is not defined, or if it has a value of 0, there is no time limit for a session to be idle.

It is recommended to set these parameters so that system resources will not be allocated to idle sessions. For instructions on how to set environment variables in Windows 95/98 please refer to the "Setup Environment Variables in Windows 95/98" section.


Setup Environment Variables in Windows 95/98

Run sysedit and select AUTOEXEC.BAT file. Add the environment variable at the end of this file.

For example, to define gt_ftpd_user_home, write the following line:

set gt_ftpd_user_home=c:\home (no spaces before or after the "=" sign).

You have to reboot your computer after setting up environment variables for the change to take effect.

The screenshot below shows as an example how to define the gt_ftpd_login_idle_time variable and set its value to 30 seconds.


Administrating GoodTech Ftp Server

Administrating Commands

Administration commands can be performed only from the ftpd account. You have to ftp to the host as user 'ftpd', either locally, from the host itself, or remotely, from a client.

More than one ftpd user can ftp in to the host at the same time. However, each is count against the maximum number of concurrent connections allowed. You want to make sure that you always keep at least one ftpd user session open, so administration commands will be available even when all concurrent connections are in use.

The following commands are currently available:

Service Administrating Commands:

    Clients Administrating Commands: (When using MS FTP client)

    • quote ftpd_status – Displays a list of all current opened sessions.
    • quote ftpd_kill [sid]- Kills the client session identified by sid. To get the client sid, use the command "quote ftpd status".
    • quote ftpd_user_history [sid]- Shows last commands entered by client session identified by sid. To get the client sid, use the command "quote ftpd status".


    Controlling the GoodTech Ftp Server Service

    Starting the GoodTech Ftp Server Service

    • Run ftpdstart.exe program from a Dos session

    Stopping the GoodTech Ftp Server Service

    • Run ftpdstop.exe program from a Dos session


    Administrative Messages from the Ftp Server



    Is displayed when..

    Evaluation copy of GoodTech Ftp Server version X has expired

    Your 30 day evaluation period is over

    Shutting down ftp server …

    You performed the command "net stop ftpd"

    Missing or invalid parameter

    You performed the command "ftpd kill [sid]" without specifying the [sid] or specifying an invalid [sid].

    User's session [sid] was terminated

    You performed the command "ftpd kill [sid]"



    The Log File

    What is the Log File

    The GoodTech Ftp service uses one Log file, ftpd.log, to keep a record of everything it does. The log file is kept in the GoodTech Ftp Server installation directory.

    Here is an example of the ftpd log file content:

    For more information on how to monitor your Log file please see the "Monitoring the Log File".


    Resetting the Log File

    Your log file can grow quite large and quite fast, especially if your host is getting a large number of ftp users per day. The size of the file can eat into your disk quota and tie up needed space.

    To reset your log file, simply delete the file when the ftp server service is not running. Make sure that you don't try to delete your log file when they are actually being written to by the Ftp Server. The next time the ftp server will run, new log file will be created.


    Working with GoodTech Ftp Server

    Choosing Your Ftp Client software

    GoodTech Telent Server is written in open standards (RFC 959) and can work with any standard ftp client. There are quite a few ftp clients available, many of which are free.

    However, AbsoluteFTP from Van Dyke Technologies is our preferred ftp client because it is flexible and friendly and it is less likely to run into problems because GoodTech Ftp Server is thoroughly tested with AbsoluteFTP.

    The Windows 95,98/NT operating systems are shipped with an ftp client included (found at "c:\windows\ftp.exe" and "c:\winnt\system32\ftp.exe" respectively). This ftp client is simple and functional, but not quite as flexible and friendly as AbsoluteFTP from Van Dyke Technologies, Inc. or any browser like Netscape and MS Internet Explorer.

    Screen Shot 4- Absolute FTP

    Screen Shot 5- MS FTP client

    Screen Shot 6- Using FTP in Netscape


    Working with the Ftp Client

    Connecting to GoodTech Ftp Server

    Once you have chosen an Ftp client, connecting to the GoodTech Ftp Server is simple. Although ftp clients vary in their exact configuration, most of them will simply require you to specify a "remote host". Your remote host is the host where the Ftp Server is running.

    Once you are connected, you will be prompted for your login name and login password.

    The login name is the name of the user account to log on to.

    The password specifies the password for the user account.

    If you don't fill out the login information within the time period that was specified by the system administrator for login input, your session is disconnected from the host and the message: "Timeout period expired " is displayed on your screen. 

    After the login process is successful, you will have gained access to the host Server and can now issue commands at the FTP command prompt.  


    Idle Session

    If your session is connected to the Ftp Server, but is idle (no input is sent from the client to the server within the time period that was specified by the system administrator), it is disconnected from the host and the message: "Timeout period expired " is displayed on your screen.

    Exiting From a Session

    Once your ftp connection is established, your Ftp client remains connected to GoodTech Ftp Server until one of the following happens:

    You request to disconnect by:

    • Typing 'quit' at the command prompt.
    • Typing 'bye' at the command prompt.
    • Choosing Disconnect from the ftp client menu.

    The ftp administrator disconnects you by:

    • Killing your session
    • Automatic timeout disconnection
    • Shutting down the Ftp Server

    Abnormal termination:

    • The ftp client program terminates abnormally
    • A broken network link


    Messages from the Ftp Server


    The message:

    Is displayed when..

    All connections are in use

    All the licensed connections are concurrently in use

    Login incorrect, please try again

    You type invalid user name or password

    Not authorized for this command

    You try to execute an administrative command (only 'ftpd' user can execute these commands)

    Timeout period expired

    Either you didn't type in login information within the specified time period or your session was idle



    Trouble Shooting

    Handling Problems

    It is not uncommon to encounter a problem while using the GoodTech Ftp Server, especially if these are your first steps with the ftp server.

    The best place to look for answers to questions/problems is this help. You can also try the frequently asked questions list. If your question/problem was not answered/solved, you can try monitoring the log file. If you don't even get to the point that your ftp server is up and running and the log file does not exist yet, try our error messages list. If your error is listed on that list, you'll find the corresponding recommended course of action. And of course, as your last resort, you can always contact our technical support experts. Don't hesitate to contact us, your questions are welcomed. If you contact our technical support, please make sure you provide the following information:

    • Product Name
    • Version
    • What ftp client you are using
    • Problem/question description
    • Error message or error number (if applicable)
    • Ftp server log file (if applicable, attach the file to your email)


    Monitoring the Log File

    The GoodTech Ftp service uses Log file to keep a record of everything it does. Most of the entries you'll find in the log files are informational or success messages. However, error messages are also written to the log file, and these are what you are looking for, when you are facing a problem.

    Whenever an error occurs, the ftp server writes the error number into the log file. You can get the error number by searching the string "error no" in your log file. In case this string is found more than once, the first error message is the error you want to solve. In most cases, other errors are a result of the first one.