About this guide

The guides describes how to upgrade Identity Manger to version 4.8.0. from version 4.7 or older. Additional information is found on PhenixID web site or through PhenixID support.

Audience

This document is primarily written for system administrators with at least some basic Identity Manager skills.

Upgrade

The method to upgrade to PhenixID Identity Manager 4.8.0 is to do a new installation of Identity Manager 4.8.0 in a different path or server from the current installation and then add all previous customizations.

Prerequisite

Installation of 4.8.0

Install PhenixID Identity Manager 4.8.0 by following the installation guide.

Applying older customizations

Important! Depending on your installation the copy and merge of files might not be applicable for your upgrade. If for example you have not been using Themes in your solution, just skip that section.

Classes, filters and custom controls

Copy all the classes sub-folders from the [old installation]\webapps\nordicedge\WEB-INF\classes except Controls and filter to [new installation]\webapps\phenixid\WEB-INF\classes\. (the Controls and Filters shipped in previous versions are now included in neim4.jar file)

Copy the jar-files that are required by customizations (if any) from [old installation]\webapps\nordicedge\WEB-INF\lib to [new installation]\webapps\phenixid\WEB-INF\lib\.

Copy any jsp-files that are required by customizations (if any) from [old installation]\webapps\nordicedge\jsp to [new installation]\webapps\phenixid\jsp\.

Translations (language-files)

Merge the *.lang files from [old installation]\webapps\nordicedge\WEB-INF\NEIDMgmt\language with the newly installed in [new installation]\webapps\phenixid\WEB-INF\NEIDMgmt\language\.

Theme

Merge the themes from [old installation]\webapps\nordicedge\WEB-INF\NEIDMgmt\themes\ with the newly installed in [new installation]\webapps\phenixid\WEB-INF\NEIDMgmt\themes\.

Copy all necessary images from [old installation]\webapps\nordicedge\editor\themes to [new installation]\webapps\nordicedge\editor\themes\.

Disk based Roles – (only Identity Manager 4.6 or later)

Copy the role folder from [old installation]\webapps\nordicedge\WEB-INF\NEIDMgmt to [new installation]\webapps\phenixid\WEB-INF\NEIDMgmt\.

DSEditor.properties

Update [new installation]\webapps\phenixid\WEB-INF\NEIDMgmt\DSEditor.properties with the necessary policy settings from [old installation]\webapps\nordicedge\WEB-INF\NEIDMgmt\DSEditor.properties.

Remove service name

Earlier installations of Identity Manager might have a service name like “Apache Tomcat”. You might want to remove that and use the service name of IM 4.8.0 which is “PhenixID Identity Manager”. This might only apply on Windows installations.