Handling ICU Library Errors in Opensolr

What Are ICU Library Errors?

If you’re uploading or saving configuration files using the Opensolr Editor, you might occasionally be greeted by an error that looks a little something like this:

Error loading class 'solr.ICUCollationField'

Don’t worry—this doesn’t mean the sky is falling or that your config files have started speaking in tongues.

Why Does This Happen?

The error above simply means the ICU (International Components for Unicode) library isn’t enabled on your Opensolr server (yet!). This library is required if your configuration references classes like solr.ICUCollationField—usually for advanced language collation and sorting.

How Do I Fix It?

The solution is delightfully simple: Contact Opensolr Support and request that we enable the ICU library for your server.

• Contact Opensolr Support

A real human (yes, a human!) will flip the right switches for your server, and you’ll be back to uploading config files in no time.

Not Sure If This Is Your Error?

If you’re not sure what sort of error you’re running into—or just want to peek under the hood—you can always check your Error Logs after uploading config files:

1. Click your Index Name in the Opensolr Dashboard
2. Go to Tools → Error Logs

You'll see something like this button in your dashboard:

Check the logs to spot any ICU or other config errors. If it smells like ICU, contact us—if it smells like something else, well… contact us anyway. We're here to help!

TL;DR

• Get an ICU error? Ask Opensolr Support to enable the library for your server.
• Not sure what’s broken? Check your Error Logs (Index Name → Tools → Error Logs).

Happy indexing!