Configure new features

Some new features need to be configured.

Fix pack 8.2.0.4

Upgrade from Apache Log4j 1 to Apache Log4j 2
When you install fix pack 8.2.0.4, OpenPages® upgrades from Apache Log4j 1 to Apache Log4j 2.

This upgrade changes logging, and affects logging properties files, JSP loggers, and other custom code.

Logging properties files are updated as follows:

  • The log4j.properties file is replaced with a log4j2.properties file.
    The log4js.properties file exists for the following tools:
    • For global search, the log tile is in the <OPSearch_Home>/opsearchtools directory.
    • For client tools, the log file is in <client-tools-dir>/bin, where <client-tools-dir>/bin is either <OP_HOME> or the directory into which the client tools are installed on a remote client.
    • For Environment Comparison, the log file is in the <OP_HOME>/aurora/bin/compare_environments directory.
  • The auroralogging.properties file is updated.
  • The ObjectManagerLogging.properties is removed and the logging for ObjectManager is now defined in the log4j2.properties file for client tools.

When you install the fix pack, the installation server automatically backs up these files for you. The backup files that the installation server creates are stored on each server in your deployment in the <server_home>/installer/maintenance/fix-pack-<version>/backups_from_<previous-version> directory.

For information about fixing JSP loggers and other custom code if they fail after installing fix pack 8.2.0.4, see Custom code and JSP helpers may fail after installing OpenPages 8.2.0.4 or later.

Fix pack 8.2.0.3

New application permission for the Bulk Update feature
The behavior of the Bulk Update feature in grid views has changed. The feature is now available only on fields that are enabled for bulk updates. Due to this change, a new application permission is now available: SOX > Administration > Bulk Update All Fields. This permission enables administrators to use Bulk Update on all fields in a grid view, regardless of whether bulk update is enabled on the fields.
By default, all fields are disabled for Bulk Update in 8.2.0.3. Administrators must use the View Designer and update existing grid views to enable fields that are available for bulk update.
New application permissions for FastMap in the Task Focused UI
The way FastMap works in the Task Focused UI is now different than the way it works in the Standard UI. In the Standard UI, FastMap uses a JSP report and access control is handled by the Reporting folder. New application permissions are needed because the Task Focused UI doesn't use a JSP report. This means that users who used to be able to access FastMap can't access it in the Task Focused UI unless an administrator sets the application permissions for them.

To import object data and to see their import history, a user needs the application permission All Permissions > SOX > Administration > FastMap > Import.

To view imports performed by other users, a user needs the application permission All Permissions > SOX > Administration > FastMap > View all history.

Fix pack 8.2.0.2

Themes
If you want to configure custom themes, you need to add the SOX > Administration > Solutions permission to your role template.

For more information, see Themes.

Creating and modifying JSP system files
Access to system files in the /Reports folder has changed. By default, only super administrators and members of the OPAdministrator group can now create or modify the JSP report system files in the /Reports folder under Settings menu > System Configuration > System Files.

Previously, all users with the Report object type in their profile had access. In general, users should not change .jsp files. These files contain source code for executables that could impact the stability and security of the system if the files are not managed correctly.

For more information, see Adding and modifying system files.

User name display format
The default value for the user name format application text (com.display.name.format) has changed to %FN; %LN; - %EM (first name, last name, email).

Previously, the default value was %NM; (user name).

For more information, see Modifying the user name format.

Fix pack 8.2.0.1

IBM Watson® Language Translator
If you want to use IBM Watson Language Translator, update role template with these new application permissions
  • Watson™ Language Translation
  • Watson Language Translation UI
Integration with Microsoft Office
If you want to allow users to open and edit Microsoft Office files directly from OpenPages, ensure that Microsoft Office 2016 or Microsoft 365 is installed on their computers.

Also, if the OpenPages application server is using a self-signed certificate, users must import the certificate into the trust store on their local computers.

Cross-track links
The script that is used for cross-track links in reports has changed. If you have custom reports that use cross-track links, update the reports with the new script.
For more information, see the following topics: