How to Upgrade to EF Portal from EnginFrame

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

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

In case you plan to use the EF HPC Portal to finish the upgrade please execute the following steps:

  • Download 2 EF HPC Portal services: EFP-Services-for-Upgrade.zip
  • Unzip the zip: unzip EFP-Services-forUpgrade.zip
  • Install the 2 services into the EF HPC Portal (Log in as EF Admin -> HPC Workspace -> Admin View -> Services -> Import)

After the installation and publishing the DD Upload Support service the new services should be visible similar to this:

The JobHist Support in EF Portal is presently not installed during an upgrade so you can follow these steps to enable it:

# cd into the Tomcat directory of EnginFrame similar to below depending on your paths:
cd /opt/nice/enginframe/conf/tomcat/webapps/ROOT
wget https://www.ni-sp.com/wp-content/uploads/2019/10/EFP-Download/EFP-JobHist.zip
umask 022   # in case needed to have proper read permissions
unzip EFP-JobHist.zip

You can then open the “Job History” service in the Applications Admin section, click the Submit button, configure the DB access password in the “Configuration” and “Test Run” the service.

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.