Errors Connecting to the Server

Server error: Not authorized: USER@ADDRESS (ID=EMAIL) --> REMOTE_USER

Either:

• There is no account REMOTE_USER on server ADDRESS
• Account REMOTE_USER on server ADDRESS has not been initialized for WANFast use and does not have an authorized_keys file.
• Your public key was not found in the authorized_keys file in the REMOTE_USER account on server ADDRESS.

ERROR: wfst client: negotiatePhase3: RSA_private_decrypt

The wrong public key was found for your ID in the authorized_keys file on the target machine.  Have you changed your private key?  Is there another user with the same (supposedly) unique ID?

You have insecure file permissions on the file /root/.wfst/wfst.key.

Your private key file is readable by other users.  This is very insecure.  At a minimum you should reset the file permissions so that it is only readable by you.  You should also consider replacing it with a new key that has not been exposed to other users.  If you replace your current private key, be sure to also replace your public key in the authorized_keys files in any accounts to which you have access.

Server error: You have insecure file permissions on the file /root/.wfst/authorized_keys.

The authorized_keys file in the account on the server that you are trying to log into is readable by users other than the account owner.  This is very secure. You, or the account holder on the server, should reset the file permissions so that it is only readable by the account holder.  You should also verify that only public keys belonging to appropriately authorized users are present in the file.

ERROR: wfst client: bind() -- 98, Address already in use

The WANFast tunnel daemon was unable to bind to the specified tunnel port.  This message will be found in the WANFast log file.  It will occur if you already have a previous tunnel daemon running. 

Invalid License Type.

If you receive the following error after installing a master license key on a machine, the message indicates that the master license is invalid.  Most likely this means that:

• The master license has expired.  You can verify the expiration date by using a text editor to examine the expiration_date field within the license file.
• The master license has already been used to activate its maximum number of machines.  Log into your WANFast account.   Under the Your Account menu access the View Current Licenses page to view your licenses.  Each you see which machines have been activated by a license by clicking on the ID link for the license.

Exit Codes

The exit code returned upon completion of a WANFast program is the result of all errors that were encountered during the program's operation.  The low order 4 bits of the exit status provide the termination status -- i.e., the reason why the program terminated. 

Termination Code = Exit Value & 0x0F

The high order 4 bits indicate non-fatal errors that may have occurred during the operation.  Thus an exit status of 0x10 indicates successful completion of the operation, but with an error on one or more files, while an exit status of 0x9C indicates that at least one fail failed to transfer because the target disk ran out of space.  The specific error encountered for each file will be printed to the program's standard output.

The full list of WANFast exit codes is shown in the table below. 

Complete List of Error Codes

In adition to returning and exit code, WANFast programs will print an error message to standard output whenever they encounter an error.  Each error message will include a WANFast error code as well as a string description.  These are shown in the table below.  Each error encountered will also result in a non-zero exit code.  The exit code associated with each WANFast error is also listed in the table below.  Not all errors result in the termination of the WANFast application -- particularly when copying or syncing files.  The exit status returned upon completion of the program is the result of all errors that were encountered during the program's operation as described in the previous section.