IOP SOLR is being actively used by the user outside of the use by Ranger and thereby SOLR has custom collections that need to be migrated. This requires installation of the IOP SOLR management pack after the upgrade.

	Note
	If Solr was used for Ranger/Atlas as well, you can go ahead with the mpack install or use option 2.

There are no custom collections and is it ok to lose Ranger audit data (if Solr was used with Ranger before the upgrade). In that case, installing the IOP SOLR management pack is not required. After upgrading to HDP 2.6.3, the only required step is to use the Add Service wizard to install Ambari Infra service.

Download the IOP Solr Management Pack.

http://s3.amazonaws.com/dev.hortonworks.com/IOPSOLR/centos7/1.x/BUILDS/1.0.0.0-24/tars/iopsolr/iop-solr-mpack-6.3.0.1.0.0.0-24.tar.gz

Stop ambari server.

ambari-server stop

Install the IOP Solr Management Pack.

ambari-server install-mpack --mpack=/PATH/TO/iop-solr-mpack-VERSION.tar.gz

Replace the path with the absolute path to the IOP Solr Management Pack.

Restart ambari-server.

ambari-server restart

If you removed Solr before and created a backup (see: Backup SOLR), use migration_helper.py script to apply the old configurations. Before running the migration helper script, it’s required to create a json file for the secrets (usually keystore/truststore passwords). (as we cannot get those values through the rest api), you can find a sample in the utilities directory (after you untar the mpack tar.gz file),

If you did not use SSL for Solr before the upgrade, you can use the default values, also the same is true for the other ranger properties if you did not used ranger before. Then you can run the script:

/usr/bin/python migration_helper.py --action configure
--backup-location /tmp/solr-backup --ranger-solr-secrets=secret_defaults.json
--cluster <cluster-name> -H <ambari-server-host> --username
<ambari-admin-username> --password <ambari-admin-password> --port
<ambari-server-port>
# use -s if ambari uses ssl

If the last command finished successfully, you can install IOP Solr Service with the migration_helper.py:

/usr/bin/python migration_helper.py --action install --cluster <cluster-name> -H
<ambari-server-host> --username <ambari-admin-username> --password <ambari-admin-password>
--port <ambari-server-port>
# use -s if ambari uses ssl

You have 2 options here:

	Note
	if something goes wrong, you can remove the service with --action stop and --action remove commands (use the same way as --action install or --action start) The --action configure command will generate json files in the backup folder for every config type (with that name pattern: config-SOLR-<config_type>.json), those will be used as inputs to create the new configs and the host components.

Post Upgrade steps to enable audits to solr in Ranger using IOP-mpack:

Ranger Solr plug-in migration steps:

Verify that the solr-solrj-5.5.x jar is available in the follwing path:

/usr/iopsolr/current/iop-solr/server/solr-webapp/webapp/WEB-INF/lib/ranger-solr-plugin-impl/.

If not, copy it from /usr/hdp/current/ranger-admin/ews/webapp/WEB-INF/lib/.

Different migration steps are appropriate for each of the two, following existing setups. Perform the step(s) appropriate for your environment.