Client Server - Revision history

Gordon.dye: /* LINUX- (first read the Windows install instructions) */

2023-03-20T05:07:02Z

LINUX- (first read the Windows install instructions)

Gordon.dye: /* Components */

2023-03-20T04:27:03Z

Components

← Older revision		Revision as of 04:27, 20 March 2023
Line 39:		Line 39:
	\|\|BRserver\|\|Linux or MAC BR Server Program		\|\|BRserver\|\|Linux or MAC BR Server Program
	\|-		\|-
	\|\|[[~~Install~~.exe]]\|\|BRListener.exe Installer for Windows Server		\|\|[[BRListenerInstaller.exe]]\|\|BRListener.exe Installer for Windows Server
	\|-		\|-
	\|\|[[BRListener.exe]]\|\|Server side Connection Agent and Server side Connection Agent		\|\|[[BRListener.exe]]\|\|Server side Connection Agent and Server side Connection Agent
	\|-		\|-
	\|}		\|}


	==Installation Instructions==		==Installation Instructions==

Gordon.dye: /* Activating the Server */

2021-11-23T01:38:37Z

Activating the Server

← Older revision		Revision as of 01:38, 23 November 2021
Line 84:		Line 84:
	=== Activating the Server ===		=== Activating the Server ===
	{{:BRListenerInstaller.exe}}		{{:BRListenerInstaller.exe}}
	~~At this point if~~ installation is ~~successful~~ Windows Services will have an entry for BR_Listener. If the logfile has been set up appropriately it should now be created and have a few messages in it. Rebooting is NOT needed in order to use it.		After installation is done, Windows Services will have an entry for BR_Listener. If the logfile has been set up appropriately it should now be created and have a few messages in it. Rebooting is NOT needed in order to use it.

	;If all has worked so far you should be able to launch the client. To launch the client run:		;If all has worked so far you should be able to launch the client. To launch the client run:

Gordon.dye: /* Activating the Server */

2021-11-23T01:36:30Z

Activating the Server

← Older revision		Revision as of 01:36, 23 November 2021
Line 91:		Line 91:

	Where 'computer' is an IP address or IP name and BR is the labelname in brlistener.conf. You can get your server's IP number by going to a DOS shell and running 'ipconfig'.		Where 'computer' is an IP address or IP name and BR is the labelname in brlistener.conf. You can get your server's IP number by going to a DOS shell and running 'ipconfig'.

	~~TO REMOVE the listener from your system, the install program may be used by typing install /release.~~

Gordon.dye: /* Activating the Server */

2021-11-23T01:34:43Z

Activating the Server

← Older revision		Revision as of 01:34, 23 November 2021
Line 83:		Line 83:

	=== Activating the Server ===		=== Activating the Server ===
	~~After the brlistener.conf file is in place on the server, install (activate) the brlistener.exe NT service on the server. This can be done by placing BRlistener~~.exe in the Windows\System32 directory and then logging in as administrator and running [[Install.exe]]. Once the listener is installed as a service, it will automatically be invoked each time the server is rebooted.		{{:BRListenerInstaller.exe}}
			At this point if installation is successful Windows Services will have an entry for BR_Listener. If the logfile has been set up appropriately it should now be created and have a few messages in it. Rebooting is NOT needed in order to use it.
	The brlistener.conf file is processed only at the time the listener is started. So if it needs to be changed, you must uninstall (see remove below) and reinstall the listener to activate the revised conf file.

	At this point if installation is successful ~~NT Diagnostics/services~~ will have an entry for BR_Listener. If the logfile has been set up appropriately it should now be created and have a few messages in it. Rebooting is NOT needed in order to use it.

	;If all has worked so far you should be able to launch the client. To launch the client run:		;If all has worked so far you should be able to launch the client. To launch the client run:

Gordon.dye: /* Activating the Server */

2021-11-23T00:22:04Z

Activating the Server

← Older revision		Revision as of 00:22, 23 November 2021
Line 96:		Line 96:

	TO REMOVE the listener from your system, the install program may be used by typing install /release.		TO REMOVE the listener from your system, the install program may be used by typing install /release.


			An alternate way to specify the server location is to use a separate control file called BR_Parms.txt.

			{{:BR Parms.txt}}

	===Security Issues:===		===Security Issues:===

Gordon.dye: /* WINDOWS- */

2021-11-22T06:49:29Z

WINDOWS-

← Older revision		Revision as of 06:49, 22 November 2021
Line 54:		Line 54:
	The brlistener.conf file has three statements:		The brlistener.conf file has three statements:

	logfile= specifies the location and name of a trace file ( do not use quotes nor spaces in this path)		logfile= specifies the location and name of a trace file ( do not use quotes nor spaces in this path)<br>
	loglevel= leave at 10 for now - may be significant later<br>		loglevel= leave at 6 for now - may be significant later<br>
	port= port number to use (default is 8555)		port= port number to use (default is 8555)

Gordon.dye: /* WINDOWS- */

2021-11-22T05:15:41Z

WINDOWS-

← Older revision		Revision as of 05:15, 22 November 2021
Line 63:		Line 63:
	STARTDIR= Starting server directory ( do not use quotes nor spaces in this path)		STARTDIR= Starting server directory ( do not use quotes nor spaces in this path)
	STDERR= Filename to contain error reports.		STDERR= Filename to contain error reports.
	EXECUTABLE= Pathname of BRserver executable. Note- You can ~~now~~ initiate an application ~~from~~ a BRCONFIG.SYS EXECUTE statement.		EXECUTABLE= Pathname of BRserver executable.
			Note- This executable refers to BR itself. You can initiate your application via a BRCONFIG.SYS EXECUTE statement.

	CAPTION= The client login prompt window caption.		CAPTION= The client login prompt window caption.
	CONFIG= Pathname to BRConfig.sys file - optional - defaults to server startdir		CONFIG= Pathname to BRConfig.sys file - optional - defaults to server startdir

Gordon.dye: /* Manual Installation Instructions */

2021-11-22T05:01:27Z

Manual Installation Instructions

← Older revision		Revision as of 05:01, 22 November 2021
Line 46:		Line 46:


	==~~Manual~~ Installation Instructions==		==Installation Instructions==

	===WINDOWS-===		===WINDOWS-===

Gordon.dye at 05:01, 22 November 2021

2021-11-22T05:01:01Z

Show changes

← Older revision		Revision as of 05:07, 20 March 2023
Line 122:		Line 122:

	===LINUX- (first read the Windows install instructions)===		===LINUX- (first read the Windows install instructions)===

			First we describe the steps involved in installing brlistener under Linux. '''Then we provide an install script for managing the process.'''

	Revise the brlistener.conf file appropriately. See the Windows install section for brlistener.conf specifications.		Revise the brlistener.conf file appropriately. See the Windows install section for brlistener.conf specifications.
Line 132:		Line 134:
	;Where brserver.script contains:		;Where brserver.script contains:

	TERM=ansi; # this is not needed for BR to work		TERM=ansi; # this is not needed for BR to work - it is simply an example of using a script
	export TERM;		export TERM;
	/u/myapp/br/brserver run menu $*		/u/myapp/br/brserver run menu $*

	Note- The trailing $* is required.		Note- The trailing $* is required.


	Copy or link brlistener.conf to the /etc directory.		Copy or link brlistener.conf to the /etc directory.
Line 142:		Line 145:
	Place brserver in the directory where it will reside.		Place brserver in the directory where it will reside.

	As superuser, execute brlistener. It will configure itself as a daemon. If the logfile has been ~~set up appropriately~~ it should now be created and have a few messages in it.		As superuser, execute brlistener. It will configure itself as a daemon. If the logfile has been specified in brlistener.conf, it should now be created and have a few messages in it.

	;At this point you should be able to launch the client (either Windows or MAC, or both):		;At this point you should be able to launch the client (either Windows or MAC, or both):

	BRclient computer ~~BR (~~ 8555 )		BRclient computer-ref label-name

			Where computer-ref is an IP address or IP name and label-name is the label name in brlistener.conf. computer-ref can be followed by :port-number in the event you wish to use a port other than 8555.

	~~Where~~ computer ~~is an IP address or IP~~ name ~~and BR is the labelname in brlistener.conf.~~		BRclient computer-ref:7543 label-name

	To ~~remove~~ the listener from your system simply kill the process (-9 not needed)~~. This may be handy for restarting the listener - especially since its configuration file is only read when it starts~~.		To deactivate the listener from your system simply kill the process (-9 not needed).

	You will need to put the startup command into either inittab or rc2.d in order to automatically start the brlistener upon bootup.		You will need to put the startup command into either inittab or rc2.d in order to automatically start the brlistener upon bootup.

	A script has been written ~~(brlist)~~ to make the listener into a service on Linux. This makes it easy to initiate the listener in a way that it automatically starts at bootup and it is easily managed thereafter. The name of the script is "brlist". This script is self installing. First (as superuser) copy the script into a temporary directory and make it executable. Next place a link to brlistener in /usr/sbin (or copy brlistener to /usr/sbin) and make it executable. Then type "./brlist install". This will copy the script to where it will be needed and it will establish bootup linkage to itself.		=== Linux Install Script ===

			A script has been written to make the listener into a service on Linux. This makes it easy to initiate the listener in a way that it automatically starts at bootup and it is easily managed thereafter. The name of the script is "brlist". This script is self installing. First (as superuser) copy the script into a temporary directory and make it executable. Next place a link to brlistener in /usr/sbin (or copy brlistener to /usr/sbin) and make it executable. Then type "./brlist install". This will copy the script to where it will be needed and it will establish bootup linkage to itself.

	;Thereafter the listener can be (re)started or stopped as follows:		;Thereafter the listener can be (re)started or stopped as follows:
Line 166:		Line 173:

	:1.) Setup the normal BR terminal based application.		:1.) Setup the normal BR terminal based application.
	:2.) In the BR program directory place BRLISTENER, BRLISTENER.CONF, BRSERVER, BRLIST and BRCONFIG.SVR.		:2.) In the BR program directory place BRLISTENER, BRLISTENER.CONF, BRSERVER, BRLIST and BRCONFIG.SVR. Note- under Linux these names are lower case.
	:3.) BRCONFIG.SVR contains OPTION 30, a SCREEN statement and GRAPHIC_LINEDRAW SUNKEN, in addition to including the regular BRCONFIG.SYS.		:3.) BRCONFIG.SVR contains OPTION 30 (if server side printing), a SCREEN statement and GRAPHIC_LINEDRAW SUNKEN, in addition to including the regular BRCONFIG.SYS.
	:4.) BRLISTENER.CONF STARTUP= this directory EXECUTE=/path/BRSERVER (or a script) CONFIG=BRCONFIG.SVR.		:4.) BRLISTENER.CONF STARTUP= this directory EXECUTE=/path/BRSERVER (or a script) CONFIG=BRCONFIG.SVR.
	:5.) Link BRLISTENER.CONF to /etc.		:5.) Link BRLISTENER.CONF to /etc.