Administrator's Guide 

WireLess Studio Administrator

1 Description
2 Starting
3 Connecting
4 Administrator control panel
5 Network Topology
    5.1 Main Window
    5.2 Log Viewer
6 Program Administration
   6.1 Profiles and Applications
   6.2 Program Administration control panel
   6.3 Add and delete profiles
   6.4 Add and delete applications
7 Server Administration
   7.1 Server administration control panel
   7.2 Server shutdown
   7.3 New connections
   7.4 Trace Level
   7.5 License
   7.6 Server Connection Wizard
   7.7 Client Configuration


 

1 Description

The WireLess Studio Administrator (WSAdm), allows to manage:
  • client network connections
  • profiles and application programs
  • the server

WSAdm can run on the same computer as the server (that runs the WireLess Studio Server "WSServer") or on another computer connected to the same network as WSServer.

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

To install just WSAdm on a PC, see the Administrator Guide / Installation from WebSite / Administrator.


 

2 Starting

To launch the program, click on the desktop WSAdm icon
Or launch it from "Start / Programs / WireLess Studio / WireLess Studio Administrator"

 

3 Connecting

You must connect to one server to access the administrator tasks.
Click on the "Connection to Server" button.
Select the server from the list or input the name of a new server (or an IP address).

You can modify the WSServer administration host port (2002 by default).
Then click on "Connect".

If the IP address or port are not correct, change the configuration.


 

4 Administrator control panel

While connected to a server, you are able to manage:
  • Client network connections
  • Profiles and applications
  • The server

To close the current connection click on "Disconnect From Server".


 

5 Network Topology

 

5.1 Main Window

The list shows the clients connected to the server, ranged by IP address and connection port.
The icon indicates if it's a Windows or DOS client.
Select a client from the list to see more details.
The screen is refreshed every 5 seconds by default.

WS Client frame
Details of the TCP/IP connection.

WS Server frame
State of the server that maintains the two connections. The connection number (No) allows to find the log file of this process.

User Application frame
Details of the connection with user application.

Actions Frame
In order to shutdown a connection, click on "shutdown" button. The server demands the client and the application to terminate the connection.
If the application doesn't shutdown, click on "Close" button, which sends a Windows shutdown signal to the application.
If the application doesn't shutdown either, click on "Kill" button, which performs a Windows shutdown.

Refresh Frame
Allows to manage refresh view mode and time. Automatic or Manual mode (clicking on "Refresh" button).

Log Frame
Allows to display (View) or hide (Stop) the Log viewer window (data sent by user application) for the selected client.

 

5.2 Log Viewer

The Log Viewer window shows the data sent by the user application of the client selected on the list.
Click on "Stop" button (on the Network Topology window) to close this window.

This dialog box allows to confirm or cancel the shutdown task action.


 

6 Program Administration

 

6.1 Profiles and Applications

A profile identifies a user or a group of users. Each profile has an associated password.
The profile groups one or more WireLess Studio applications.
Each application has a title (displayed to the user) and an executable path.

The user is asked for the profile and password at sign-in. Then, the list of available applications for this profile is displayed so the user is able to choose among them for execution.

Profiles and applications are managed by the WireLess Studio Program Manager (WSPm), which is the default executable file launched by the server. You can bypass the sign-in process replacing the program manager with your own WireLess Studio application.

 

6.2 Program Administration control panel

The Program Manager (WSPm) has some default profiles and sample applications.

If you select a profile from "Profiles" frame, "Applications" frame displays the associated programs. "Application" frame displays details of the application selected on the application list.

Profile Input Frame
Allows to modify the profile name and password input mode on the Program Manager.
Choice by Menu check box: If not activated, the profile must be typed by the user. When activated, the user can select the profile from a menu.
No Password check box: If not activated, the password is requested to the user. If activated, the password is not requested.

Look at Help User Manual 

 

6.3 Add and delete profiles

Add a profile
Click on the "New" button on "Profiles" frame of WSPm.
Input the new profile name and password (by default the same), then click on "Add" button.

Delete a profile
Select a profile from the profile list of WSPm.
Click on "Delete" button on "Profiles" frame.
Confirm with "Yes" button on "Delete Profile" message box.

 

6.4 Add and delete applications

Add an application
Select the profile to manage on the profile list of WSPm.
Click on "New" button on "Applications" frame.
Input the title of the new application (displayed to the user in the initial menu).
Input the full application path (path and file name) or browse clicking on "...".
Input (if any) the application arguments (passed in the command line).
Order applications
You can modify the order in which the applications are displayed to the user on the start menu.
Select the profile to manage on the profiles list of WSPm.
Click on "Order" button on "Applications" frame.
Drag and drop the applications to put them in the new order.
Click on "Save" button to validate the modifications, or on "cancel" button to return without modifications.

Delete applications
Select the profile to manage on the profiles list of WSPm.
Select the application you want to delete from the applications list.
Click on "Delete" button on "Application" frame.
Confirm pressing on "Yes" button on "Delete Application" message box.


 

7 Server Administration

The server administrator allows to modify the server behavior and the server license.

 

7.1 Server administration control panel

Possible actions:
  • Server shutdown
  • Lock/Enable new connections
  • Set the trace level
  • Input the server license
  • Manage the Server Connection Wizard
  • Modify the Client Connection Settings

 

7.2 Server shutdown

To stop the server process, select "Server shutdown" button, then click on "Select" button.

Confirm (using GO button) or cancel the action on this dialog box.
The connection with the server is lost after shutdown.

The shutdown process should take some time if there are any active connections.

 

7.3 New connections

You can forbid any new connection to the server by selecting "Lock New Connections" option. Otherwise, to enable new connections (by default) select "Enable New Connections" option. Then, in both cases, click on "Select" button and confirm or cancel the transaction.

 

7.4 Trace Level

You can manage the amount of information sent to the log files with the trace options.
Select the desired option, then click on "Select" button. Confirm or cancel the transaction.

 

7.5 License

When installed, WireLess Studio starts in demo mode for evaluation purposes.

To activate all WireLess Studio's features you need to have a license number. Press on "New" button for the license request screen to appear. Type your Registration Code on "Registration Code" field. The Registration Code is a number you are furnished with when purchasing the product.

There are two registration modes: on-line or by e-mail. 
On-line registration: After typing your Registration Code press on "Request License On-Line". If you get an "Activation Key", your license has been activated.

if you enter an invalid code, an error message will appear, indicating that there was a mistake on the license request process.

E-mail registration: After typing your Registration Code, press on "Request License by eMail". A form containing all the necessary data for the license request will appear. DO NOT MODIFY THIS FORM.
Press on "Open Mail" to send the form to license@softogo.com.
"Print this Page" button allows to print the information. 
You will receive an Activation Key. Type it on "Activation Key" field and press on "OK" to validate your new license. 

 

 

7.6 Server Connection Wizard

The Server Connection Wizard allows the clients to find the WireLess Studio Servers across the network, without knowing their IP addresses. (See Network Configuration / Server Connection Wizard).

To enable this task, select "Enable task" check box.

The Connection Wizard ID is the identifier that allows to differentiate or group the servers by the Client. The value "(hostname)" sends the host computer name to the client. Otherwise the ID shown here is sent.

The client will search for an ID or "all IDs" ("?").

  • If only one server is found, the Client connects automatically to it.
  • If some servers with different identifiers are found, a menu containing the different servers is displayed to the user.
  • If some servers with the same identifier are found, the Client connects automatically to the server that has less connections running (connection balance).

The Wizard is used to perform multi-server Load Balancing features, see Network configuration 7.2 Balance client connections in a multi-server environment

 

7.7 Client configuration

This dialog box allows to configure some client connection parameters.

Startup application (PM) (Program Manager) frame allows to manage the application menu, profiles and passwords. You can replace this startup application with another.

Inactivity time-out frame allows to automatically disconnect the client if no RF transaction is detected on this time lapse (in minutes). 0 means "no time-out".

Daily Auto Shutdown Time allows to indicate the time of the day when WireLess Studio is shutdown and all terminals are disconnected.

Short File Names check box allows to configure the file naming mode used by WireLess Studio, long or short (8.3) form.

Use IP to Log enables to configure the log file name. The name of the file that keeps the registry of client activity will contain the client IP. For example, a terminal having 10.10.10.1 as IP address will have a log file named "wst_10_10_10_1.log".

WARNING: Do not use this method if you have several WSt clients on the same PC, because they have the same IP address.