mirror of
https://github.com/overcuriousity/autopsy-flatpak.git
synced 2025-07-06 21:00:22 +00:00
76 lines
5.8 KiB
Plaintext
76 lines
5.8 KiB
Plaintext
/*! \page upgrade_solr_page Upgrading Solr
|
|
|
|
[TOC]
|
|
|
|
\section solr_upgrade_solr4 Upgrading from Solr 4 from Solr 8
|
|
|
|
To upgrade from Solr 4 to Solr 8, first follow the instructions on the \ref install_solr_page page. At the end of that process, all new cases will be created using Solr 8. If you need to open older cases that were created using Solr 4, please see the following sections which describe how to set up Solr 4 and Solr 8 in parallel and how to migrate Zookeeper data.
|
|
|
|
\subsection install_solr_solr_4 Legacy (Solr 4) Autopsy Cases and Text Indexes
|
|
|
|
Things to keep in mind regarding backwards compatibility with existing Solr 4 multi-user cases (cases created with Autopsy versions 4.17.0 and earlier):
|
|
|
|
<ul>
|
|
<li>New text indexes can only be created using Solr 8 (Autopsy version 4.18.0 and later).
|
|
<li>Autopsy is able to open and search existing Solr 4 single-user cases. This functionality comes "out of the box" and nothing needs to be configured or installed to achieve this.
|
|
<li>Solr 8 multi-user server is unable to open existing legacy Solr 4 multi-user cases because Solr indexes are only backward compatible one major version back (i.e. Solr 8 is only able to open indexes created using Solr 8 or Solr 7).
|
|
</ul>
|
|
|
|
To overcome this limitation on older multi-user cases, there is an option of configuring Autopsy to be able to connect to both Solr 8 and Solr 4 multi-user servers. If a multi-user Solr 4 server is configured, you will be able to open and search existing Solr 4 cases, as well as add data sources to the existing Solr 4 cases, thus adding more data to the existing legacy Solr 4 text indexes. However, new text indexes can only be created using Solr 8. Note that a Solr 4 server is unable to open text indexes created using a Solr 8 server.
|
|
|
|
\subsection install_solr_parallel Running Solr 8 and Solr 4 Multi-user Servers in Parallel
|
|
|
|
It is possible to configure Autopsy to be able to connect to both Solr 8 and Solr 4 multi-user servers. Start Autopsy and open the multi-user settings panel from "Tools", "Options", "Multi-user". Note that in order to create or open Multi-user cases, "Enable Multi-user cases" must be checked and the settings below must be correct.
|
|
|
|
It is recommended that you run Solr 8 and Solr 4 servers on separate machines. In the example below, Solr 8 server is running on a machine with host name "Solr1" and Solr 4 server is running on a machine with host name "Solr6".
|
|
|
|
\image html solr_running_in_parallel.png
|
|
|
|
Once both the Solr 8 and Solr 4 multi-user server connection info is entered and saved, Autopsy will be able to open both Solr 8 multi-user cases (Autopsy version 4.18.0 and later), as well as legacy existing Solr 4 multi-user cases (cases created with Autopsy versions 4.17.0 and earlier).
|
|
|
|
<b>IMPORTANT</b>: The "Test Connection" button does not verify which version of Solr Autopsy is connecting to. It only verifies that Autopsy is connecting to a Solr server and is able to receive a response. Therefore it is important that the user enters correct server connection info in appropriate fields.
|
|
|
|
If you intend to run Solr 4 and Solr 8 servers on the same machine at the same time, you need to change the port of the Solr 8 service using the setting <b>SOLR_PORT</b> in \c "C:\solr-8.6.3\bin\solr.in.cmd" file (assuming that the Solr package ZIP was extracted into \c "C:\solr-8.6.3\" directory). By default the Solr service starts on port 8983.
|
|
|
|
\subsection install_solr_zk_migration Migrating existing ZooKeeper data to Solr 8 server
|
|
|
|
If you have an existing Solr 4 server that you have been using in Multi-User (MU) mode and you wish to migrate this data onto your new Solr 8 server, we have developed a migration utility that performs this task. Note that the utility is able to migrate ZooKeeper data from any one ZooKeeper server to another ZooKeeper server, and is not tied to migrating Solr 4 ZooKeeper data to a Sol 8 ZooKeeper server.
|
|
|
|
In our example we will be migrating ZooKeeper data from a ZooKeeper server running on a Solr 4 server (on machine "Solr6") to a brand new ZooKeeper server running on a Solr 8 server (on machine "Solr1").
|
|
|
|
You can browse the existing ZooKeeper data if you go to Solr6 machine and open the Solr admin console (http://localhost:8983/solr/#/). In the Solr admin console, navigate to "Cloud"-> "Tree", and expand the "autopsy" section of the tree:
|
|
|
|
\image html solr_zk_migration_1.png
|
|
|
|
You can follow the same steps to browse the ZooKeeper data on the new Solr 8 server (on "Solr1" machine). If Autopsy has not been used with this server yet, the "autopsy" folder will be missing, as in the example below:
|
|
|
|
\image html solr_zk_migration_2.png
|
|
|
|
The ZooKeeper migration utility (ZookeeperNodeMigration.jar) is located in \c "C:\Program Files\(current version of Autopsy)\autopsy\ZookeeperNodeMigration" directory:
|
|
|
|
\image html solr_zk_migration_3.png
|
|
|
|
ZookeeperNodeMigration utility requires the following inputs:
|
|
<ul>
|
|
<li>Input Zookeeper IP Address or Hostname
|
|
<li>Input Zookeeper Port Number
|
|
<li>Output Zookeeper IP Address or Hostname
|
|
<li>Output Zookeeper Port Number
|
|
</ul>
|
|
|
|
For example, if you execute the following command from command line, the Zookeeper nodes will get copied from Zookeeper server on Solr6:9983 to Zookeeper server on Solr1:9983 :
|
|
|
|
> java -jar ZookeeperNodeMigration.jar Solr6 9983 Solr1 9983
|
|
|
|
\image html solr_zk_migration_4.png
|
|
|
|
If you do not have Java installed on the machine, you can use the packaged version of Java that is distributed along with Autopsy. For example:
|
|
|
|
> \c "C:\Program Files\Autopsy-4.18.0\jre\bin\java.exe" -jar ZookeeperNodeMigration.jar Solr6 9983 Solr1 9983
|
|
|
|
To verify that the ZooKeeper data has been copied from the Solr6 server to the Solr1 server, refresh the Solr admin console on the Solr1 machine. You should now see the "autopsy" directory, along with its contents, when you go to the "Cloud" -> "Tree" section of the Solr admin console:
|
|
|
|
\image html solr_zk_migration_5.png
|
|
|
|
|
|
*/ |