FSD Credits


Thanks to all the people who have helped me getting this server to what it is now. I couldn’t have done it without these people:

Greg Ament
John Eisenhour
Jason Grooms
Joe Jurecka
David Kings
Mladen Kmetic
Lyndon Nerenberg

And ofcourse:

All server operators
All people who sent me bug reports
All members of the SB/PC beta mailing list
All members of the FSFAN team Dordrecht
Marty Bochane

Compiling FSD in terminal mode


  1. Resume: After you have downloaded the fsd-ubuntu-120413.tar.bz2 file and you have saved this file in the folder ../Downloads, extracted it in the folder ../fsd-serverdatabase and subsequently copied the 3 folders ../doc ../fsd and ../unix to a folder called  fsd-server. Leave the contents in folder ../fsd-serverdatabase. These are the originals! OK? If you’ve lost me here, get back to this page.
  2. Now switch into terminal mode: Press Ctrl+ALT+t and the terminal screen will open.
    In the text hereafter the commands to type are place between [.  . ]. Type the commands only. Just to get acquainted with UNIX:fsd002
  3. You are: login_name@system. In this sample: fseindhoven@ubuntu:~$
  4. Type [ ls ] and ENTER: you get an overview of existing files in your Home directory
  5. Type [ ls -l ] and ENTER: you get the same view but listed A-Z
  6. Type [ ls -lt ] and ENTER: you get the same view but sorted by date
  7. OK. Now the real work: type [ ls ] and see that you have the folder fsd-server
  8. Type [ cd fsd-server ] and ENTER. Mind your typo’s ! UNIX is space and character case sensitive! The terminal answers with: fseindhoven@ubuntu:~/fsd-server$
  9. Type [ ls ] Check and see the folder fsd
  10. Type [ cd fsd ] and ENTER
    The terminal answers with: fseindhoven@ubuntu:~/fsd-server/fsd$
  11. fsd003
  12. Now type [ make clean ] and ENTER
  13. Now type [ make ] and ENTER
  14. Type [ cd .. ] and ENTER (One folder level up)
  15. Type [ cd unix ] and ENTER (Change dir to unix)
  16. Type [ ls -lta ] and ENTER and see what you’ve got
  17. fsd004
  18. Type [ ./fsd ] and ENTER
  19. Open the folder ../unix and you will see that after a while 3 new files are added.
    Double click log.txt and smile…your server is up and running :-))
  20. At first run there is no metar.txt file and the new metar information is collected in a file called newmetar.txt from the server that is set in the fsd.conf file.
    When finished you will have a file of approx. 1.7 MB.
  21. In the file: whazzup.txt you can read the status of your server.
  22. fsd005Checking the server  in a telnet session. Read in the next post. {Working on it}

METAR information in metar.txt


In the file metar.txt the downloaded metar information from the NOAA server is written. When the file is smaller then 1 MB the file is rejected and no new information is saved. A regular file size is approx. 1.5 MB +

In several circumstances the NOAA server won’t let you download the metar data. You may want to ftp yourself to 205.156.51.233

You can easily check the date/time of refreshment with Windows explorer or opening the log.txt file. If there is no refreshment, change the name of the server=weather.apollo3.com
You must have an IP address in hostname=

Some sample lines:

2013/06/25 08:45
K5SM 250845Z AUTO 00000KT 7SM CLR 10/M05 A3028 RMK AO2 TSNO

2013/06/25 08:45
K5SM 250845Z AUTO 00000KT 7SM CLR 10/M05 A3028 RMK AO2 TSNO

2013/06/25 09:35
KBBF 250935Z AUTO 20019KT 10SM FEW017 SCT022 BKN040 29/25 A2998 RMK A01

2013/06/25 09:35
KEMK 250935Z AUTO 16016KT 9SM CLR 28/24 A3003 RMK A01

2013/06/25 09:35
KBBF 250935Z AUTO 20019KT 10SM FEW017 SCT022 BKN040 29/25 A2998 RMK A01

Done. Get back here for Windows and here for Linux.

Logging the server activities: log.txt


In the file log.txt the activities of the FSD server are logged. See the sample below. You can deleted an existing log file. It will be replaced automatically when the server is started.

OK? Get back here.

12-01-2013 09:56:32 : Booting server
12-01-2013 09:56:32 FSD01: Reading certificates from ‘cert.txt’
12-01-2013 09:56:32 FSD01: Booting port 6809 (client interface)
12-01-2013 09:56:32 FSD01: Booting port 3011 (server interface)
12-01-2013 09:56:32 FSD01: Booting port 3010 (system management interface)
12-01-2013 09:56:33 FSD01: ** Connection to 111.111.111.111 port 3011 failed!
12-01-2013 09:56:33 FSD01: We are up
12-01-2013 09:56:34 FSD01: Reading certificates from ‘cert.txt’
12-01-2013 09:56:35 FSD01: METAR: Starting download of METAR data
12-01-2013 09:56:42 FSD01: METAR: Installed new METAR data.
12-01-2013 10:10:01 FSD01: METAR: Starting download of METAR data
12-01-2013 10:10:07 FSD01: METAR: Installed new METAR data.

FSD configuration file: fsd.conf


################################################################
# Sample configuration file for FSD
# Attention : WINDOWS-format : required CR in this file!
# Use Notepad++ or Notepad for changes.
################################################################

# The [system group] holds information about your server.
# The ports where clients and servers will connect to are:
# [system]
# clientport=6809
# serverport=3011
# The port where the system management services will be located
# systemport=3010

# ident=FSD01
# The ident of your server. This ident has to be unique. It is used to
# identify your server in the global network. It should not contain spaces.
# Please use a small ident code, it will be sent in every packet

# email=yourname@yourhost.com
# The email address that can be used to mail the maintainer of this server.

# name=FSD Windows server
# The name(description) of your server. It may contain spaces.

# hostname=localhost
# The hostname that can be used to reach this server.

# password=disable
# The password you need to specify before you can execute privileged
# commands on the system port.

# location=City Country
# The (physical) location of the server in the world, and the internet.
# Example: ‘Amsterdam, The netherlands’

# mode=normal
# The mode of the server; can be ‘normal’ or ‘silent’. Use ‘normal’
# for normal operation.

# certificates=cert.txt
# The file to read certificates from.

# maxclients=100
# The maximum amount of clients this server will allow.

# whazzup=whazzup.txt
# The file to put WhazzUp data in.

################################################################
# The [connections] group holds information about the (server) connections that the
# server will establish and accept.
#
# connectto=
# Contains the hostname and port numbers of the servers to connect to.
# Multiple servers can be used here. For example:
# connectto=server.flightsim.com:4006
# allowfrom=
# Contains the IP addresses from which servers can connect to this server.
# Multiple IP addresses can be used, separated by commas. For example:
# allowfrom=server.flightsim.com,atc.aol.com

################################################################
# The [hosts] group contains a list of hosts that are trusted for some activity.
# There are 2 entries:
# certificates= contains a list of server ID’s that are allowed to change
# weather=  contains a list of server ID’s that are allowed to change weather profiles

################################################################
# This group [weather] controls the weather system.
# The ‘source’ variable determines the source of the METAR data.
# For normal operation, set this to ‘network’.
# There are 3 possible values here:
# ‘file’ : Read the METAR data from the file ‘metar.txt’
# and allow weather requests from other servers.
# ‘download’ : Like ‘file’, but refresh metar.txt every hour by downloading
# the latest weather observations from metlab. The server has
# to be connected to the internet for this to work.
# ‘network’ : Relay weather requests to the closest METAR capable server.
#
# ‘server’,’dir’ and ‘ftpmode’ are only used when the METAR source is ‘download’. These
# fields determine the host name and the directory from where metar data is
# read. FSD uses the FTP protocol to get the data. ftpmode can have the value ‘active’
# ‘passive’ that are Active and Passive FTP protocol mode, default is ‘passive’.
# If you use FSD on a computer having a private IP, only use passive mode.

In fact this is all that remains after removing the text above. When done and understood, get back here for Windows and here for Linux.

[system]
clientport=6809
serverport=3011
systemport=3010
ident=FSD01
email=yourname@yourhost.com
name=FSD Windows server
hostname=localhost
password=disable
location=City Country
mode=normal
certificates=cert.txt
maxclients=200
whazzup=c:whazzup.txt
[connections]
#connectto=
#allowfrom=
[hosts]
#certificates=
weather=http://weather.noaa.gov/cgi-bin/mgetmetar.pl
[weather]
source=download
server=tgftp.nws.noaa.gov
dir=data/observations/metar/cycles/
ftpmode=passive

FSD Users and Passwords


This is the basic contents of the file cert.txt
This is the file where the certificates are read from. Create here your own user table.

If done, get back here for Windows and here for Linux.

; ID Password Rating
; 0 Account disabled
; 1 Observer
; 2 Student1
; 3 Student2
; 4 Student3
; 5 Controller1
; 6 Controller2
; 7 Controller3
; 8 Instructor1
; 9 Instructor2
; 10 Instructor3
; 11 Supervisor
; 12 Administrator
;
; <vid> <pwd> <adminrank>
; adminrank : from 0 to 12 (0 account disabled)
;
;111111 password 12
;222222 password 12
;333333 password 12
;444444 password 12
;555555 password 12
;666666 password 12
;888888 password 12
;999999 password 12

#####################################################
# Make your own user table as in the sample below.
# Don’t use the “;” .
# Keep it simple: 6 digits username [space] 6 digits password [space] rank
#####################################################

klm149 123456 12
klm188 234567 10

Linux FSD Server


Did you read the UBUNTU page? Did you install the GNU C++compiler, otherwise you never ever get the server to work! Ok, let’s start the installation of the FSD Server.

  1. Get the FSD archive: fsd-ubuntu-120413.tar.bz2 (file size 618.03 KB) from our
    cloud server FSD_Server  through double clicking the folder icon.
  2. Place this file in the Download folder (Home/Downloads)
  3. Let’s see what we got on board: double click the fsd-ubuntu-120413.tar.bz2 icon
  4. In the sub screen that opens, click on Extract, then again, select Extract.
  5. Now the files from the archive are extracted in a new folder in /Downloads named:
    fsd-ubuntu (or fsd-serverdatabase). This folder contains the (7 items ) following folders and files:
  6. In the /Home folder create a folder name: fsd-server (right mouse click)
    1. Out of the earlier folder (step 5) /Home/Downloads/fsd-ubuntu we will copy the folders /docs,  /fsd and/unix and Past Into Folder ../fsd-server.
      Hold down the CTRL key, select the folders and right mouse | Copy
    2. Now we have in ../fsd-server the folders /docs , /fsd and /unix
    3. Get into the ../unix folder and read the file names as there are:
      1. adminhelp.txt
      2. cert.txt (Look here for modifications)
      3. fsd (executable)
      4. fsd.conf (Look here for modifications)
      5. fsd.sh
      6. fsd_d.sh
      7. killfsd.sh
      8. motd.txt (Look here for modifications)
  7. Open the file fsd.conf [double click] and a program called “gedit” shows a sample configuration file for your FSD Server. Since we copied all from the original location, we cut the crap  we don’t need. But first: READ, READ, READ until you understand…
    1. Every line that starts with a “#” sign is just for information. So after reading, delete all the lines beginning with a “#”. When something goes wrong, don’t worry, just copy/paste the file again from the original location. OK?
  8. Now we are getting somewhere…this is all there is left: check the contents and close the file with Save.
    Done. Good job!
  9. Below is the stripped and adapted contents of the file fsd.conf
  10. After this first step we will go into a terminal mode to compile the files. Check this page.

[system]
clientport=6809
serverport=3011
systemport=3010
ident=FSD
email=yourname@yourprovider.com
name=FSD Unix server
hostname=localhost
password=disable
location=your city [space] country
mode=normal
certificates=cert.txt
maxclients=200
whazzup=whazzup.txt

[connections]
#connectto=
#allowfrom=

#[hosts]
#certificates=
#weather=

[weather]
source=download
#server=tgftp.nws.noaa.gov
#place # before server when not applied)
server=weather.apoll3.com
dir=data/observations/metar/cycles
ftpmode=passive

Note: the noaa.gov server does not permit anonymous access; use the weather.apollo3.com server in the [weather] section.

Resources used: www.apollo3.com

Ubuntu and the FSD Server


  • First of all we will install a Linux OS on a Windows machine
    • Go to http://www.ubuntu.com and download the 32 bits or 64 bits version.
    • You get 32 bits version like: ubuntu-12.04.2-desktop-i386.iso.
    • Decompress this file with WinRar.
    • In the root of the created folder double click wubi.exe to start the installation of Ubuntu with Linux 3.5.0-34
    • This will create a dual-boot on your machine which will take about 18 GB disk space.
    • Create a user name and password for Ubuntu. [Write it down !].
    • Depending on your CPU speed the Linux OS installation takes about 4 minutes or less to install.
  • Restart your PC and wait the Ubuntu screen…let it run and read the information screens during the system installation. You might want to scroll through these pages with the left/right arrows. The system installation is completed after approx. 15 minutes and the system will restart automatically.
  • Choose Ubuntu in the OS selection menu
    • In the opening screen you will be asked to enter your previous created password and in a few seconds you will see the Ubuntu Desktop.  Have a look around and discover the possibilities.
    • If there is any update information to collect, say “Yes” and proceed.
      Changes in the system must be authenticated with your password.
    • Set up an e-mail account…ready to go!
  • Ubuntu One: you’ve got 5 GB free storage from Ubuntu in your personal cloud.
    Select Ubuntu One from the task bar and install this application. A handsome place to store documents which you never want to loose…
  • Install Compiler: in order to be able to compile the files that we will download later on, you need to install the C++ Compiler.
    Select Ubuntu Software Center and type “g++”(without quotes) in the search field. The system will return with GNU C++compiler; click the line and install the software.
  • So far so good…now let’s install FSD. Let’s go to the next page.

[insert pic system settings]2016

FSD for Unix and Windows


FSD for Unix and Windows
————————

This distrib is made to make a single source for FSD on Unix and Windows

to compile fsd for unix :
move to fsd subfolder : cd fsd
make the project : make
the fsd will be generated in unix directory
clean the project : make clean

to compile fsd for windows :
launch Visual Studio 6 (or above) with fsd/fsd.dsw
the fsd Release will be generated in windows directory
clean the project removing generated Debug or Release folder
For Windows :
There is scripts to run interactivly FSD, install and run FSD as a service, uninstall the service

For Unix :
Look fsd.sh to install fsd as autostart at server boot
Launch ./fsd_d.sh to launch fsd as daemon process
Launch killfsd.sh to kill the daemon