Primary Note for Oracle Communications Indexing and Search Service (ISS)
(Doc ID 1354963.1)
Last updated on APRIL 28, 2022
Applies to:
Oracle Communications Indexing and Search ServiceInformation in this document applies to any platform.
Details
This is the Primary Note for Oracle Communications Indexing and Search Service (aka ISS) which is a component of the Oracle Communications Unified Communications Suite. The Primary Note for the Suite may be found here - Oracle Communications Unified Communications Suite Primary Note (Doc ID 1297190.1)
Audience
The information contained in this note targets product administrators and installers.
About Indexing and Search Service
Indexing and Search Service for Oracle Communications Unified Communications Suite is a general-purpose indexing and searching server. As email inboxes become increasingly larger, the importance of a fast, efficient indexing and search service cannot be underestimated. Consequently, Indexing and Search Service initially supports email data in the message store, including embedded data in a variety of formats. ISS provides a RESTful web services interface for search, thus any client capable of interacting with such a service is supported. Oracle Communications Messaging Exchange Server consumes ISS services to bring search services to any IMAP-based mail client. Message body searches done from your mail client can use the ISS engine to perform fast, comprehensive searches of message bodies and attachments.
Actions
Getting Started
Oracle Communications Indexing and Search Service (ISS) was originally bundled as part of Oracle Communications Unified Communications Suite 7.
Documentation
Note: As of July 23, 2015 former documentation on the wiki can now be found in the Oracle Help Center in PDF format.
Note that wiki pages have been consolidated to one single PDF per product.
For more information, see: What Happened to the Wiki-Based Messaging Server Documentation? (Doc ID 2037418.1)
The most current ISS documentation can be found at http://docs.oracle.com/en/industries/communications/indexing-search-server/index.html
Note that wiki pages have been consolidated to one single PDF per product.
For more information, see: What Happened to the Wiki-Based Messaging Server Documentation? (Doc ID 2037418.1)
The most current ISS documentation can be found at http://docs.oracle.com/en/industries/communications/indexing-search-server/index.html
The most recent product documentation may be found here:
The most recent Release Notes and details of what is new in Indexing and Search Service may be found here:
- Oracle Communications Indexing and Search Service 1.05 Release Notes
- Indexing and Search Service for Oracle Communications Unified Communications Suite 1.0.5.22.0, 1.0.5.23.0, and 1.0.5.24.0 Release Notes (pdf)
- New Features in Indexing and Search Service 1.0.5.22.0 (pdf)
- New Features in Indexing and Search Service 1.0.5.23.0 (pdf)
- New Feature in Indexing and Search Service 1.0.5.24.0 (pdf)
Previous Releases:
- Indexing and Search Service for Oracle Communications Unified Communications Suite Release Notes Version 1.0.5.18.0 (pdf)
- New Features in Indexing and Search Service 1.0.5.18.0 (pdf)
- Indexing and Search Service for Oracle Communications Unified Communications Suite Release Notes Version 1 Update 4 (patches 15 & 16) (pdf)
- New Features in Indexing and Search Service 1 Update 4 Patch 16 (pdf)
- Indexing and Search Service for Oracle Communications Unified Communications Suite Release Notes Version 1 Update 4 (patch 16) (pdf)
- New Features in Indexing and Search Service 1 Update 4 (pdf)
- Indexing and Search Service for Oracle Communications Unified Communications Suite Release Notes - Version 1 Update 3 and 1 Update 4 (patches 14 & 15) (pdf)
- What's New in Indexing and Search Service 1 Update 3 and Update 4 (pdf)
- What's New in Indexing and Search Service 1 Update 4 (pdf)
- Indexing and Search Service 1 (Update 1 & Update 2) Release Notes (pdf)
- What's New in Indexing and Search Service 1 Update 1 (pdf)
- What's New in Indexing and Search Service 1 Update 2 (pdf)
- Indexing and Search Service 1 Release Notes (pdf)
- What's New in Indexing and Search Service 1 (pdf)
Deployment Planning
The following documents may prove useful for deployment planning prior to installation:
For compatibility of various Unified Communications Components, see:
Installation
The following links are short-cuts to sections within the full Indexing and Search Service Installation and Configuration Guide, (unless otherwise stated), that are specific to Indexing and Search Service:
- Communications Suite Installation Flowchart: Indexing and Search Service (pdf) (in the Comms 7U1 Install & Config Guide)
- Installing Indexing and Search Service
- Running the Indexing and Search Service Initial Configuration Script
- Indexing and Search Service Post-Installation Tasks
- Configuring Indexing and Search Service for High Availability
Quick reference for deploying the whole Unified Communications Suite on a single host for evaluation can be found in the following step-by-step guides:
- Deployment Example: Oracle Communications Unified Communications Suite 7.0.6 on a Single Host (Solaris) (pdf)
- Deployment Example: Oracle Communications Unified Communications Suite 7.0.6 on a Single Host (Linux) (pdf)
Upgrading
- Upgrading Indexing and Search Service
- Oracle Communications Indexing and Search Service 1.0.5.22.0 Upgrade (pdf)
- Upgrading Indexing and Search Service for Oracle Communications Unified Communications Suite Version 1.0.5.18.0 (pdf)
- Upgrading Indexing and Search Service for Oracle Communications Unified Communications Suite - Version 1 Update 4 (pdf)
Administration
The Indexing and Search Service System Administrator's Guide contains most of the useful information needed including some of the most commonly referenced sections:
- Indexing and Search Service Command-Line Utilities
- Indexing and Search Service Configuration Parameters
- Indexing and Search Service Overview of the Web Service API
- Setting Up and Managing Indexing and Search Service Security (in the Indexing and Search Service Security Guide)
Performance Tuning
It is strongly recommended that these guides are followed.
- Improving Indexing and Search Service Performance
- ISS Performance Tuning under Glassfish 3 (Doc ID 1938643.1)
Patches
See: Installing Patches (in the Installation and Configuration Guide)
- CommsInstaller Based Patch 26661143 (all platforms) (v1.0.5.30.0) - for use with commpkg upgrade to install it rather than patchadd.
Legacy Patches (below is the last legacy patch available. Moving forward, apply the Commsinstaller patches above)
- 142824-29 - Indexing and Search Service 1u5-29.15600 / 1.0.5.29.0: core patch for Solaris
- 142823-29 - Indexing and Search Service 1u5-29.15600 / 1.0.5.29.0: core patch for Solaris_x86
- 142825-29 - Indexing and Search Service 1u5-29.15600 / 1.0.5.29.0 RHEL5.0: core patch for Red Hat Linux
Before applying patches, please check the patch README file as well as the latest Release Notes, What's New and Upgrade Documentation for any special requirements etc.
Troubleshooting
- Troubleshooting Indexing and Search Service Installation Problems
- Troubleshooting Indexing and Search Service
- Troubleshooting FAQ
Knowledge Articles
(Note this may not be a comprehensive list of all articles)
FAQs
"How To" Articles
- How To Install ISS When There Are Multiple Stores? (Doc ID 1434244.1)
- How To Calculate JMQ Broker Heap Memory Use In ISS (Doc ID 1498373.1)
- Patching JMQ - OS Version vs. Glassfish Application Server Version - Which should be used for ISS? (Doc ID 1511283.1)
- ISS: Is There a Way to Control What Type of Attachments are Indexed? (Doc ID 1542611.1)
- ISS Services Will Not Restart In Oracle Communications Suite Solaris Cluster (Doc ID 1552152.1)
- Is It Possible To Disable ISS For One Domain? (Doc ID 1563878.1)
- ISS 1u4 - dIndex Backups Are Happening At An Irregular Interval (Doc ID 1574193.1)
- Parenthesized Search Query Does Not Get Sent To ISS, Stays With Messaging Server IMAPd (Doc ID 1574563.1)
- How to Debug Errors While Accessing RESTful Web Services Search in ISS (Doc ID 1906372.1)
- ISS Enhancement To Add Sorting Features To Search (Doc ID 1918660.1)
- ISS While Bootstrapping a User Seeing "WARNING: checkForCorruptdIndex" (Doc ID 1927402.1)
- How Do I Install A Multi-Tier ISS Service (Doc ID 1934426.1)
- ISS Performance Tuning under Glassfish 3 (Doc ID 1938643.1)
- Request For Additional Monitoring For Index Service In ISS (Doc ID 2001407.1)
- How Can I Confirm That ISS Is in Use and that Users Are Indexed by ISS? (Doc ID 2042589.1)
- ISS Upgrade Procedure Question with --converttoformat Option (Doc ID 2049563.1)
- How are "guidDup" or "copyDup" records Created in ISS? (Doc ID 2074792.1)
- Large Disparity In Response Time For Similar Search Queries On Same ISS Server (Doc ID 2080064.1)
- Failover For ISS (Doc ID 2083684.1)
- What Actions Should Be Taken If ISS Will Be Offline For Maintenance For A Few Hours? (Doc ID 2105383.1)
- What Is The Meaning Of This Long Entry In The iss-indexsvc.log About "content segment difference"? (Doc ID 2107224.1)
- Where Does "issadmin.sh --setstate" Get The Default Backend Host Name From? (Doc ID 2112208.1)
- WARNING: Unable to set the Creation Date java.io.IOException: Error converting date...NameOfAttachment : jsmith@oracle.com_INBOX_1234.pdf (Doc ID 2115882.1)
- How To Re-deploy The ISS War Files? (Doc ID 2141383.1)
- ISS Document: Confusion on Whether Msgflags Should be Enabled or Disabled (Doc ID 2153378.1)
- How To Configure Existing ISS 1u5 p26 Or Higher To Work With GlassFish 3.1.2.14 and Embedded Message Queue 4.5.2 (Doc ID 2155204.1)
- On ISS Startup, Seeing Error In Broker Log: The Portmapper Service Got An Exception Processing A Request From Client (Doc ID 2170442.1)
- If ISS Is Not Being Used By Convergence, Is There Any Use In It Generating Thumbnails? (Doc ID 2189729.1)
- ISS: WARNING: Time To Create Email Document (100 Seconds) Exceeded Limit (30 Seconds) (Doc ID 2189754.1)
- "Unable To Obtain Lock To Index" Errors When Running --checkstore Command (Doc ID 2191652.1)
- Does ISS Configuration Create The SMF Definition For Mqbroker? (Doc ID 2197048.1)
- How Does imap.indexer.bodytextonly Option Interact With service.imap.indexer.suffix_search Option? (Doc ID 2209533.1)
- How Can You Change The Indexing and Search Service Instance Name? (Doc ID 2215466.1)
- IssException: No Service Proxy Available - What Does This Relate To? (Doc ID 2227684.1)
- What Is The Best Way To Check ISS Activity In The Logs? (Doc ID 2226774.1)
- Why Are There Old Log Files That Are Not Removed For ISS? (Doc ID 2231248.1)
- What Is The Meaning Of This Message: "INFO: autoDelete: delete candidate rejected: <userID> <server> will not be deleted" (Doc ID 2238971.1)
- Output From findrebootcandidates - What Causes Duplicates In Accounts? (Doc ID 2250552.1)
- How Do I Check That Autodelete Is Working On ISS? (Doc ID 2262427.1)
- Which Parameters In jiss.conf Are Refreshable By issadmin.sh --refresh? (Doc ID 2262894.1)
- How To Count The Rate Of Bootstrapping Accounts (Doc ID 2262925.1)
- ISS Error: <Num> folder numbers (out of NNN) are greater than maximum (XXX largest found: NNN) (Doc ID 2267827.1)
- ISS Unable To Accept Search Requests As Fast As Messaging Server Is Sending Them (Doc ID 2270512.1)
- Delay Seen Saving Mail to Sent Folder With ISS Enabled (Doc ID 2284937.1)
- How Is the Mail.defaultdomain Parameter In Jiss.conf Used? (Doc ID 2290626.1)
Problems and Solutions
- ISS JMQConsumer Gives "String index out of range" Error During Startup When Hostname Starts with "V" (Doc ID 1287045.1)
- ISS Accounts Not In Sync Return Incorrect Results (Doc ID 1377243.1)
- System Stacked Up Connections To The ISS Host Using All Ephemeral Ports (Doc ID 1386821.1)
- ISS JMQ Broker Fails To Respond (Doc ID 1437316.1)
- Event queue for user@example.com has reached limit of 5000, no more events will be queued (Doc ID 1504500.1)
- ISS Not Responding / GlassFish Server Hung (Doc ID 1511056.1)
- ISS Error in JMQ Consumer Log SEVERE: Could Not Create Response Destination Queue and Consumer (Doc ID 1511265.1)
- ISS Glassfish Search Returning 401 Errors (Doc ID 1522910.1)
- ISS WARNING: CheckForCorruptdIndex ... dIndex Is Not Clean (Doc ID 1523731.1)
- ISS 1u4 patch 15: Error in JMQ Consumer Log SEVERE: Could Not Create Response Destination Queue and Consumer (Doc ID 1538128.1)
- ISS Error: "Backlog Too Big: Event NewMsg Ignored" (Doc ID 1556480.1)
- ISS - Encountering Errors After Upgrading From ISS Patch 13 To Patch17 (Doc ID 1559254.1)
- ISS 1u4 Unresponsive (Doc ID 1560260.1)
- JMQ / ISS: Running "imqcmd query" Results In Errors (Doc ID 1562392.1)
- ISS 1u4 p17 With GlassFish Message Queue Broker 4.4 Crashes Repeatedly (Doc ID 1566882.1)
- ISS Abandons Users In State X (Doc ID 1572829.1)
- ISS 1u4: "indexSvc check failed" Services Are Running But Not Processing Events (Doc ID 1573563.1)
- User Accounts Stuck In Inactive or "I" State On ISS (Doc ID 1581050.1)
- ISS 1u4 P17 - IMAP ESEARCH Searches Are Not Sent To ISS (Doc ID 1581339.1)
- ISS 1u4 Errors During Bootstrap Of User (Doc ID 1581361.1)
- ISS 1u4 JMQConsumer Unable to Startup Seeing "java.lang.StringIndexOutOfBoundsException" Error (Doc ID 1583452.1)
- ISS-searchsvc Failing Unable To Connect To Broker (Doc ID 1587996.1)
- Installation of Indexing & Search Service fails With Non-English Locales (Doc ID 1588192.1)
- 404 Error For The Search Servlet Of JISS (Doc ID 1588200.1)
- ISS Search Results Inconsistent On Same Exact Query Compared to IMAP Search Results (Doc ID 1588494.1)
- Mail Searches Are Not Hitting The ISS Server (Doc ID 1598196.1)
- ISS User is Out Of Sync On A System That Has Very Little Traffic In a Test Lab (Doc ID 1609155.1)
- ISS Search Results In Extraneous Matches From Email Headers (Doc ID 1609807.1)
- ISS Server Unable To Start - SEVERE: Exception during store initialization com.sun.comms.iss.common.IssException: Number of account state records in dIndex xxx) does not match max size (1000) (Doc ID 1609877.1)
- Indexing and Search Service 1u4 P17 "tokenization error" In ISS Logs (Doc ID 1612335.1)
- IMAP Taking A Long Time To Process Large Mailbox Search Requests with ISS - Seeing "Uid NN% done" In Telemetry Log (Doc ID 1623796.1)
- ISS mail.ugfilter Does Not Process UIDs Correctly (Doc ID 1629964.1)
- Multiple ISS Stores Are Not Supported In Convergence (Doc ID 1639649.1)
- Indexes Out of Sync After Upgrading Version of Java (Doc ID 1664729.1)
- ISSHTTPD Does Not Work When Convergence Is Running On Port 80 (Doc ID 1680965.1)
- Unable to Start isshttpdmgr (Doc ID 1682346.1)
- Some Words Unsearchable in Word .docx Files by ISS (Doc ID 1901461.1)
- Indexsvc Java.lang.OutOfMemoryError - PermGen Space (Doc ID 1906016.1)
- Error Bootstrapping Users in ISS: Account Could Not Be Assigned to Group (Doc ID 1906793.1)
- Configure_appserv.pl Error Installing ISS Patch 142824-22 (Doc ID 1907828.1)
- Unable to Install ISS Patch 22 if the Product Has Not Yet Been Installed (Doc ID 1911025.1)
- Java Message Queue Broker ERROR /var/imq/instances/imqbroker/etc/passwd (Too Many Open Files) (Doc ID 1919017.1)
- ISS Search Logs Contains '???' Characters (Doc ID 1921101.1)
- If System Locale Is Set to "C" - ISS Script Returns With Error (Doc ID 1921473.1)
- ISS Bootstrap Error: MS account is empty (Doc ID 1925948.1)
- Ldap -y Option Fails During LINUX ISS Install (Doc ID 1933797.1)
- Index And Search Service Is Not Indexing All Accounts (Doc ID 1934292.1)
- ISS Mqbroker And Jmqconsumer Hung Under High Load (Doc ID 1940245.1)
- After Upgrade to ISS 1u5 p23 - Utilsvc Not Cleaning Up Files In Iss.tmp.dir (Doc ID 1943517.1)
- If indexSvc is Not Shutdown Cleanly, Autobootlist Information is Lost (Doc ID 1954269.1)
- ISS: Mod_file_cache.so Doesn't Exist Error During Restart (Doc ID 1959063.1)
- CheckIss Fails On Newly Provisioned Linux ISS Servers And Seeing "java.lang.OutOfMemoryError - unable to create new native thread" Errors (Doc ID 1961836.1)
- Cannot Deploy The Rest War With ISS (Doc ID 1963221.1)
- Error 500 When Trying To Use The Rest Servlet (Doc ID 1967883.1)
- Autobootstrap User Hangs And Does Not Complete (Doc ID 1983438.1)
- No Show Of Thumbnails On Attached Files In Convergence Or In RestUI (Doc ID 1988610.1)
- ISS Seeing High Load On Servers (Doc ID 1991861.1)
- There Is No "-t ms" In Setup Script (Doc ID 1993613.1)
- ISS Searches And Results Are Taking Too Long (Doc ID 1996238.1)
- ISS dIndex Inconsistencies Seeing "ArrayIndexOutOfBoundsException" And "duplicate id records found in account documents" Errors (Doc ID 2016624.1)
- ISS DIndex Problem Discovered, Cannot Initialize Store (Doc ID 2018857.1)
- Errors And Exceptions When Attempting To Search ISS - Error: "no such account (account could not be assigned to group)" (Doc ID 2019721.1)
- ISS 1u5 Patch 23 - Java Version 1.7.0_79-b15 - CheckIss Shows False Feedback On ISS Status (Doc ID 2025472.1)
- Getting HTTP 408 Error In GlassFish Server Access Log For ISS Search Queries From A User With Large Mailbox (Doc ID 2029720.1)
- ISS Reporting Frequent OutOfMemory Errors In JMQConsumer Log (Doc ID 2038695.1)
- Messaging Server Has Permissions Issue When Attempting To Rehost Users Along With Their ISS Index (Doc ID 2039202.1)
- CheckIss Command in ISS 1u5 p24 Does Not Detect That GlassFish Application Server Is Down (Doc ID 2049540.1)
- MQ Broker Is In Maintenance Mode (Doc ID 2049647.1)
- Incorrect Search Results From ISS When Using Date Ranges (Doc ID 2051662.1)
- GlassFish/ISS Searches Are Using Incorrect Domain (Doc ID 2066907.1)
- Upgrade Of ISS Server Shows Version Mismatch (Doc ID 2072367.1)
- Check_iss Appears To Be Hanging (Doc ID 2073954.1)
- Issadmin --Bootstrap Reporting Error "MS account is empty" After User Has Been Rehosted (Doc ID 2079551.1)
- JPS Failing When Java Has Been Upgraded To Version 1.7.0_79, Works on Version 1.7.0_40 (Doc ID 2084348.1)
- CheckIss Returns: "Response timed out on request to indexSvc indexSvc check failed" and Logs Show Lots of "False Meta Not Closed Content Not Closed" (Doc ID 2087643.1)
- ISS Errors in iss-indexSvc.log: WARNING: AccountManager.checkCounts: Mismatch (Doc ID 2089818.1)
- IndexSvc Enters Maintenance Mode After Thumbnails/Attachment Directory Is Removed (Doc ID 2108551.1)
- Large Attachments Over 3GB Causing OutOfMemoryError Errors in ISS (Doc ID 2110116.1)
- ISS - What Does "not In A Searchable State" Mean? (Doc ID 2111008.1)
- ISS Is Slow And Takes Over 60+ Seconds For A Header Search (Doc ID 2112361.1)
- "BAD Search too complex in UID SEARCH command" Message Returned as a Result of an IMAP Search Command (Doc ID 2117531.1)
- CheckIss Command Failed With Error: WARNING: [I500]: Caught JVM Exception: java.io.EOFException: Trying to read 72 bytes. Already read 0 bytes. (Doc ID 2134094.1)
- CheckIss Command Returns Timeout On Services But Does Not Provide Real Time It Took (Doc ID 2136970.1)
- ISS - User Can Not Be (bootstrapped, Deleted, Synced) And Checkstore Index Shows It Is Not Corrupt (Doc ID 2151597.1)
- ISS Gives Warning Messages About Account "NOT SYNCED" When Mail Folder Names Are Encoded (Doc ID 2148189.1)
- Running ISS Command --Checkaccount Appears Unresponsive (Doc ID 2160714.1)
- ISS Setup Fails On Solaris 11 Because No /usr/ucb/ps (Doc ID 2171829.1)
- ISS: jiss.install Log File Contains - Warning [A2016]: Unencoded Name=value Entry Found In Passfile (Doc ID 2171900.1)
- ISS Should Not Be Searching Invisible Headers To Get Search Results (Doc ID 2174647.1)
- ISS Index Service Will Not Start On Some Servers After Upgrading To Patch 28 (Doc ID 2177283.1)
- Startup Sequence for ISS With New Broker Integrated With Current GlassFish (Doc ID 2178367.1)
- Files Installed Into GlassFish By ISS Setup Owned By Root Instead Of Issuser (Doc ID 2188934.1)
- Seeing Error: Mixed Terms In Parenthesized List Not Supported Yet (Doc ID 2204973.1)
- ISS Gives Error Messages About "folder name: xxx does not match normalized name" In Checkstore Output (Doc ID 2226479.1)
- Timeout While Configuring ISS After Upgrade - ERROR: Could Not Configure ISS Services! (Doc ID 2229860.1)
- Seeing A High Rate Of Dropped/ignored Change Flag Events In ISS (Doc ID 2233569.1)
- User Account Being Bootstrapped Again So Soon - Stuck In "B" State (Doc ID 2251567.1)
- Parallel Bootstrap Hanging Patch 29 (Doc ID 2253162.1)
- Deleted Accounts Are Still Present In The "issadmin.sh --autobootaccounts --listaccountlistfile" Output (Doc ID 2257291.1)
- ISS Accounts Are Out Of Sync (Doc ID 2277241.1)
- ISS Install Error: functions.pl: setup_master_key Cannot run /san/mail/iss/Current/jiss/bin/jks --init output: Error: Could not find or load main class com.sun.comms.iss.common.Jks (Doc ID 2278708.1)
- Restarting ISS Leaves Accounts Stuck In B State (Doc ID 2281859.1)
- ISS / Glassfish Message Queue Broker Runs Out Of Threads (Doc ID 2283947.1)
- Index Service Hanging On SSD System (Doc ID 2285897.1)
This page is under constant construction. We are always interested in any feedback on this type of document. Please use the comments link. Thanks!
Contacts
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
| Details |
| Actions |
| Getting Started |
| Documentation |
| Deployment Planning |
| Installation |
| Upgrading |
| Administration |
| Performance Tuning |
| Patches |
| Troubleshooting |
| Knowledge Articles |
| FAQs |
| "How To" Articles |
| Problems and Solutions |
| Contacts |
| References |