Page Comparison

Necessary Actions When Updating/Upgrading

...

• 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
    • 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>

        
        

    • 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.)

...

• 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.
  • Updating yuuvis^® RAD repository-manager:
    
    • With version 2.2.x, a new KGS contentserver version has been integrated. Therefore, updating from version 2.1.x to 2.2.x the working-dir needs to be deleted.
      After installation, a new KGS-configuration is required.