Overview of all update notes
| In the course of an upgrade, all Elasticsearch-related objects such as pipelines, templates, Kibana diagrams and ingest pipelines must be updated. |
4.6
Properties
The properties of the two web applications monitor and monitor-analytics have been adjusted and harmonised with the other con terra products. This concerns the properties of the mailing:
-
mail.hostbecomesmailing.host.
This change must be made in externalapplication.propertiesfiles.
Updating Elastic Index Lifecycle Management Policies & Templates
If service.monitor 4.5 is already in use, an update of the Index Lifecycle Policies and Index Templates for the used data sources is necessary (resources/analytics/elasticsearch/dev-console).
In the templates, a bug with the alias configuration is fixed and the use of Elastic Ingest Pipelines is anchored.
Since version 4.5, if the data source to map.apps user interactions is already active, then the following steps must be performed (SRVMON-718):
-
Update ILM and Index Template as described above.
-
Execute each statement below, replacing
-000001with the value of the most recent index (this may be different for each index)
POST ct-analytics-app*/_alias/analytics-usagelog-app
POST ct-analytics-app-000001/_alias/analytics-usagelog-app
{"is_write_index":true}
POST ct-analytics-map*/_alias/analytics-usagelog-map
POST ct-analytics-map-000001/_alias/analytics-usagelog-map
{"is_write_index":true}
POST ct-analytics-log*/_alias/analytics-usagelog-log
POST ct-analytics-log-000001/_alias/analytics-usagelog-log
{"is_write_index":true}
POST ct-analytics-server*/_alias/analytics-usagelog-server
POST ct-analytics-server-000001/_alias/analytics-usagelog-server
{"is_write_index":true}
POST ct-analytics-tool*/_alias/analytics-usagelog-tool
POST ct-analytics-tool-000001/_alias/analytics-usagelog-tool
{"is_write_index":true}
DELETE ct-analytics-app*/_alias/ct-analytics-app
DELETE ct-analytics-tool*/_alias/ct-analytics-tool
DELETE ct-analytics-map*/_alias/ct-analytics-map
DELETE ct-analytics-log*/_alias/ct-analytics-log
DELETE ct-analytics-server*/_alias/ct-analytics-serverIn the case of using service.monitor with FME Server Jobs, manual adjustments are also necessary if the functionality is already in use (SRVMON-733).
Due to an error, an incorrect assignment of indexes, aliases and patterns occurred here (ct-fme-jobs vs. ct-fme-job).
The stock data must be copied to the index pattern ct-fme-jobs-* under ILM administration.
This is done by re-indexing into the alias ct-fme-jobs.
Afterwards, the old index ct-fme-job can be removed.
# re-index pre-existing entries to index alias
POST _reindex?wait_for_completion=false
{
"source": {
"index": "ct-fme-job"
},
"dest": {
"index": "ct-fme-jobs"
}
}
# once re-indexing has finished and after verifying all fme jobs have been transfered, the old index is safe to delete
DELETE /ct-fme-job
# same procedure for fme jobroutes
POST _reindex?wait_for_completion=false
{
"source": {
"index": "ct-fme-jobroute"
},
"dest": {
"index": "ct-fme-jobroutes"
}
}
DELETE /ct-fme-jobrouteNotifications: Updating the monitoring database schema
Please run the SQL script for your database under resources/sql/upgrade/4.6.
Monitoring: Oracle DB data type check
If you use Oracle DB: Please check if resources/sql/upgrade/4.5/oracle-schema-changes.sql was already executed with the last upgrade.
Analytics Bundles for map.apps
The bundles for collecting user interactions now follow their own release cycle and have been renamed from e.g. usagelog_restservice to analytics_restservice.
This must be taken into account when referencing the bundles in the app.json or the application.properties of map.apps.
4.5
Monitoring
Migration of Oracle DB data type from LONG RAW to BLOB
In order to replace the data type LONG RAW, which is no longer recommended for Oracle databases, with the data type BLOB, the SQL script located under resources\sql\upgrade\4.5 can be executed.
The migration forces the application.property value db.type to be set to the value oracle.
4.4
Analytics
Elasticsearch 7
With service.monitor version 4.4, a major version jump was made to the base technology Elasticsearch used in Analytics. Please follow following update notes.
Monitoring
Adjusting the database tables
Due to the extension of the monitoring by the password management, a new table must be created for existing installations. Please note the SQL update scripts that are located in the update folder of the SQL directory of the installation package for monitoring.
4.3
This section lists all changes to be considered when performing updates.
Adjusting the database tables
By extending the monitoring by service expectations, two new tables have to be created for existing installations. Please note the SQL update scripts that are located in the folder update of the SQL directory of the installation package for monitoring.
More strict SSL connection validation (since Monitoring 4.3.3)
With version 4.3.3 there is by default a more strict validation of HTTP SSL connections in place (sue to security reasons). service.monitor will deny connections to those servers which provide an untrusted, invalid or self-signed certificate. service.monitor will also send a notification once a certificate is not valid. This is also true for those (valid) certificates which are not included in the Java Virtual Machine’s keystore of your Servlet Container. Please see the documentation for importing these.
This behavior can be overridden by configuration options. See chapters Common configuration options and SSL configuration options of the installation guide.