My Oracle Support Banner

Where Does " --setstate" Get The Default Backend Host Name From? (Doc ID 2112208.1)

Last updated on MARCH 06, 2016

Applies to:

Oracle Communications Indexing and Search Service - Version and later
Information in this document applies to any platform.


Using ISS

Where does --setstate get the default back-end name?

I occasionally do: --setstate A --user USERID

and get an error saying that user is not in (the wrong back-end).

The issue is that mailXX is not the back-end associated with the index server where I am doing the command.
I can workaround this by specifying --host (the right back-end).

But, where is it getting this default hostname?  Does it have anything to do with the mail.server parameter in the jiss.conf file?

Here is an example that looks at the --setdefaulthostname value and the mail.server value to illustrate:

On a lab system, I had ISS configured with mail.server in jiss.conf set to This was the initial setting that I specified after running the setup script. I can see that in the jiss.conf, I have:

mail.server =

I then unset the defaulthostname param:

bash-3.2# ./ --setdefaulthostname ""
Tue Mar 1 13:35:49 GMT 2016
removing default hostname, was
Tue Mar 1 13:35:49 GMT 2016

Ran a refresh, since this parameter is listed in the refreshable parameters from --refresh --help:

bash-3.2# ./ --refresh
Tue Mar 1 13:36:02 GMT 2016
Tue Mar 1 13:36:03 GMT 2016

Ran a --listbrief to see the settings:

bash-3.2# ./ --listbrief
Tue Mar 1 13:36:18 GMT 2016
Store ID: ISSID_e30c7b65-1674-4410-b002-f2881e7ed65e created: 20131120185454
default host name:
default export/import path:

But, after doing all of the above, the jiss.conf still contains the mail.server = entry, as it did previously.

It is confusing as to why the jiss.conf was not "updated" with the above change, since mail.server was listed as a refreshable parameter.  To see if it would change anything, I stopped ISS and restarted, but mail.server was still set to the original entry.  In this case, how is jiss.conf updated for the mail.server parameter?  Is there an explanation for this (or does jiss.conf have to be edited manually)?


To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.