On-Premise Upgrade Utility

System Location: Help > About JobBOSS2

The Upgrade Utility is only used by customers who have the software installed on their premises to provide their JobBOSS2 product with the most recent upgrades. In order to properly run the Upgrade utility, you must be on the web server, locally, where JobBOSS2 is installed. If you wish to view the release notes before upgrading yourJobBOSS2 site, you can view them by viewing the New Stuff page.

On-premises installations are required to install and configure RabbitMQ software as part of this upgrade to support the Asynchronous Reporting feature. Watch this video to learn more about Asynchronous Reporting.

The JobBOSS2 Upgrade Utility does make changes to the system. As with any system change, Support highly recommends creating full backups of your JobBOSS2 SQL Server databases, including the JobBOSS2 Master database, before running the utility.

During the upgrade time, your JobBOSS2 site will be unavailable. Schedule this maintenance with your end-users, and plan for the downtime.

From the web server, login to JobBOSS2 and complete the following steps:

  1. Go to the purple Help button in the top right of the screen, and select About JobBOSS2 from the dropdown menu.

  2. Click on Update Available - Download JobBOSS2 version 20XX.X-X-Rel.X above the General Information section.
    • If there is no available update, you will not see the Update Available hyperlink.

  3. Once the download has completed, click the downloaded file to open the JobBOSS2 Upgrade.
  4. Click Next on the Upgrade Welcome screen.

  1. An upgrade warning box opens. If you are upgrading from JobBOSS2 version 2022.8.5+361 or earlier, read the information about the upgrade and click Yes to continue. Contact Customer Support for additional information and with any questions.

  2. A RabbitMQ Requirements information box opens. Click Next to install or Skip if already installed.

  3. Enter in the report notification settings for your environment in the RabbitMQ Configuration box:

    Note:The information in this box is auto populated. ECI does not recommend editing this info. If you must change the password, please log any changes in your password manager or in a file to retrieve later. You will need this information for Step #16.

  4. Select a folder to store all of the JobBOSS2 upgrade report files:

    Note:ECI recommends selecting a folder in your document repository location.

  5. Select the Virtual Folder where JobBOSS2 was installed and click Next.

  1. The Processing screen opens, showing the progress of the upgrade installation.

  2. Click Next on the Final Confirmation screen.

  1. Click Finish to complete the update.

    Asynchronous Service Installation

  2. The install Wizard for the JobBOSS2 Asynchronous Service Setup automatically opens. Click Next to continue:

  3. The License Agreement opens. Check the agreement box to accept the terms and then click the Next.

  4. The SQL Server Configuration box opens. Choose the SQL Server installation to use for the JobBOSS2 Asynchronous Service and then click Next:

    Note: Please enter your SQL Server instance, The Master DB Name is auto populated. If it is empty, then enter the appropriate database name in the field.

    Please verify with your IT Admin if your SQL Server edition is compatible (2014 or higher).

  5. Enter the RabbitMQ settings for your environment:

    Note: The information in this box is auto populated. If you changed your password in Step #7, please use the same password in this box for the RabbitMQ password, Also, if the Report Notify URL is not populated, please confirm in IIS Manager the name of your JobBOSS2 website. The name will be either E2 Shop or JobBOSS2.

  6. Select the folder to store all of the report files generated by the asynchronous service:

    Note:ECI recommends selecting a folder in your document repository location.

  7. The Final Confirmation screen opens. Click Next to start the installation.

  8. Once finished, the Installation Complete box opens when the JobBOSS2 Asynchronous Service has been successfully installed. Click Finish to end the process.

If you have any questions throughout the upgrade process, please contact our Customer Support team at 800-677-9640 or visit the Customer Portal to chat with a member of the customer support team or to create a case.

Modifying the JobBOSS2 Asynchronous Service Configuration File

To complete the installation of the latest on-premises update you will need to modify the JobBoss2 Asynchronous Service’s configuration file:

  1. From theJobBOSS2 IIS server navigate to C:\inetpub\wwwroot\jobboss2\ folder and open the E2Shop.Web.dll.config file.

    Note: This directory may be named E2Shop depending on installation date.

  2. Locate the FileUploadPath key and copy the value field. This value should look like: C:\JobBoss2 Repo. Make note of this directory path for Step 5.

  3. Navigate to the Windows Start Menu and enter Notepad. Right click on the Notepad Best Match and select Run as Administrator. This allows us to modify the Async Service’s configuration file without adjusting file permissions. Within Notepad select File > Open and navigate to the C:\Program Files\JobBOSS2 Asynchronous Service\ folder. Within the Notepad window, select the Text documents (*.txt) dropdown and change it to All Files.

  4. Within the same directory locate the E2Shop.AsyncService.dll.config file and double click it to open.

  5. With this configuration file open locate the FileUploadPath key and enter the value from Step 2.

  6. Within Notepad select File > Save.

  7. On the JobBOSS2 IIS server, navigate to Services (Start Menu > Search > Services) and locate the JobBOSS2 Asynchronous Service, select restart.