eCase Upgrade Manual

Prev Next

1 Introduction

1.1 Scope

The purpose of this manual is to provide instructions to upgrade eCASE and the eCASE database on the application server. Information presented in this document expects the following:

  • Windows Server 2016 R2/2019 installed on the server.

  • Microsoft .NET Framework 4.8 installed on the server.

  • Previous version of eCASE installed and configured on the server.

NOTE: This document does not provide instructions on how to install Windows 2016 R2/2019 Server.

For further details concerning Microsoft .NET Framework installation, consult the Windows 2016 R2/2019 Server installation materials or your software vendor.

1.2 Overview

Upgrades may include fixes to issues reported by users and/or enhancements initiated by developers or customers to improve the performance of the application. This manual is designed to assist users in upgrading to eCASE Platform.

1.3 References

The following resources were used as references in the preparation of this document:

  • eCASE System Requirements Manual

  • eCASE Application Installation Manual

2 Getting Started

Before proceeding with the installation, it is necessary to create an account to install and configure the eCASE application.

NOTE: The account previously used to install eCASE can be used for this installation.

Make sure to install the upgrade on the application server.

2.1 eCASE SQL Server Upgrade

Prior to upgrading the eCASE application, you must first upgrade the eCASE SQL server database for use with the most recent version of the eCASE.

Follow these steps to upgrade the SQL Server:

  1. Double-click the Server folders.

  2. Locate and right-click the Setup.exe file and select Run as administrator to launch the setup wizard.

  3. Click Configuration > Create eCASE Database > SQL Server.

eCASE configuration screen showing options to create and manage the database.

 

  1. Select upgrade eCASE database from previous version to v11.2.0 and then click Continue.  (!!) Note: To avoid manual selection of the license key file, make sure the license key file is in the same folder as the SETUP.EXE file.

  2. A warning message appears. Click Yes to proceed with upgrading the database, or click Cancel to back up the database before performing an upgrade.

  3. Enter the required information outlined in the following table, then click Upgrade.

Field Name

Description

Server Name

The name of the database server.

Database Name

The name of the database provided during the creation process.

Login ID

The unique identifier for the user having access to the eCASE database. This is the user with the dbcreator and securityadmin privileges.

Field Name

Description

Password

The security credential associated with the user to gain access to the database.

NOTE: Enabling windows authentication disables the login id and password fields.

Database upgrade interface showing server and database details with login credentials fields.

  1. Click Yes on the verification message to upgrade the database to the current version.

  2. The eCASE Database Upgrade window changes to display the status of the upgrade in progress.

Database upgrade interface showing server and database details with progress status.

 

  1. Once the upgrade is completed, a confirmation message appears. Click OK to close the confirmation message.

3 eCASE Application Upgrade

This section provides instructions on how to upgrade the eCASE application to the latest version.  

NOTE: To upgrade from the older 32-bit version of eCASE to eCASE 64 Bit, the current eCASE installed in the application server must be completely uninstalled to successfully upgrade to the new 64-bit version.

  1. Double-click the Server folders.

  2. Locate and right-click the Setup.exe file and select Run as administrator to launch the setup wizard.

  3. Click Installation > Install eCASE Application.

Installation options for eCase application and components displayed on the screen.

 

  1. Select Upgrade eCASE application radio button and click Continue.

  2. Provide the backup location and click Upgrade. If Add-on features are installed, the respective check boxes will be enabled for upgrade.

eCase application upgrade interface showing installed and backup location fields.

 

  1. Click Yes on the confirmation page. The eCASE application upgrade process will be started.

eCase application upgrade window showing installation and backup location fields with progress bar.

 

  1. An eCASE application upgrade successful message will display. Click OK.

4 eCASE Portal Database Upgrade

This section provides instructions on how to upgrade to the latest version of eCASE. To do this, the current eCASE installed in the application server must be completely uninstalled to successfully upgrade to the new version.

  1. From the eCASE Portal setup, right-click Setup.exe and select Run as Administrator.  

  2. The installation wizard opens.

Installation options for eCase Portal, including database creation and application installation.

 

  1. Click on Create eCASE Portal Database.

  2. Select SQL Server.  

4.1 eCASE Portal Database Upgrade

  1. Select Upgrade eCASE Portal database and click Continue.

  2. In the eCASE Portal Database Upgrade dialog box, do the following:

    1. Type the server name in the Server Name box.

    2. Under Database Name, provide Database Name to be upgraded.

    3. Type your SQL Server login ID in the Login ID box, and then type password in the Password box.

  3. The SQL Server Login ID is required to have permissions to update database for eCASE Portal.

Database upgrade interface requiring server and login details for eCase Portal.

 

  1. Click Upgrade.

5 eCASE Portal Application Upgrade

This section provides instructions on how to upgrade the eCASE Portal to the latest version. To do this, the current eCASE Portal installed in the application server must be completely uninstalled.

  1. In the application server where eCASE Portal is installed, uninstall under the Programs and Features.

 

Programs and features window showing installed software and their details on Windows.

  1. Once the eCASE Portal has been completely uninstalled, please refer to the Portal Installation Manual to successfully install eCASE Portal 11.2.0 as shown below.  

 

Help menu displaying various installation manuals for eCASE software.

6 Retrieve a Log File

A log file records all actions performed during the installation, upgrade, or uninstallation of eCASE and its associated components. This log file is accessible to users in the event an error or problem occurs during or after an install, upgrade, or uninstall process.

  1. Navigate to the c:\ drive.

  2. Double-click Users > User Id > AppData > Roaming.

  3. Open and view the appropriate log file outlined in the table below.

  4. The User ID corresponds with the Login ID used to access the application server such as Administrator or JSmith.

  5. You may need to configure Windows Explorer to view the APPDATA and ROAMING folders. Click Start > Computer.

  6. Click Organize > Folder and Search Options.  

  7. Click the View tab.

  8. Select Show Hidden Files, Folders and Drives.

  9. Click OK.

File Name

Description

CREATEDB_LOG

This file details actions and errors occurred during the creation of the database.

UPDATEDB_LOG

This file details actions and errors occurred during the database upgrade process.

UPGRADEAPP_LOG

This file details actions and errors occurred during the application upgrade process.

File explorer window showing various folders and files in the Roaming directory.