Skip to main content

Migration to version 4.5

Introduction

This article describes the migration path to version 4.5. Please note it is advisable to create a backup before the migration.

In the version 4.5, object storage was introduced as a voluntary way of storing the data. Please note two separate versions of 4.5 are released which means that two installers/updaters are being used. Please always make sure to choose the right installer/updater. In version 4.6, object storage is planned to become obligatory.

New installations should always use the newest base package, which can be found in web ftp server. Link to web ftp: https://webftp.priint.com/WebInterface/login.html. Base package can be found in “priint_suite_(version)/publishing server base zips/latest/PubServer_Base_(version/revision)-Windows.7z” (Windows version) or “priint_suite_(version)Linux)/publishing server base zips/latest/PubServer_Base(version/revision)_UbuntuLinux.deb” (Linux version).

Migration to version 4.5

Upgrade from 4.1.8

Direct update to version 4.5 is not possible. Please take the following steps.

Update to version 4.1.9

Please update your version to version 4.1.9. The following actions need to be taken before the update.

Payara upgrade to version 2020.5 is needed before migration. Please check the article How-to Update Payara in an Existing Pubserver for more details.
Please clean up the following directories: glassfish\payara5\glassfish\domains\pubserver\generated, glassfish\payara5\glassfish\domains\pubserver\osgi-cache, glassfish\payara5\glassfish\domains\pubserver\lib\databases
Check your domain.xml if the following jvm-options for grizzly-npn-bootstrap exist for the java version you use. If needed please add them:

<jvm-options>[1.8.0|1.8.0u120]-Xbootclasspath/p:${com.sun.aas.installRoot}/lib/grizzly-npn-bootstrap-1.6.jar</jvm-options>
<jvm-options>[1.8.0u121|1.8.0u160]-Xbootclasspath/p:${com.sun.aas.installRoot}/lib/grizzly-npn-bootstrap-1.7.jar</jvm-options>
<jvm-options>[1.8.0u161|1.8.0u190]-Xbootclasspath/p:${com.sun.aas.installRoot}/lib/grizzly-npn-bootstrap-1.8.jar</jvm-options>
<jvm-options>[1.8.0u191|1.8.0u250]-Xbootclasspath/p:${com.sun.aas.installRoot}/lib/grizzly-npn-bootstrap-1.8.1.jar</jvm-options>
<jvm-options>[1.8.0u251|]-Xbootclasspath/a:${com.sun.aas.installRoot}/lib/grizzly-npn-api.jar</jvm-options>

please follow How-to Update Payara in an Existing Pubserver - step 13 to add priint_camunda schema and privileges to the priintadmin user.
upgrade the included MySQL Database version to 8.0. Please consult the following article: https://kb.priint.com/index.php/article/how-to-upgrading-the-included-mysql-database-version-to-8-0/
take the steps from the next section to update to version 4.5

Upgrade from 4.1.9

The following actions need to be taken before the update.

migrate payara 2020.5 to 2022.5 from the base package 4.5. Please check the article How-to Update Payara in an Existing Pubserver for more details.
add jdk 17 to the java folder of your PubServer. The directory of the JDK 17 should have the name jdk. If needed, please check the base package for version 4.5 to find JDK 17 (folder java/jdk).
Check your domain.xml and add the following jvm-options:

<jvm-options>[17|]--add-exports=java.base/sun.net.www=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-exports=java.base/sun.security.util=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang.invoke=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.desktop/java.beans=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-exports=jdk.naming.dns/com.sun.jndi.dns=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang.ref=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/sun.reflect.generics=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/sun.reflect.generics.repository=ALL-UNNAMED</jvm-options>

install priint-bpm. Please check the article priint-bpm on Linux or priint-bpm on Windows accordingly.
install rendering-service. Please check the article Rendering-service on Windows or Rendering-service on Linux accordingly. For installations using PDF renderer, please consult the article Rendering-service 4.5 with priint:pdf renderer Setup Guide for Ubuntu 22.04.3 LTS.
update using the updater of version 4.5

Upgrade from 4.2.0

Please follow the below steps:

Please clean up the following directories: glassfish\payara5\glassfish\domains\pubserver\generated, glassfish\payara5\glassfish\domains\pubserver\osgi-cache, glassfish\payara5\glassfish\domains\pubserver\lib\databases
add jdk 17 to the java folder of your PubServer. The directory of the JDK 17 should have the name jdk. If needed, please check the base package for version 4.5 to find JDK 17 (folder java/jdk).
Check your domain.xml and add the following jvm-options:

<jvm-options>[17|]--add-exports=java.base/sun.net.www=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-exports=java.base/sun.security.util=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang.invoke=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.desktop/java.beans=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-exports=jdk.naming.dns/com.sun.jndi.dns=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang.ref=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/sun.reflect.generics=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/sun.reflect.generics.repository=ALL-UNNAMED</jvm-options>

install priint-bpm. Please check the article priint-bpm on Linux or priint-bpm on Windows accordingly.
install rendering-service. Please check the article Rendering-service on Windows or Rendering-service on Linux accordingly. For installations using PDF renderer, please consult the article Rendering-service 4.5 with priint:pdf renderer Setup Guide for Ubuntu 22.04.3 LTS.
update using the updater of version 4.5

Upgrade from 4.3.0

Please follow the below steps:

Please clean up the following directories: glassfish\payara5\glassfish\domains\pubserver\generated, glassfish\payara5\glassfish\domains\pubserver\osgi-cache, glassfish\payara5\glassfish\domains\pubserver\lib\databases
add jdk 17 to the java folder of your PubServer. The directory of the JDK 17 should have the name jdk. If needed, please check the base package for version 4.5 to find JDK 17 (folder java/jdk).
Check your domain.xml and add the following jvm-options:

<jvm-options>[17|]--add-exports=java.base/sun.net.www=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-exports=java.base/sun.security.util=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang.invoke=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.desktop/java.beans=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-exports=jdk.naming.dns/com.sun.jndi.dns=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang.ref=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/sun.reflect.generics=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/sun.reflect.generics.repository=ALL-UNNAMED</jvm-options>

if needed, install priint-bpm. Please check the article priint-bpm on Linux or priint-bpm on Windows accordingly.
if needed, install rendering-service. Please check the article Rendering-service on Windows or Rendering-service on Linux accordingly. For installations using PDF renderer, please consult the article Rendering-service 4.5 with priint:pdf renderer Setup Guide for Ubuntu 22.04.3 LTS.
update using the updater of version 4.5

Upgrade from 4.4.0

Please follow the below steps:

Please clean up the following directories: glassfish\payara5\glassfish\domains\pubserver\generated, glassfish\payara5\glassfish\domains\pubserver\osgi-cache, glassfish\payara5\glassfish\domains\pubserver\lib\databases
add jdk 17 to the java folder of your PubServer. The directory of the JDK 17 should have the name jdk. If needed, please check the base package for version 4.5 to find JDK 17 (folder java/jdk).
Check your domain.xml and add the following jvm-options:

<jvm-options>[17|]--add-exports=java.base/sun.net.www=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-exports=java.base/sun.security.util=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang.invoke=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.desktop/java.beans=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-exports=jdk.naming.dns/com.sun.jndi.dns=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/java.lang.ref=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/sun.reflect.generics=ALL-UNNAMED</jvm-options>
<jvm-options>[17|]--add-opens=java.base/sun.reflect.generics.repository=ALL-UNNAMED</jvm-options>

if needed, install priint-bpm. Please check the article priint-bpm on Linux or priint-bpm on Windows accordingly.
if needed, install rendering-service. Please check the article Rendering-service on Windows or Rendering-service on Linux accordingly. For installations using PDF renderer, please consult the article Rendering-service 4.5 with priint:pdf renderer Setup Guide for Ubuntu 22.04.3 LTS.
update using the updater of version 4.5

Migration to version 4.5 with object storage

If you want to use MinIO as an object storage for your PubServer, please consult the following documents: