Necessary Actions When Updating or Upgrading to 8.16 (LTS)
Necessary Actions When Updating/Upgrading
This page describes the actions that you must manually execute when updating from version 7.x to a newer version. It also lists things that you must pay special attention to. An update to a new version that skips some of the previous versions is possible and does not require updating to each version in between. However, in this case, you must carry out all the actions from your previous version to the target version in the order listed here.
7.16 --> 8.0
- Manual steps are mandatory. See How to upgrade to yuuvis RAD 8.0 for a step-by-step guide.
8.4 --> 8.6
- The license of the elasticsearch IntraFind-plugin expired on 07/01/2022 and needs to be renewed:
- Stop Elasticsearch 7.16.2
- Copy the file "license.jar" that can be found in the folder <setups>\elasticsearch to the folder "<elasticsearch7.16.2>\plugins\intrafind-linguistic" overwriting the existing one.
- Start Elasticsearch 7.16.2 again.
- The license of the elasticsearch IntraFind-plugin expired on 07/01/2022 and needs to be renewed:
8.10 --> 8.12
- The password for the database connection of the core-service that is defined in the
jas-app.xml
file can now be stored in a credential store instead of saving it in plain text in the file.
This is an optional feature. If you want to implement it, follow these steps:- Stop the core-service.
- Create a credential store.
- Open the file
<core-service>\tools\change-db-pwd.bat
- Replace all occurrences of @@CS_PASSWORD@@ with the same arbitrary password of your choice (for the credential store).
- Save the file
- Open a command prompt and change the directory to <core-service>\tools
- Execute the following command:
change-db-pwd.bat "databaseUserPassword"
Replace databaseUserPassword with the password of the user that connects to the database
- Open the file
- Add the credential store to the
jas-app.xml
file and point the database connection password to it.- Open the
<core-service>\standalone\configuration\jas-app.xml
file. Locate the
<subsystem xmlns="urn:wildfly:elytron...>
section and add the credential stores section to it as shown below. Replace"CS_PASSWORD"
with your the credential store password chosen above.<
subsystem
xmlns="urn:wildfly:elytron...>
<
credential-stores
>
<
credential-store
name
=
"dbcredstore"
relative-to
=
"jboss.server.config.dir"
path
=
"dbcredstore.cs"
create
=
"true"
>
<
credential-reference
clear-text
=
"CS_PASSWORD"
/>
</
credential-store
>
</
credential-stores
>
Locate the
<datasource jndi-name="java:/JASDB"
...>
section and replace the line<password>databaseUserPassword</password>
with<credential-reference store="dbcredstore" alias="databasePW" />
as shown below.<
datasource
jndi-name
=
"java:/JASDB"
...>
...
<
security
>
<
user-name
>sa</
user-name
>
<
credential-reference
store
=
"dbcredstore"
alias
=
"databasePW"
/>
</
security
>
- Open the
- Save and restart the core-service.
To change the password at a later time, execute the batch-file<core-service>\tools\change-db-pwd.bat
.
(Make sure the change-db-pwd.bat file does not contain any @@CS_PASSWORD@@ occurrences - if so replace them as described above.)
- The password for the database connection of the core-service that is defined in the
8.12 --> 8.14
- With version 8.14 the OCR-Service was updated to use ABBYY FineReader 12. Therefore the existing installation of FineReader 11 must be removed and version 12 installed:
- On the server hosting the OCR-Service, open the Windows uninstall Dialog and choose to uninstall FineReader 11.
- If you can't find FineReader in the list of the applications, start the FineReader11 setup.exe installer. It will recognize that there already is an installation and ask whether to uninstall it.
- Unzip the file Finereader12.4.7.63.zip from the setups directory and start installing FineReader 12 by executing the file setup.exe.
- When asked choose to license FineReader immediatly
- When asked choose the Software Key License
- When asked choose Production or Test license according to the server type you are installing to.
- After the setup is finished copy the license file to the <FineReader12>\Bin and <FineReader12>\Bin64 directories.
- Restart the OCR-Service if it is already running.
- On the server hosting the OCR-Service, open the Windows uninstall Dialog and choose to uninstall FineReader 11.
- Updating yuuvis® RAD repository-manager:
- With version 4.2.x, a new KGS contentserver version has been integrated. Therefore, updating from version 4.1.x to 4.2.x the working-dir needs to be deleted.
After installation, a new KGS-configuration is required.
- With version 4.2.x, a new KGS contentserver version has been integrated. Therefore, updating from version 4.1.x to 4.2.x the working-dir needs to be deleted.
- With version 8.14 the OCR-Service was updated to use ABBYY FineReader 12. Therefore the existing installation of FineReader 11 must be removed and version 12 installed:
8.14 --> 8.16
- Updating yuuvis® RAD repository-manager:
- With version 4.3.x, the data model needs to be extended. There is an additional flag isB
arcodeProcessingError
which indicates errors during barcode processing.
The extended schema is provided with the update and can be found after update in <rm-workdir>\obj-def.
- With version 4.3.x, the data model needs to be extended. There is an additional flag isB
- Context-Path settings
- If using a custom context path, the file <service-manager-data>\webresource\resources\client\assests\_default\confiig\extend.json must be changed to only contain the parameter "contextPath": '/yuuvis' instead of all base addresses - as described here https://help.optimal-systems.com/yuuvisRAD/v80/admin/en/architecture/microservices/mic_tsk_install.htm?Highlight=context%20path
- Updating yuuvis® RAD repository-manager: