IBM Support

Web Reports Server Migration Procedure

Technote (FAQ)


Question

How to migrate Web Reports Server to a new server machine?

Answer

The steps for Web Reports server migration are as follows:
Windows Server

  1. Stop the BESWebReportsServer service on the old Web Reports Server
  2. Detach and attach the BESReporting DB to the new SQL Server
  3. Copy over the WRs-specific folders (if they contain anything):
    ** [BigFix Server folder]\BESReportsData\ArchiveData
    ** [BigFix Server folder]\BESReportsServer\wwwroot\ReportFiles
  4. Add back any custom WRs settings in the registry, the ones that start with _WebReports
  5. If you defined AD users in WRs prior to version 9.1, then set "UseLegacyADLogin" to 1 in HKLM\Software\BigFix\Enterprise Server\BESReports.
  6. Install Web Reports
Linux Server
  1. Stop the beswebreports service on the old Web Reports Server
  2. Detach and attach the BESReporting DB to the new DB Server
  3. Copy over the WRs-specific folders (if they contain anything):
    ** /var/opt/BESServer/BESReportsData/ArchiveData
    ** /var/opt/BESServer/BESReportsServer/wwwroot/ReportFiles
  4. Add back any custom WRs settings in the beswebreports.config file located at /var/opt/BESWebReportsServer/.
  5. If you defined AD users in WRs prior to version 9.1, then set "UseLegacyADLogin" to 1 in [Software\BigFix\Enterprise Server\BESReports] in /var/opt/BESWebReportsServer/beswebreports.config configuration file.
  6. Install Web Reports

Note:
  • If the SQL/DB Server doesn't change, Step 1 and 2 is not required,
  • In particular, if you upgraded the pre-existing environment starting from a version older than 9.1, verify if the setting UseLegacyADLogin has been set to 1. (This way the old authentication method will be used. See Step 5.)

Document information

More support for: IBM BigFix Platform
Web Reports

Software version: 9.5

Operating system(s): Platform Independent

Software edition: Edition Independent

Reference #: 2008700

Modified date: 17 November 2017