UnifiedViews Upgrade Guide

. Prerequisites

These instructions assume that you will upgrade UnifiedViews while:

You have downloaded the UnifiedViews installer (UnifiedViews.run) from our download area.
The target system is running on a 64 bit Linux server and and meets the UnifiedViews System Requirements.
UnifiedViews' Tomcat will be running as localhost using port 8081.
If you want to upgrade the DPUs during the installation, you have defined a user (for example 'admin') on the server assigned to a respective group (for example 'admin') that should be used to run the Tomcat server. That user has to be able to execute the sudo command. Refer to the respective Linux distribution's documentation for the particulars of commands and permission settings.

Procedure. Upgrade UnifiedViews Together with the DPUs

Note

We recommend upgrading UnifiedViews together with the DPUs. You need to know the credentials of the user that will be used to run the Tomcat server for that.

Custom DPUs are excluded from the upgrade.

This will install UnifiedViews 9.0.2 on your computer.
OK [o, Enter], Cancel [c]
>
 
Choose the appropriate option:
Install UnifiedViews [1, Enter],
Upgrade an existing UnifiedViews installation [2],
Cancel installation [c]
> 2

Enter installation directory:
[/opt/unifiedviews]
>
  
UnifiedViews Upgrade was successful. Upgrading DPUs requires credentials.
Do you want to upgrade them now?
Type YES if you want to.
[NO]
> YES
Migrating DPUs...
What port is used by tomcat/unifiedviews
[80]
>
What username shall be used to migrate dpus
[admin]
>
Please enter password for user: admin
---------------------------------------------------------------------
Installing DPUs..
..target instance: http://localhost:80/master/api/1
---------------------------------------------------------------------
Waiting for Web service to be set online
..installing /opt/unifiedviews/unifiedviews/plugins/t-batchLinkingDbpedia-2.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-e-filesDownload-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-e-gdrive-2.1.1.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-e-httpRequest-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-e-relationalFromSql-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-e-silkLinker-5.0.1.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-e-sparqlEndpoint-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-l-filesToVirtuoso-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-l-filesUpload-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-l-gdrive-2.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-l-rdfHttpLoader-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-l-rdfToVirtuoso-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-l-relationalToSql-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-q-rdf4jShacl-1.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-q-sparqlAsk-4.0.1.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-contentApiCallPreparator-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-excelToCsv-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-filesFilter-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-filesFindAndReplace-5.1.1.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-filesMerger-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-filesRenamer-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-filesToRdf-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-filterValidXml-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-gunzipper-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-gzipper-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-jsonLd-2.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-jsonToXml-3.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-openCalaisExtractor-3.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-poolpartyConceptExtractor-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-rdfGraphMerger-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-rdfToFiles-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-rdfValidator-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-relational-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-relationalToRdf-4.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-schemaMappingR2Rml-2.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-schemaMappingRml-2.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-sparqlConstruct-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-sparqlSelect-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-sparqlUpdate-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-tabular-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-tabularToRelational-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-TikaToRdf-1.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-unzipper-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-xmlToJson-2.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-xslt-5.0.2.jar: OK
..installing /opt/unifiedviews/unifiedviews/plugins/uv-t-zipper-5.0.2.jar: OK
---------------------------------------------------------------------
DPU installation completed
---------------------------------------------------------------------
Unifiedviews upgrade successfully completed!

Stop the UnifiedViews server.
Run the UniviedViews.run installer from the terminal window.
Press Enter to start the installation process.
Press 2 to select the upgrade mode.
Specify the directory where the UnifiedViews should be installed or confirm the default one with Enter.
Confirm the migration of DPUs by typing YES.
Specify the port where UnifiedViews' Tomcat will be running or confirm the default one with Enter.
Provide the username of the user that will be used to upgrade the DPUs or confirm the default one with Enter.
Provide the user's password.
You have upgraded UnifiedViews together with the standard DPUs.
Start the UnifiedViews server. Open a console and change to root:
```
sudo -i
```
It is important to first start the frontend and then start the backend as follows:
```
/opt/unifiedviews/bin/unifiedviews-frontend start
/opt/unifiedviews/bin/unifiedviews start
```

Procedure. Upgrade UnifiedViews without the DPUs

This will install UnifiedViews 9.0.2 on your computer.
OK [o, Enter], Cancel [c]
>
 
Choose the appropriate option:
Install UnifiedViews [1, Enter],
Upgrade an existing UnifiedViews installation [2],
Cancel installation [c]
> 2
 
Enter installation directory:
[/opt/unifiedviews]
> 
 
UnifiedViews Upgrade was successful. Upgrading DPUs requires credentials.
Do you want to upgrade them now?
Type YES if you want to.
[NO]
>
Unifiedviews upgrade successfully completed!

Stop the UnifiedViews server.
Run the UniviedViews.run installer from the terminal window.
Press Enter to start the installation process.
Press 2 to select the upgrade mode.
Specify the directory where the UnifiedViews should be installed or confirm the default one with Enter.
Press Enter to confirm that you don't want to upgrade the DPUs.
You have upgraded UnifiedViews.
Start the UnifiedViews server. Open a console and change to root:
```
sudo -i
```
It is important to first start the frontend and then start the backend as follows:
```
/opt/unifiedviews/bin/unifiedviews-frontend start
/opt/unifiedviews/bin/unifiedviews start
```
Post-upgrade task: To upgrade the DPUs, make sure that the frontend is running and execute the dpu_migration script.

In this section: