Before upgrading, you must update the environment
files, back up and update the application servers, and back up and upgrade
the databases for your deployment. Also ensure that you have upgraded your
metadata model. For more information about upgrading models, see the NexJ Studio Developer
Guide.
NexJ
strongly recommends clearing or truncating the NJSession table for any
upgrade that requires a reseed. Doing so preserves client user
states.
As a best practice, NexJ also recommends that you upgrade the
Push Redirector to match your application framework version when you upgrade
the application.
Note: As a result of supporting standards mode, the NexJ Studio
Plugin for the 8.7 and later releases, which is the
com.nexjsystems.nexjstudio ZIP file, is not backwards compatible with NexJ CRM 8.6 UI
metadata. The plugin for the 8.8 release, however, is backwards compatible
with the 8.7 release.
To upgrade to NexJ CRM version
8.8:
-
If you run the application server in a Linux environment, you
must add the Arial font, which is required by predefined reports. For
more information, see Installing the Arial font in Linux environments.
-
If you are upgrading from any of the following versions, you must
perform upgrade steps specific to that version:
-
Update the environment file or the connections file to remove old
or deprecated connections. For more information, see Removing obsolete connections for version 8.8.
-
Update the environment file or the connections file with new data
source connections, channel connections, and SOA connections. For more
information, see Adding new connections for version 8.8.
-
Update the environment file or the server and connections files
with other changes required to support new functionality. For more
information, see Updating server information for version 8.8.
-
Back up application server files.
-
Back up all databases.
-
If you are upgrading from any of the following versions, you must
perform upgrade steps specific to that version:
-
Upgrade all databases. For more information, see Upgrading data sources for version 8.8.
-
Upgrade the application servers.
-
If you previously created anonymous NexJ user and want to now use
the default user with no privileges instead, edit the appropriate
security setting in your environment file.
Note: In NexJ CRM
versions prior to 8.8, creating an anonymous NexJ user was required to
synchronize NexJ CRM
with Microsoft Exchange Server. Starting NexJ CRM
version 8.8, this is no longer required.
To use the default functionality for anonymous requests:
-
In NexJ Studio, open
the .server or .environment file.
-
In the Overview tab, click the
Security subtab.
-
In the Anonymous User field, ensure
that there is no user name specified.
-
Save and close the .server or .environment file.
-
If you are upgrading from an installation of NexJ CRM
that does not support rich text for document notes in Document Manager
and you want to enable this feature, run the
BatchUpdatePlainConvertToHTMLCommand -
updateTextField batch file to enable the rich text feature.
For more information, see Enabling rich text support.
-
Deploy the application.
-
Start the application and verify that it has deployed
successfully.