This article describes how to upgrade BrightWork for SharePoint 2016 from a previous version of BrightWork for SharePoint 2016.
Part of this process involves uninstalling the BrightWork solution before installing the newer version. This process does not affect your data or customizations.
At a high-level the sequence of steps are as follows:
Tip! If you have made changes to your BrightWork timer jobs, you should take note of these settings so you will be able to restore them later.
To uninstall BrightWork:
Right-click on the SharePoint 2016 Management Shell and select Run as administrator.
Run this command:
cd "C:\Program Files (x86)\BrightWork\16\Install Files"
Run this command:
.\UnInstallSolution.ps1 BrightWork.wsp
When the "Solution BrightWork.wsp is now removed" message displays, close the SharePoint Management Shell.
Note: If you experience a long delay, seeing Deployment Status: Scheduled, it may relate to a known issue with timer jobs. See this Microsoft article, Administrative Timer Jobs not running after upgrade, for details. This article also applies to later versions of SharePoint.
Note: If installing BrightWork in an environment with SharePoint side-by-side upgrade functionality enabled, follow these steps:
Install-SPApplicationContent
, run Copy-SPSideBySideFiles
on all servers.Run this command to change to the install files folder:
cd "C:\Program Files (x86)\BrightWork\16\Install Files"
Next, run this command:
.\InstallSolution.ps1 "C:\Program Files (x86)\BrightWork\16\Install Files\BrightWork.wsp"
Close the SharePoint Management Shell when "Solution BrightWork.wsp is now installed" displays.
Note: Please ensure you close the SharePoint Management Shell before proceeding with the next step. This ensures that it is running under a different process.
Right-click on the SharePoint 2016 Management Shell, click Run as administrator and run this command:
Install-BWDiagnosticsService
Follow the steps below on all other servers in the farm.
Run the following commands (in sequence) on each front end server the solution has been deployed to:
iisreset
net stop sptimerv4
net start sptimerv4
Install-SPApplicationContent
Run the following command:
Install-BWDiagnosticsService
Ensure you have the correct web application selected and click Manage Features.
Note: The timer job features must be activated on a web application by web application basis.
Click Activate beside the following timer jobs:
If you have previously adjusted your BrightWork Timer Jobs, you need to do so again to reapply your changes.
The main timer jobs should run at least once a day in the following sequence:
Tip! The User Access Report may not be needed very often. It might for instance be needed once a year for a user audit. In this case it is recommended to Disable the timer job when it is not needed and Enable it and select Run Now to create a report on demand.
To ensure projects metrics are up to date, the Project Metrics Refresh can be run as frequent as you like. At BrightWork we run the Project Metrics Refresh every 15 minutes.
Project Schedule Refresh timer job takes place from 12.00am to 12.30am. This is a timer job for a deprecated list. Therefore, if you do not use it, you do not have to use this timer job.
To adjust the timer job schedule:
Note: Running the psconfig command may NOT be required when upgrading to the BrightWork 16.26.1 release. If you are upgrading from BrightWork 16.15 or later, then you do NOT need to run the psconfig command.
If you are upgrading from BrightWork 16.14 or earlier then you DO need to run the psconfig command.
In a multi-server SharePoint farm, psconfig needs to only run once on the Application server.
The SharePoint Products Configuration Wizard (psconfig) is a SharePoint Utility that needs to be run periodically for proper SharePoint maintenance. It is needed in BrightWork to update existing Site Collections with new features added in a release.
Please note that the psconfig utility can highlight issues with the configuration of your SharePoint Server Farm.
To run psconfig:
Next, run the following command to perform a build-to-build upgrade using the SharePoint psconfig.exe utility:
psconfig.exe -cmd upgrade -inplace b2b -force -includesiteupgrade
The below screen should display.
iisreset
and close the window once "Internet services successfully restarted" is displayed.BrightWork should be successfully upgraded.
Note: As of BrightWork 16.0, we no longer ship non-English versions of BrightWork directly. Language translations may be purchased through our partners however. For more information, please see the BrightWork Language Partners. Please contact [email protected] if you have any questions.