Configuring the Environment

To setup TS Network DataServer software you must configure network communications and server access for the client.

All firewall software must be modified to allow Thoroughbred to communicate between the client and the server. Create a Firewall Inbound rule for the TS DataServer. Allow inbound TCP on port 5680. By default, the DataServer service (TbredServerMgr) will use port 5680. It can be configured to use an alternate port if that is required.

Example firewall on Server 2012:

The install will create the following files on the server. In some cases, it may be necessary to modify one or more of these files:

• SERVER.MAP
• IPLINPUT.TXT
• TERM.MAP

On a Windows desktop workstation or Windows Server class machine these are located in the application data directory. For example, C:\ProgramData\Thoroughbred Software\Tbsc.

SERVER.MAP

The SERVER.MAP text file establishes a relationship between a 2-character Server ID used by Thoroughbred and the server system.

Thoroughbred uses the Server ID to reference the server system. Enter a line in the file for each server.

The syntax for an entry is:

server-id:[host-name or IP address]:port :PARENT

server-id
is a 2-character alphanumeric string used within Basic to reference a particular server system.

host-name is the host name or IP address for the server system. If the network is unable to resolve the host name specify the IP address.

port is the optional port number used to override the default port 5680. In the event of a conflict with another TCP/IP process using 5680, specify an alternate port in the server.map file and start the DataServer on that port.

PARENT
is required syntax.

IPLINPUT.TXT

Once you establish the server ID you can make the required entries for the IPLINPUT.TXT file.

Each DEV line corresponds to a directory on the server. The syntax for a DEV line is:

DEV device-name,1,,server-flag,,,,server-id:path

device-name
is device ID used to reference logical disk directories. Valid values range from D0 through DZ.

server-flag informs Basic that the disk directory is located on a server and defines the type of server. The value for the Thoroughbred server is 2.

server-id is the two-character alphanumeric code assigned to this server. The server ID on the DEV line must match an entry in the SERVER.MAP file.

path is the directory (on the server) where the data resides. The path may or may not be a fully qualified path. If it is not a fully qualified path, it is interpreted as relative to the directory where the server executable resides.

Example
The following are example of valid DEV lines (using the SERVER.MAP entries defined previously):

DEV D0,1,,2,,,,S1:IDL4

Note

An IPLINPUT file may contain DEV lines that point to directories on the Client system and DEV lines that point to directories on the Server system.

TERM.MAP

The Thoroughbred Environment and the Server Process (tsserv) uses terminal IDs to enforce data integrity (record and file locking). Terminal IDs must be unique not only with other client Basics but also with each server connection. The client and server(s) negotiate at startup to establish a terminal ID that is unique for the client Basic and all servers connected. Therefore, it is not recommended that client Basics be initiated as follows:

./b T5

Terminal table assignment is accomplished using TERM.MAP. See the Thoroughbred Basic Customization and Tuning Guide for information on creating and maintaining the TERM.MAP file.

The SETUP installation creates a TERM.MAP file with the one entry listed below:

WIN|win:WINNTCON

From the TS Network Basic with DataServer Installation Guide, version 8.9.1. Open this page in the PDF