Update verinice.PRO

verinice.PRO is delivered in multiple RPM packages for Red Hat Enterprise Linux (RHEL) and CentOS. On RHEL and CentOS RPM packages are installed, updated or deleted with the package management system YUM. When a new version of verinice.PRO is published, the new RPM packages are ready in the verinice.PRO repository: update.verinice.com.

Preparations

The verinice.PRO database has to be saved before starting the update. If PostgreSQL is used, the following command should be use

 

postgres@v.PRO:~$ pg_dump -F c -Upostgres <db_name> > /path/to/file.sql

The following command restores the created database backup, e.g. as a new database

 

postgres@v.PRO:~$ pg_restore -d newdatabase file.sql

When creating the database, please remember to assign the user "verinice" as owner to the database

 

postgres@v.PRO:~$ createdb -O verinice verinicedb

Don't forget to change the entry for the new database, if another name was used instead of verinicedb, in the /usr/share/tomcat6/webapps/veriniceserver/WEB-INF/veriniceserver-plain.properties.

Update

The verinice.PRO packages are now ready to be updated. You can either update all RPMs on the server or only the verinice packages. It is recommended to update all packages. All packages will be updated with

 

yum update

The following command updates the verinice.PRO packages only

 

yum update verinicepro verinicepro-catalogs verinicepro-clients \
verinicepro-portal verinicepro-update-repo

It may happen that yum does not find the new verinice packages. If no new packages are found, although a new version is ready, the following command must be entered before the update

 

yum clean all

The Tomcat Application Server has to be restarted after an update

 

/etc/init.d/tomcat6 restart

Adjusting the configuration

After updating the packages the verinice configuration must be checked. Each update of the RPM packages can cause conflicts with the configuration files. If a regular file changes in a new version, it is overwritten by the package manager for the update. Configuration files can not be treated like regular files since they are usually changed after the first installation.

If a configuration file has been changed by the user and is changed in a new verinice version, the file cannot be overwritten when updating. There are two options how the package manager computes this issue:

  1. The file of the user is not changed, the new version of the file is installed with the suffix .rpmnew. The files must be compared after the update and possible changes from conf-file.properties.rpmnew must be transfered to conf-file.properties.

  2. The new version of the file is installed. The file of the user is saved with the suffix .rpmsave. The files must be compared after the update and if necessary settings from conf-file.properties.rpmsave must be transfered to conf-file.properties

Depending on the content of the verinice configuration files will be treated in accordance with option 1 or 2.

veriniceserver-plain.properties

  • Directory: /usr/share/tomcat6/webapps/veriniceserver/WEB-INF/

The file is not overwritten during the update. If necessary, a new version of the file is created with the name veriniceserver-plain.properties.rpmnew. In this case new options from veriniceserver-plain.properties.rpmnew must be taken over into veriniceserver-plain.properties.

verinice-ldap.properties

  • Directory: /usr/share/tomcat6/webapps/veriniceserver/WEB-INF/

The file is not overwritten during the update. If necessary, a new version of the file is created with the name verinice-ldap.properties.rpmnew. In this case new options from verinice-ldap.properties.rpmnew need to be transferred to verinice-ldap.properties.properties.

SNCA.xml, snca-messages.properties, snca-messages_de.properties

  • Directory: /usr/share/tomcat6/webapps/veriniceserver/WEB-INF/

This file  is not overwritten during the update. If necessary, a new version of the file is created with the name SNCA.xml.rpmnew. In this case new options from SNCA.xml.rpmnew need to be transferred to SNCA.xml.

web.xml

  • Directory: /usr/share/tomcat6/webapps/veriniceserver/WEB-INF/

This file will be overwritten during the update. If the file was changed beforehand, the changed version will be saved as web.xml.rpmsave. After the update the changes in web.xml.rpmsave must be transfered to the new version.

verinice-auth.xml

  • Directory: /usr/share/tomcat6/webapps/veriniceserver/WEB-INF/

This file contains the configuration of the authorization profiles. The authorization profiles are typically configured with the verinice.PRO client. The file shouldn't be edited directly on the server. The file is not overwritten when updating verinice.PRO. If necessary, a new version of the file is created as verinice-auth.xml.rpmnew. In this case, changes from verinice-auth.xml.rpmnew must be included in verinice-auth.xml.

Other Files

All other configuration files contain technical configuration and normally do not need to be adjusted. When updating these files will be overwritten. If one of the files was however changed previously, the changed old version of the file is saved under the name file.properties.rpmsave . After the update, the changes from the old modified file datei.properties.rpmsave must be included in the new version.

  • Directory: /usr/share/tomcat6/webapps/veriniceserver/WEB-INF

    • faces-config.xml
    • veriniceserver-osgi.properties
    • verinice-auth-default.xml
    • verinice-auth-messages.properties
    • verinice-auth-messages_de.properties

  • /usr/share/tomcat6/webapps/veriniceserver/snca-includes

    • configuration.xml

  • /usr/share/tomcat6/webapps/veriniceserver/WEB-INF/classes

    • log4j.xml
    • server_hibernate.cfg.xml
    • server_hibernate_derby.cfg.xml
    • server_hibernate_oracle.cfg.xml

 

 


English languageDeutsche SpracheLingua italiana
© SerNet GmbH, 2018