Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# 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.

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.

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

| 3. | 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.

| 4. | 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
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.