Upgrading Indexing and Search Service for Oracle Communications Unified Communications Suite
Version 1 Update 4
To upgrade to Indexing and Search Service 1 Update 4 from Indexing and Search Service 1, obtain and install the Indexing and Search Service 1 Update 4 patch then rebootstrap accounts if the version you upgraded from was earlier than 1 Update 3.
To patch to Indexing and Search Service 1 Update 4, run the platform-specific command. For example, on Solaris run patchadd. For more information, refer to the Indexing and Search Service 1 Update 4 README file.
The final step in this process is to manually run iss-svr-base/bin/postpatch_restart.sh iss-svr-base after completing the upgrade. Because the postpatch process might be interactive, you must manually run postpatch_restart.sh.
For more information, see postpatch_restart.sh.
(Optional) If you also upgraded from Java 6 to 7, you need to rebootstrap accounts. Going forward, Java 7 is recommended, as Java 6 is entering end of life. If ISS indexes were generated while on Java 6, once you upgrade to Java 7, you should regenerate the indexes. See Rebootstrapping Accounts for more information.
To make use of features in Indexing and Search Service 1 Update 4, such as periodic auto-sync and autobootstrapping, see Indexing and Search Service Post Configuration.
When updating from a version earlier than Indexing and Search Service 1 Update 3, after the upgrade, you should rebootstrap all user accounts. This step is not necesssary when updating from Indexing and Search Service 1 Update 3.
Here is one possible way to rebootstrap your accounts:
- Use the Messaging Server imquotacheck command to get a list of all accounts on the system.
- Delete all information in the redirected quotafile except the user IDs. Make sure that there is a single user ID on each line of the file.
- Get a sense of the size of the users by running the following commands.
- How many users?
- Largest users by size, distribution of account sizes?
- Total mailbox size in Kbytes?
You might want to save a copy of the imquotacheck and mboxutil -l output to ISS for later reference.
- On ISS, remove the existing index by using the /opt/sun/comms/jiss/examples/removeindex command.
- Run /opt/sun/comms/jiss/examples/createuserlist < quotafile to create users.
- Re-initialize the index by using the /opt/sun/comms/jiss/examples/initializeindex command.
- Bootstrap all users in the quotafile in parallel by using the /opt/sun/comms/jiss/examples/parallelbootstrap command.
By default, the command bootstraps 16 users in parallel. Edit the file if you need to change this.
The indexes for ISS 1 Update 4 are not backward compatible with previous versions of ISS. When downgrading from ISS 1 Update 4 to an earlier release, you must regenerate the index information. If you need to downgrade to ISS 1 Update 3 from ISS 1 Update 4, you only need to regenerate some of the index directories.
To downgrade to ISS 1 Update 3 from ISS 1 Update 4:
- Stop all ISS services.
As root, run the following command:
- Run the iss-base/examples/findbigaccounts.sh script to get a list of accounts that have been modified to use the new folder flags implementation in ISS 1 Update 4.
The index information format for these accounts is not backward compatible with previous versions.
- Reinstall ISS 1 Update 3.
See Indexing and Search Service 1 Update 3 Installation Scenario for instructions.
- Delete and rebootstrap each account from the output in step 2.
If you downgrade to any version prior to ISS 1 Update 3 from ISS 1 Update 4, you need to regenerate the index information for all accounts. You can use the iss-base/examples/removeindex script to remove the entire index so that the index can be recreated after you have completed the downgrade from ISS 1 Update 4.