Updating SEAL Elastic Stack¶
Caution - direct update
A direct update to version 8.x requires a version 7.17.5.
If you still work with a version 7.16.x or previous versions, you have to update to version 7.17.5 first.
Preparing the Update¶
Checking Indices¶
-
In a browser, Start Elastic Upgrade Assistant and follow the instructions:
http://localhost:5601/app/management/stack/upgrade_assistant/overviewElastic Upgrade Assistant will check for indices of version 6.x which need to be re-indexed with version 7.x or deleted. Otherwise these indices will not work in version 8.x and later.
For details on re-indexing indices, see below.
You do not need this check, if you update from one version 8.x to another version 8.x.
-
Create a complete backup.
Hint - new server
Making a complete backup and using a new server for a new installation of version 8.x might keep you from installing an interim version. For detail on this, see Updating SEAL Elastic Stack with New Installation.
You need a new server for this, but you can use the automatic configuration of the security.
Hint - automatic configuration
SEAL Elastic Stack 8.x provides an automatic configuration, see Automatic Configuration.
Re-indexing Indices¶
If you update to the next major version, use Elasticsearch Upgrade Helper for re-indexing.
If you prefer a manual re-indexing, procede as follows:
-
In a PowerShell (Administrator), change to the following directory:
cd "C:\Program Files\SEAL Systems\seal-elasticstack-configuration" -
Start the following script:
.\node\node.exe .\configuration\scripts\reindex_accounting_data.js -url <elasticUrl e.g. https://localhost:9200> -u <credentials e.g. elastic:password>
Notes on Activating the Security¶
Hint - Unconfigured security in the old system
If your previous installation did not include an active security configuration, the installation script explicitly deactivates the security settings. You will receive a corresponding notification during the installation.
In this case the script is unable to configure the security settings automatically. You can still configure it manually later.
Hint - Preconfigured security in the new system
If you configure the security settings in your system before you update SEAL Elastic Stack installation, the installation script will leave your settings untouched. This means that Elasticsearch will run without SSL.
Instrucions¶
-
In a browser, log on to the SEAL Systems delivery platform with your logon data:
https://delivery.sealsystems.de
Hint - logon data
You receive the logon data from your Technical Project Manager at SEAL Systems.
-
Download the SEAL Elastic Stack - 8.19.24.551 - msi folder. It is saved as
SEAL Elastic Stack - 8.19.24.551 - msi.zip. -
Extract
SEAL Elastic Stack - 8.19.24.551 - msi.zip. -
In a PowerShell (Administrator), change to the
SEAL Elastic Stack - 8.19.24.551 - msi\serverdirectory and start installing the packages:cd "SEAL Elastic Stack - 8.19.24.551 - msi\server"Set-ExecutionPolicy Bypass -Scope Process -Force; .\install.ps1 -
Open the required firewall ports:
Set-ExecutionPolicy Bypass -Scope Process -Force; .\firewall.ps1 -
Change to the configuration directory of
seal-elasticsearch:cd "C:\ProgramData\SEAL Systems\config\seal-elasticsearch" -
In an editor, compare the
elasticsearch.ymlconfiguration file to the oldelasticsearch.yml.install-bakconfiguration file.Add your customer-specific changes, e.g.
network.host,path.repoorxpack.security.enabled.For details on the general configuration, see Configuring Elasticsearch.
-
Change to the common configuration directory:
cd "C:\ProgramData\SEAL Systems\config" -
In an editor, compare the
kibana.ymlconfiguration file to the oldkibana.yml.install-bakconfiguration file.Add your customer-specific changes, e.g.
server.host,elasticsearch.usernameorelasticsearch.password. -
Set
path.datato the correct value, if necessary.path.data: "${ProgramData}/SEAL Systems/data/seal-kibana"Hint -
path.datasetting movedIn preparation for future versions,
path.datais now set in thekibana.ymlfile instead of the service configuration.For details on the general configuration, see Configuring Kibana.
-
Start Elasticsearch:
start-service seal-elasticsearch -
Start Kibana:
start-service seal-kibanaHint - long duration
If you start Kibana for the first time after the update, this may take very long. Do not stop the starting process, just wait until it is finished.
Hint - Kibana not starting
If Kibana does not start after having been updated, see Deprecated Configuration or Insufficient Hard Disk Space for a possible solution.
-
Update the necessary database configuration as described in Configuration via Script.
-
In Kibana, check whether the dashboards have been overwritten correctly. Delete old dashboards, if they are still existing.