Instruction manual Wav WaveGuide Server
Appendix 2:
Properties file “wgs.properties”
The WGS.properties file is used in the startup procedure to configure the system. Below a wgs.properties file is
printed. To modify the configuration this file should be edited.
There are two ways to edit the file :
1. Copy the file to your own computer. Edit it and copy it back to the WaveGuide Server. Copy can be done
via ftp or via a ssh connection. To edit the file use a editor and not a word processor as the latter adds all
kind of extra characters to the text.
2. Edit the file on the system itself. Make a ssh connection and use the editor program “
nano
” to edit the file
at the WaveGuide Server. A ssh connection can be established from a Linux console. From a windows
computer this can be done with the freeware program “
putty”
. Beside a ssh connection also a telnet
session will work.
Use the ip address given in the display of the WaveGuide Server (with push button 2 you go to the group network
info and then with button1 you scroll between ip address and hostname).
When you start a ssh connection it takes a few seconds to obtain the request for login name and password (default
these are both
radac
).
First have a look in the /config directory.
ls /config
this gives a listing of the files in this directory. Two files are always there wgs.properties and wgs.properties.bak.
Sometimes also a file wgs.properties.error is present. This error file is created when the system could not start
with wgs.properties file because it is corrupt. In that case the system copies the corrupt wgs.properties file to
wgs.properties.error and copies also a wgs.default file to wgs.properties. This is done to start the system anyway.
to start the program “
nano”
type :
nano /config/wgs.properties
To go through the text use the arrow keys. The use of the editor is explained in the lower part of the screen. To
save the edited version use as indicated
Ctr O
plus
enter
to confirm. To exit
nano
type
Ctr X
. To restart the
system the best is to switch the WaveGuide Server off and on again.
If something goes wrong and the system does not start as expected it might be the best to replace the
wgs.properties by its back up version. You can do this in a ssh session by typing:
cp /config/wgs.properties.bak /config/wgs.properties
To remove the wgs.properties.error file type :
rm /config/wgs.properties.error
Version 4.1
24 of 30
Oct 2013
Warning:
Editing the wgs.properties file is risky. The system can stop working.
Editing should be done by a skilled person. In case the file is damaged one back
up file is present at the system to bring the system back to its defaults.