|
To configure the Rules Service on a Windows server computer:
| 1. | Open the appropriate USoft Binder project, or create a new one. |
| See your Setup Help or the USoft Binder Help for more information on USoft Binder. |
| 2. | Add a Rules Service item to the Binder project. |
| 3. | Open the Properties page of the Rules Service item. Enter appropriate values for the Port nr., Start service at boot time, Peer Rules Service, and Hostname properties: |
Parameter
|
Description
|
Service Name
|
This is the name of the Rules Service as it is shown on the Services tab page in the Control Panel of the Windows operating system. By default, the name RulesService is used but it is strongly suggested that you use a name appropriate to the application served, e.g. OrdersService. The Service Name and its port number must be unique. As a consequence, a running service has to be stopped and removed before its name can be changed.
|
Port number
|
This port number is used in the JDBC connection string of the Rules Service. So, you have to specify the same port number that you defined when publishing the web application from Web Designer.
By default, the port number is 7777. It is strongly suggested to choose a unique port number since a port number can only be used by one Rules Service on a machine.
|
Start service at boot time
|
This check box can be selected to start the Rules Service automatically every time your computer is started.
When you uninstall USoft Series, you must clear this check box; otherwise you will get an Event Log error message the next time the computer is started.
|
Peer Rules Service
|
You can specify the host name and port number of another (Peer) Rules Service that is already started. The new, to be started, Rules Service will take its configuration parameters from this Peer Rules Service. If you click the Configure button, an overview of all running Rules Engines is shown.
|
Controlling Hosts
|
Here, you specify the names of those computers that are allowed to change this Rules Service configuration. This allows the controlling hosts to write to the configuration file:
<USoft install folder>/BIN/
RulesService-<port number>.config
|
| 4. | Click the Configure button. |
| An Internet browser opens with the first configuration page. In these configuration pages: |
•Specify the USoft application to serve, and the database account. •Specify the number of Rules Engines to run. •Monitor the Rules Engines that are currently running and the client computers that are currently connected. | 5. | Refer to the help provided with these configuration pages. |
NOTE: You can start and stop the BenchMark profiler from the configuration screen of the Rules Service. Use the Start and Stop buttons on the last Rules Service configuration page (the overview page):
• If you press the Start button, all engines will be stopped with the exception of the engine that is running BenchMark. •If you then press the Stop button, all previously running engines will be restarted.
To create a configuration file from the command line, you can run the rulesservice.exe executable with the -config option. The options you can pass in this command are as follows. These options do NOT cover all the options declared in a Rules Service config file:
Option
|
Description
|
Allowed values
|
-u
|
Database user username
|
|
-pw
|
Database user password
|
|
-database
|
Connection string
|
|
-rdbms
|
RDBMS type
|
OraLogin, OledbLogin, OdbcLogin, JdbcLogin
|
-ow
|
Database owner
|
|
-app
|
Application name
|
|
-LogLevel *
|
Log level of the Rules Service
|
Debug, InternalDebug, Info, Error, No Logging
|
-logdir
|
Directory where the log must be written to
|
|
-prefix
|
Prefix to be used in the log file name
|
|
-msgmode
|
Messages that the rulesservice will provide
|
developer, enduser
|
* The spelling of -LogLevel is case-sensitive.
|
|
