How to Upgrade to EF Portal from EnginFrame

This guide shows the steps which enable a smooth upgrade from EnginFrame to EF Portal.

Option 1: Upgrade of EnginFrame to EF Portal (Recommended)

Follow the standard upgrade procedure by installing EF Portal in the EnginFrame installation. Please backup the EnginFrame installation before upgrading to EF Portal.

Execute the EF Portal installer and follow the steps so EF Portal can perform an upgrade. Existing services in the former EnginFrame installation will be visible in the new EF Portal installation as well.

EFP should recognize the upgrade in case you have a former efinstall.config file available. If not you can export the relevant services from the EnginFrame installation and upload in the new EF Portal installation via the Service Manager in the Admin Section.

Option 2: Install EF Portal and apply EnginFrame Configuration

In this procedure we copy the relevant configuration from the existing EnginFrame installation and apply it to the new EF Portal installation.

Please execute the steps described below step by step:

#
# Identify the latest changes in the EnginFrame installation
#
# Go to the EnginFrame installation directory, example below
cd /opt/nice/enginframe/
# Run find and exclude a number of directories with data
find . -type f -not -path '*/sessions/*'  -not -path '*/tmp/*'   -not -path '*/EnginFrameDB/*'  \
   -not -path '*/repository/*'  -not -path '*/spoolers/*' -not -path '*/logs/*' \
   -printf '%T+ %p\n' | sort -r | less
# Typically the changes will be in data/plugins or the conf directories
# Please review the changes which have been made

#
# Collect EnginFrame configuration files
#
tar zcvf /tmp/EF.conf.tgz --exclude='conf/tomcat' --exclude='conf/derby' --exclude=conf/enginframe/certs \
    conf/ 20??.0-r*/*/conf data/plugins

#
# Apply configuration to EF Portal
#
# Go to the EF Portal installation directory, example below
cd /opt/nisp/enginframe
# Save the former EF Portal configuration
tar zcvf /tmp/EF-Portal.conf.tgz --exclude='conf/tomcat' --exclude='conf/derby' \
   --exclude=conf/enginframe/certs conf/ 20??.0-r*/*/conf data/plugins
# Extract the EnginFrame configuration (shown via echo to not overwrite; when you are sure about the 
#  extraction location please run the command
echo tar zxvf /tmp/EF.conf.tgz

Any questions just let us know.