mscluster Command Reports Error in \etc\services File

Problem Description

When you install the iProcess Engine, the installer writes the port numbers used by the iProcess Engine watcher and worker process sentinels to the %systemroot%\system32\drivers\etc\services file.

The SWDIR\mscluster\mscluster utility attempts to replicate these entries to the %systemroot%\system32\drivers\etc\services file on the Windows cluster node. If it encounters an error, the utility displays this message:

Checking entries in 'etc\services'

followed by one of the errors listed .:

Error	Meaning
Error: watcher port number Number already in use by process	mscluster cannot create the required entry for the watcher process because the allocated port Number is already in use on this machine by the indicated process. You will need to either change the port number used by the indicated process, or use a different port number for the watcher process.
Error: port mismatch for watcher entry `nodename_watcher` - entry currently uses `CurrentNumber` rather than `NewNumber`	mscluster cannot create the required entry for the watcher process because an entry already exists for it. The current entry uses port CurrentNumber but mscluster needs to allocate port NewNumber to it. You will need to manually update the existing entry.

Error

Meaning

Error: watcher port number Number already in use by process

mscluster cannot create the required entry for the watcher process because the allocated port Number is already in use on this machine by the indicated process.

You will need to either change the port number used by the indicated process, or use a different port number for the watcher process.

Error: port mismatch for watcher entry nodename_watcher - entry currently uses CurrentNumber rather than NewNumber

mscluster cannot create the required entry for the watcher process because an entry already exists for it. The current entry uses port CurrentNumber but mscluster needs to allocate port NewNumber to it.

You will need to manually update the existing entry.

Note	The error messages are shown for the `watcher` process. The same errors can also occur for the `worker` process.

What to Do

To resolve this problem:

1. Using a suitable text editor, open the %systemroot%\system32\drivers\etc\services file.

If necessary, change the port number allocated to the other process indicated in the error message.

Add the required entry for the watcher (or worker) process, in the format:

nodename_SentinelType Number/tcp [# Comment]

where:

— nodename is the iProcess Engine nodename.

— SentinelType is either watcher or worker, as shown in the error message.

— Number is the port number you want to use, either the original number that mscluster tried to use (as reported in the error message) or a different number, as required.

Note	The port number must be a unique entry in this file (for example, not used by any other entry). There must be a blank line left at the bottom of the `services` file, otherwise the last line is ignored.

— Comment (optional) is any descriptive text you want to add.

Save the file.

Note

If you have used a different port number than the one that mscluster tried to use, you must replicate this change to the other machines in the iProcess Engine system. Repeat steps 1 to 4 on the iProcess Engine master server, any iProcess Engine slave servers, and each other machine in the Windows cluster.

Did you find this helpful?

Yes No