Troubleshooting
Problem
Attempts to remove an environment record using vwtool -> env -> r -> p -> username command will result in unable to locate a NCH server for the specified domain error.
Symptom
There are two Process Engine servers in the PE farm, peservername1 and peservername2. The error occurs if the env command is executed from peservername1. If the same command is executed in peservername2 no error is returned and the environment record is deleted as expected.
Here is an example :
<vwtool:1>env
View/ Inconsistency Check/Cache environment records (CR=v,i,c): v
Persistent or cached environment records (CR=p, c): p
User name, '*' for all users: johndoe
Name: johndoe
Realm: dc=mywindowsdomain dc=com
DisplayName:JonnDoe
DN:
cn=johndoe,ou=myorganization,dc=mywindowsdomain,dc=com
Id: 50
WebAppl: 0
DB Time stamp: 03/25/2011 19:25:45
Field name Field Type Field Value
---------- ---------- -----------
F_DefaultServerId integer 0
F_EMailAddress string 'johndoe@anywhere.com'
IsGroup: FALSE
<vwtool:1>env
View/ Inconsistency Check/Cache environment records (CR=v,i,c): r
Persistent or cached environment records (CR=p, c):
User name, '*' for all users: johndoe
WARNING: If there are still work objects associated with a deleted
user's id
,
those work objects will be unresolved.
WARNING: Preferences for deleted users will be lost.
Are you SURE you want to continue? (Yes/No):Yes
Command terminated by error: 9c00001a
=> '[Err=9c00001a] Unable to locate a NCH server for the specified
domain.'
Cause
Invalid nch entry for one of the PE servers in f_sw.VWServer table.
Diagnosing The Problem
1. Use nch_tool and run the listobj * command to list the nch name from both PE servers
For example:
(from peservername1)
nch_tool> listobj *
DefaultIMS:peservername1:FileNet
...
...
VWServer0_0:peservername1:FileNet
VWService0:peservername1:FileNet
fn_system:peservername1:FileNet
(from peservername2)
nch_tool> listobj *
DefaultIMS:peservername2:FileNet
...
...
VWServer0_0:peservername2:FileNet
VWService0:peservername2:FileNet
fn_system:peservername2:FileNet
2. Compare the output with the nch entry in f_sw.VWServer table in PE database.
For example, the domain part in the nch entry for peservername2 was spelled wrong
F_SERVERNAME F_TYPE F_DEFAULTSERVICE F_HEARTBEAT F_STATE F_FLAGS
peservername1 1 VWService0:peservername1:FileNet 1301093400 1
peservername2 1 VWService0:peservername2:FilNet 1301093397 1
Resolving The Problem
- Shutdown both Process Engine nodes.
- Remove the entry for the affected PE server from f_sw.VWServer table.
For example: in Oracle
SQL> DELETE from f_sw.VWServer WHERE F_SERVERNAME='peservername2'; - Restart both Process Engine servers. The server entry should be repopulated in the VWServer table automatically afterward.
- Verify the new entry.
For example:
SQL> select * from f_sw.VWServer;
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg21496111