Preparation
Update the application server
In case of update from eRecruiter v1.x to v2.x, the following packages must be updated at the application server:
- .NET Framework 4.7.1
To ensure full functionality the eRecruiter should have permanent internet access.
Update announcement
Because the update process takes a longer time the update window should be communicated to the users. Normally a time window of about 1 hour should be expected. The actual duration depends on the experience of eRecruiter update procedure and the actual version. Furthermore, users should be informed about changes in the new /wiki/spaces/ERECRUITER/pages/262730.
System backup
Before upgrade to a new eRecruiter version a backup of the system (database and binary installation) must be carried out, since it is not possible to undo the upgrade using the installation routine. Before backing up the system should be taken offline, so no changes are performed after backup.
Prepare the update
The link for installation package download will be provided by the eRecruiter consultant or support upon request as it will ensure that the correct version is available including any customizations for the installation.
Windows Security
If the download is performed through Microsoft Internet Explorer, the browser will mark the ZIP package as downloaded from the internet. This will require to unblock the file to ensure the application will work properly after unzipping the package.
After unblocking the file the content of the package should be checked for completeness. It should include the following folders and files - there may be a base folder called eRecruiter in the package.
| Application | Package Folder | Target Folder | Type | Description |
|---|---|---|---|---|
| API | API | <ERECRUITER_INSTALL_DIR>\bin\API | IIS/ASP.NET application | eRecruiter API for integrations and applicant portals. |
| Applicant Portal | ApplicantPortal | <ERECRUITER_INSTALL_DIR>\bin\ApplicantPortal | IIS/ASP.NET application | Applicant portal for job listings and applicant self-service zone. |
| Cron Worker | CronWorker | <ERECRUITER_INSTALL_DIR>\bin\CronWorker | Windows Scheduler Task | Background worker that is executed every 15 minutes to perform maintenance tasks. |
| Customer Portal | CustomerPortal | <ERECRUITER_INSTALL_DIR>\bin\CustomerPortal | IIS/ASP.NET application | Portal for internal customers that use the recruiting department as internal service. |
| eRecruiter | eRecruiter | <ERECRUITER_INSTALL_DIR>\bin\eRecruiter | IIS/ASP.NET application | eRecruiter application for recruiting department |
Document Analysis Service NEW SINCE 2.24 | DocumentAnalysis | <ERECRUITER_INSTALL_DIR>\bin\DocumentAnalysis | IIS/ASP.NET application | CvParsing API for extraction of applicant data of Cv's |
| Media Service | FileServer | <ERECRUITER_INSTALL_DIR>\bin\MediaService | Windows Service | Service to convert between different media types. |
| Portal | Portal | <ERECRUITER_INSTALL_DIR>\bin\Portal | IIS/ASP.NET application | (deprecated) The previous version of the applicant portal that has been deprecated. |
| version-X.Y.Z.BC | - | - | - | This files indicates the application version for the package. |
Be aware that when upgrading from a Version below 2.24 the new Document Analysis Service has to be installed and configured. /wiki/spaces/ERECRUITER/pages/262688
Performing the update
Disabling eRecruiter installation
To perform a smooth update the eRecruiter and all components must be disabled.Therefor the IIS and the eRecruiter Media Service must be stopped, this is done by the following 2 PowerShell commands:
Stop-Service W3SVC Stop-Service eR-MediaService
Delete existings application files
Before the new application files can be copied from the update package to the server, all existing application files need to be deleted. For a pure overwriting the application files might result in version conflicts.
Erase the content (with the ecxeption of AppSettings.config und ConnectionsStrings.config - they include server-specific settings, which can not be recovered from the update package) of each affected application directory on the server but not the directories themselves, otherwise security or IIS settings are lost. All other files and subdirectories will be deleted.
Copy new application files
From the update package, the application files now needs to be copied in the associated application directories.
If there were manual changes in any application (as example entries in the Web.config file), these must be restored after update.
Restart eRecruiter installation
The eRecruiter Media Service and the IIS must be started after the update, this can be done by the following 2 PowerShell commands:
Start-Service eR-MediaService Start-Service eR-FileServer
Database migration
When opening the eRecruiter URL in a browser, the database is automatically checked and necessary migrations are automatically carried out - this can take up to 30 minutes to complete.
The database migration starts automatically after openening the eRecruiter-URL
Testing
After the update process has finished, the eRecruiter application should be tested to ensure full functionality.
- Open the eRecruiter application in the browser and login.
- Perform simple navigation through the application.
- Create a PDF from the workspace page by clicking the cog icon and selecting the option.
- Open the eRecruiter Customer Portal application in the browser.
- Open the eRecruiter API application in the browser.
- Open the eRecruiter Applicant Portal application in the browser.
- Open a job ad and verify the content of the page.
- Try to apply to a job ad