Go to main content
1/30
Contents
Title and Copyright Information
Preface
Audience
Related Documents
Documentation Accessibility
Part I Monitoring and Managing Indexing and Search Service
1
Indexing and Search Service System Administration Overview
About Indexing and Search Service
Overview of Indexing and Search Service Administration Tasks
About Indexing and Search Service Administration Tools
Directory Placeholders Used in This Guide
2
Indexing and Search Service Processes
Overview of Indexing and Search Service Software Architecture
Indexing and Search Service and Dependent Services
Indexing and Search Service Web Services
Convergence
Messaging Server
Directory Server
Indexing and Search Service Store
Log File Locations
Service Interaction and Communication
Indexing and Search Service Data Flow
Search Request
Thumbnail Request
Initial Indexing
Real-time Indexing
3
Stopping and Starting Indexing and Search Service
Stopping and Starting Indexing and Search Service
Starting Indexing and Search Service Services
Stopping Indexing and Search Service Services
4
Best Practices for Indexing and Search Service and Oracle ZFS
About Using ZFS
ZFS Configuration Recommendations for Indexing and Search Service
ZFS Backup Recommendations
5
Setting Up and Managing Indexing and Search Service Accounts
Overview of the Indexing and Search Service Store Instance
About Bootstrapping Indexing and Search Service Accounts
About Email Attachments and Levels of Support
Manually Bootstrapping Indexing and Search Service Accounts
Bootstrapping an Account by Using the Default Allocation Policy
Bootstrapping an Account by Allocating to a Specific Singleton Group
Bootstrapping an Account by Using the --accountlist Option
Removing an Account from Active State
Bootstrapping Examples
Bootstrapping Two Accounts
Bootstrapping Five Accounts
Setting Account State with Multiple Accounts
Autoprovisioning Accounts
Overview of Autoprovisioning
Enabling Autoprovisioning
Selectively Autoprovisioning Accounts
Using Account Selection Parameters
Simple Autoprovisioning Example
Complex Autoprovisioning Example
About Error Handling in Autoprovisioning
Errors in Regular Expressions
Time Out Errors
Autoprovisioning Best Practices
Administering Periodic Automatic Synchronization
Overview of Periodic Automatic Synchronization
Enabling Periodic Autosync
Selecting Appropriate Periodic Autosync Configuration Values
Periodic Autosync Configuration Examples
Large Interval, Small Count, Significant Idle Time
Small Interval, Large Count, No Idle Time
Tuning Periodic Autosync
Controlling the Number of Threads for Periodic Autosync
Controlling the Level of Account Checking
Monitoring Autosync Progress
Automatically Bootstrapping Missing Accounts
Enabling Periodic Autobootstrap
Selecting Conditions for Events to Track in Periodic Autobootstrap
Tuning Periodic Autobootstrap
Controlling the Number of Threads for Autobootstrap
Managing the Autobootstrap Account List
Monitoring Autobootstrap Progress
Replicating Autobootstrap Events to a Standby Server
Automatically Removing Orphaned Accounts
Overview of Automatically Removing Orphaned Accounts
Enabling Automatic Removal of Orphaned Accounts
Disabling Automatic Removal of Orphaned Accounts
Managing Out-of-Sync State Information
Integrating JMQConsumer Information with Autosync
Accessing Account Event Backlog Information
Logging Periodic Account Event Backlog Information
Using issadmin.sh to Query Account Event Backlog Information
Rehosting and Deleting Accounts
6
Managing and Monitoring the Indexing and Search Service Store
About Account Placement in the Indexing and Search Service Store
Terminology and Conventions
Exporting and Importing Accounts Restrictions
Exporting and Importing Accounts Example
Rehosting Users Automatically
Monitoring the Indexing and Search Service Store
Listing Information for All Accounts
Verifying Account Bootstrapping
Gathering Periodic Statistics
Generating a Statistic Snapshot
Index Service Statistics: Output of liststats Option
Understanding Search Service Statistics
JMQConsumer Statistics: Output of listbacklog Option
Using a Firewall Between Indexing and Search Service and Messaging Server
Using Solaris Management Facility to Manage Indexing and Search Service
Improving Global Directory Index Performance
Overview of the Global Directory Index
Choosing an Appropriate Partition Count
Changing Partition Count
7
Troubleshooting Indexing and Search Service
Log Files
Messaging Server IMAP Logs
Service Management Facility (SMF) Logs
Messaging Server and Indexing and Search Service IMQ Broker Logs
Indexing and Search Service GlassFish Server Logs
Indexing and Search Service Messaging Server JMQ Event Consumer Logs
Indexing and Search Service Messaging Server JMQ Consumer Statistics Log
Indexing and Search Service Index Service Log
Indexing and Search Service Index Service Statistics Log
Indexing and Search Service Search Service Log
Indexing and Search Service Search Service Statistics Log
Indexing and Search Service Utility Service Log
Using Command-Line Tools to Diagnose Problems
Using checkIndex.sh
Using lucli.sh
Using luke.sh
Using mergeIndex.sh
Using searchRun.sh
Using issadmin.sh
Using the --accountinfo Option Output
Using the --checkaccount Option Output
When the --sync Option Does Not Synchronize an Account
Details of the Results of the --checkstore Option
Interrupting Commands
Diagnosing Severe System Problems
Account Name Restrictions
Troubleshooting the Indexing and Search Service Web Services Proxy
isshttpd Service Start Fails Until LDAP Entries Are Created
Troubleshooting isshttpd Proxy Using wget
Migrating from Java 6 to Java 7
About Migrating from Java 6 to Java 7
Tools for Java 7 Migration
Java 7 Migration Example
Configuration Considerations for Java 7 Migration
Selecting Appropriate Autosync Configuration Values
Automatically Checking and Repairing dIndex Problems
Selecting Autobootstrap Configuration Values
Disaster Recovery
Recovering from dIndex Directory Data Corruption
Recovering from Individual Account Groups Corruption
Recreating an Individual Account Group Index Directory
Precautions to Reduce Recovery Time
Specific Disaster Scenarios
Recovering From Disk Space Full
Out of Memory Exceptions
Renaming an Indexing and Search Service Host
Troubleshooting FAQ
Why is my installation not picking up changes that I've made to the jiss.conf file?
How can I tell if a mailbox and index are synchronized?
Why does the jmqconsumer log show large time differences or negative time for "time between generate and submit to index svc"?
If I run reconstruct on the mail store, are event notifications generated so that Indexing and Search Service remains synchronized?
How can I check the mail store IMQ broker?
How can I check for problems with indexing emails or attachments, or generating thumbnail images?
Is there a way to rotate the Indexing and Search Service logs?
What does a 403 error mean in the GlassFish Server server.log file?
8
Improving Indexing and Search Service Performance
Improving Performance While Bootstrapping Users
Improving Overall Bootstrap Performance
Confirming Bootstrapping Optimization
Improving Bootstrap Performance for Large Accounts
Optimizing Event Backlog
Increasing RESTful Web Services Search Rate
Setting Up Large Deployments
Tuning RESTful Web Services
GlassFish Server domain.xml File
Tuning http-listener
Tuning request-processing
Tuning keep-alive Connections
Tuning JVM Options
Tuning Access Logging
Message Queue Broker config.properties File Tunings
Tuning Java Message Service Threads
Tuning Maximum Number of Producers
imqbroker.conf File Tunings
Tuning jmqbroker JVM Options
Tuning jmqconsumer JVM Options
Tuning Search Service JVM Options
Tuning Index Service JVM Options
Part II Administering a High-Availability System
9
Managing Indexing and Search Service High Availability
Administering Indexing and Search Service High Availability
Adding Cluster Search Services
Bootstrapping Users on Indexing Hosts
Verifying Users on Web Hosts
Adding an Additional Web Host
Removing a Web Host
Troubleshooting Indexing and Search Service High Availability
General Differences Between Indexing Hosts and Web Hosts
Troubleshooting Web Hosts
Troubleshooting Indexing Hosts
Troubleshooting clusterv2
GlassFish Server (Web Node) Error
Searching Rest Interface Always Returns 404 Error
10
Managing the Watcher Service
Overview of the Indexing and Search Service Watcher Service
How the Watcher Service Performs Monitoring
Configuring the Watcher Service
Enabling the Indexing and Search Service Watcher Service
Configuring Email Notifications
How the Watcher Service Determines to Send Email Notifications
Part III Indexing and Search Service API
11
Overview of the Web Service API
Overview of Indexing and Search Service Web Service API
HTTP GET Parameters
Search Query Parameter
Optional Data Type Parameter
Optional Format Parameter
Optional Sort Parameter
Optional Start Index Parameter
Optional Count per Page Parameter
Optional Content Format Parameter
Optional Thumbnail Parameter
Optional JavaScript Callback Parameter (JSON Format Only)
Optional Timeout Parameter
12
Using Search Query and Sort Criteria
About Search Results and Pattern Matching
Search Query Field Names
Sort Criteria
How IMAP SEARCH Uses Search Query Field Names
Search Query Syntax
Term Modifiers
Other Search Features
13
Search Query Output Format
Supported Output Formats
Sample JSON Output: Standard Format
Sample JSON Output: attachmentOnly Format
Part IV Indexing and Search Service Log Messages
14
Utility Service Log Messages
FINE Level
INFO Level
WARNING Level
SEVERE Level
15
Search Service Log Messages
INFO Level
WARNING Level
SEVERE Level
16
Message Queue Consumer and Broker Log Messages
Message Queue Consumer Log Messages
INFO Level
WARNING Level
Broker Log Messages
WARNING Level
17
Index Service Log Messages
FINE Level
INFO Level
WARNING Level
SEVERE Level
18
GlassFish Server Log Messages
INFO Level
WARNING Level
SEVERE Level
Part V Indexing and Search Service Reference
19
Indexing and Search Service Command-Line Utilities
Common Information
List of Indexing and Search Service Utilities
checkIndex.sh
Syntax
Options
checkIss
Syntax
Options
Example crontab Entry
Example Output from checkIss
checkIss Functions Based on Indexing and Search Service Installation Type
checkStack
Syntax
Options
Example
csearchmgr.sh
Syntax
Options
Examples
factorymgr.sh
Syntax
Options
Examples
issadmin.sh
Syntax
Options
Examples
isshttpdmgr
Syntax
Options
Examples
issrehostuser.sh
Syntax
Options
Rehosting an Account from One Indexing and Search Service Instance to Another
issversion
Syntax
Example
mergeIndex.sh
Syntax
Options
search_query_number.sh
Syntax
Options
Example
searchRun.sh
Syntax
Options
svc_control.sh
Syntax
watchermgr.sh
Syntax
Examples
Additional Indexing and Search Service Scripts
Deprecated Commands
indexSvcBootstrap.sh
Syntax
Options
Example
indexSvcFork.pl
Syntax
Options
Example
indexSvcFork.sh
Syntax
Options
Example
20
Indexing and Search Service Configuration Parameters
Local Installation Configuration
Message Store Configuration
Message Queue Configuration
Directory Server Configuration for Java Naming and Directory Interface
GlassFish Server Configuration
Indexing and Search Service Services Run Time Configuration
Watcher Service Configuration
Web Services Proxy (isshttpd)
Cluster Configuration for Indexing and Search Service
Deprecated Parameters
21
IMAP Search Behavior in Indexing and Search Service
Overview of IMAP Search Behavior Differences
Substring Matches
Quoted Phrases
Searches in Foreign Alphabets
Indexing and Search Service Versus IMAP SEARCH
Handling Search Errors and Timeouts
Glossary
Scripting on this page enhances content navigation, but does not change the content in any way.