Skip to content
English
  • There are no suggestions because the search field is empty.

FileCloud Search Not Working After Enabling Solr Basic Authentication

Original Question or Issue:

This article describes the steps required to update Solr authentication credentials in FileCloud environments after enabling Solr Basic Authentication or changing the Solr password. If FileCloud is unable to authenticate with Solr, search functionality may stop working until the FileCloud and Solr configurations are synchronized.


Environment:

  • Product - FileCloud Server
  • Version - 23.253.3
  • Platform - Windows

Steps to Reproduce:

  • Enable Basic Authentication in Solr by configuring security.json.
  • Update or change the Solr user password.
  • Attempt to perform a search operation in FileCloud without updating the corresponding Solr credentials in FileCloud configuration files.
  • Search requests fail because FileCloud is unable to authenticate with Solr.
  • Solr Admin UI may be accessible with the new credentials, while FileCloud search functionality remains unavailable.

Error or Log Message:

Search functionality returns no results.


Defect or Enhancement Number:


Cause:

The Solr authentication credentials configured in FileCloud did not match the credentials configured in Solr. After enabling Solr Basic Authentication or changing the Solr password, FileCloud configuration files were not updated accordingly, causing authentication failures between FileCloud and Solr.


Resolution or Workaround:

  • Verify the Solr authentication credentials.
  • Update the Solr credentials in FileCloud configuration files, including cloudconfig.php.
  • Configure the required Solr authentication parameters:
    • Linux:
      • SOLR_AUTH_TYPE="basic"
      • SOLR_AUTHENTICATION_OPTS="-Dbasicauth=<username>:<password>"
    • Windows:
      • set SOLR_AUTH_TYPE=basic
      • set SOLR_AUTHENTICATION_OPTS=-Dbasicauth=<username>:<password>
  • Restart FileCloud services on all web nodes.
  • Validate successful authentication between FileCloud and Solr.
  • Test search functionality and confirm successful search operations.
  • Apply the same configuration updates to all environments (UAT and Production).

Notes:

  • The issue was reproduced and resolved in both UAT and Production environments.
  • Search functionality was successfully restored after synchronizing the Solr credentials and restarting FileCloud services.