Administrator's Guide 

WireLess Studio Service Server

1 Description
2 Starting
3 Shutdown
4 Administration
5 Configuring
  5.1 The WSServer.ini File
    5.1.1 Trace section
    5.1.2 Clients section
    5.1.3 IP section
    5.1.4 APP section
    5.1.5 Wizard section
    5.1.6 Window section
6 Log files


 

1 Description

The server accepts the connections from clients, launches and runs the PC applications.

This server (WSServerSvc) is a NT Service. It doesn't need a user logged on the PC and may be started automatically and managed from the "Services" control panel.

The PC that runs WSServerSvc must have the TCP/IP protocol loaded. See the Administrator's Guide / Network Configuration / Server.

To install only WSServerSvc on the PC, see the Administrator Guide / Installation CD / Service Server.

Host PC Server


 

2 Starting

The service will run automatically when the computer starts.
Through the WNT or W2000 Services Control Panel you may manage the startup mode (Manual / Automatic) and the start/stop of the service.
By default, the service is installed in Automatic mode.


 

3 Shutdown

To shutdown the server you should connect to the server with the Administrator, select "Server Administration" and the Server shutdown option. (See Administrator's Guide / WireLess Studio Administrator, Starting, Connecting, Server Administration and Server shutdown ).
You can also stop the service through the WNT or W2000 Services Control Panel.


 

4 Administration

The server has no user interface.
The server administration is made via the WireLess Studio Administrator through a TCP/IP connection, either from the same computer that runs the server or from another computer connected to the network.

The WireLess Studio Administrator (WSAdm) allows to manage :

The server launches the WireLess Studio Program Manager (WSPm) that uses the profile list created by the Server and the Administrator (see Program Administration).
The Program Manager allows the user to sign-in and select an application, then it launches the selected application.


 

5 Configuring

The WireLess Studio Server has a configuration file -"WSServer.ini"- that is created with the default parameters at the first start-up.
If you want to customize a parameter, start the server for the "dot-ini" file to be created. Then shut down the server, modify the parameter and restart again.

 

5.1 The WSServer.ini File

This file contains some sections that have the configuration options.
You may edit this file by the Windows Notepad utility.
This is the description of the configuration file for V4, which differs form the configuration file for V3.

 
5.1.1 Trace section

This section groups the options of the trace (or "log") files.

[TRACE]
Name of the section.

Days=3
The server will keep logs of its activity and of each session for the number of days specified in this field.

Dir=.
Log files will be saved in the folder specified on this field, in a subfolder for each day kept.
If left empty, Log files will be saved in the working directory. 
The default working directory is "X:\Program Files\WireLessStudio\WS_BinV4".

Name=WSServer
This is the root of the log file names.
There are different log files for each component of WireLess Studio Server.
Log files names will be [ROOT]+[SUFFIX] (Ex: WSServerLIS.log).

Server=SRV.log
This is the suffix for the main component's log file.

Adm=ADM.log
This is the suffix for the Administrator's log file.

Wiz=WIZ.log
This is the suffix for the Connection Wizard's log file.

Lis=LIS.log
This is the suffix for the Connection Listener component's log file.

Level=10
This will be the level of detail of the log files. This value may be dynamically modified by the administrator (see Trace Level).
Level 0 (zero) keeps the least information log. 
Level 10 logs main actions and fatal errors.
Level 50 logs warnings.
Level 99 keeps full trace of all events. This option should dramatically slow the server performance and generate large log files. Do not use this level in normal working mode.

UseIpToLog=No
This field indicates if the WireLess Studio Server will use the terminals' IP for log file names.
If Yes, sessions' log files will be named [ROOT]+[SESSION_ID] (Ex: WSServer00A012B4.log).
If No, sessions' log files will be named [ROOT]+_+[IP] (Ex: WSServer_10.10.10.1.log).

 
5.1.2 Clients section

This section contains the Clients' session configuration.

[CLIENTS]
Name of the section.

ShutdownTime=0000
The WireLess Studio Server will shutdown at the time specified in this field.
All currently running sessions will be shutdown as well.
The shutdown time must be specified in HHMM format. Ex: "2359" means 11:59 pm.
Use "0000" to disable automatic shutdown.

ArpStatic=No
The WireLess Studio Server will create a static entry in the ARP table for each client that connects if 'ArpStatic' is enabled.

SessionTimeout=0
This field specifies how many minutes of idle time is allowed for each session before enforcing its shutdown.
Use "0" to disable session timeout.

 
5.1.3 IP Section

This section contains the connection configuration.

[IP]
Name of the section.

Adress=0.0.0.0
This field specifies the WireLess Studio Server's IP address.
Use this field to select your IP address if you want WS Server not to use all available network interfaces.

Port=8191
The WireLess Studio Server will listen for connections on the port specified in this field.
If this default port is in conflict with other applications in the same PC (see Network Configuration / Addresses) modify this value to another IP port.

Tmout=10
This field specifies the connection's timeout in seconds. This timeout is used for simple transactions between server and client or between server and application.
Use "0" to disable connection timeout.

MaxPings=10
This field specifies the maximum number of dummy frames that the WireLess Studio Server will send to the clients to keep the connection alive. 
Dummy frames will be sent when the application is iddle. If this number is reached, the session will be closed because assuming an error in the application.
The application's timeout can be calculated by multiplying the connection timeout and the maximum number of pings allowed. Example: If Connection Timeout is 5 seconds and Maximum Pings is 10, the application is allowed 50 seconds of iddle time.

 
5.1.4 APP section

This section contains the default application's configuration.

[APP]
Name of the section.

ShortNames=No
This field specifies whether the applications will be launched using short names or not.

Name= WSPm.exe
This field specifies the full path to the default application.
The path can be absolute or relative to the WS Server's working directory.

Args=
This field specifies the arguments passed to the application in its command line. Empty by default.

 
5.1.5 Wizard section

This section contains the WireLess Studio Server Connection Wizard configuration options. The Wizard is used to perform multi-server Load Balancing features, see Network configuration 7.2 Balance client connections in a multi-server environment

[WIZARD]
Name of the section.

Enable=Yes
This field specifies whether the Connection Wizard will be enabled.

Id=(hostname)
This field specifies the name that the Connection Wizard will use to "publish" the WS Server on the network.

 
5.1.6 Window section

This section contains the WireLess Studio Desktop Server configuration.
NOT IMPLEMENTED.

[WINDOW]
Name of the section.

Visible=0
This field specifies whether the WS Desktop Server's main window will be visible.


 

6 Log files

There are three categories of log files:

You may see this files with the Windows Notepad utility.
You may manage the amount of logged information by modifying the "Trace Level" (see Trace Section, Level).
You may change the default name of log files (see Trace Section, Name, Adm and Server).
The default destination folder of those files may be changed (the folder of the server exe file). See Trace Section, Dir.
The folders are created in a daily basis. Each folder name contains the date. You may change the root of the name (see Trace Section, Dir).
Old folders will be automatically deleted. You may modify the number of folders that will be stored by the server (see Trace Section, Days).