{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This article describes how to upgrade ","type":"text"},{"text":"Smart ID Certificate Manager","type":"text","marks":[{"type":"link","attrs":{"href":"https://nexusdoc.atlassian.net/wiki/spaces/PUB/pages/65346056"}}]},{"text":" to the latest version. For all other upgrade paths, ","type":"text"},{"text":"contact Nexus","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.nexusgroup.com/contact/"}}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Sequential upgrade process","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To upgrade from older versions to newer versions, you must upgrade each version step-by-step. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example: ","type":"text","marks":[{"type":"strong"}]},{"text":"Starting upgrade from 8.9.0, you must upgrade to 8.10 and thereafter to 8.11.0. ","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"8.4.0 was replaced by 8.4.1. For more information, see ","type":"text"},{"text":"Release note Certificate Manager 8.4.1","type":"text","marks":[{"type":"link","attrs":{"href":"https://nexusdoc.atlassian.net/wiki/spaces/PUB/pages/65362782"}}]},{"text":". ","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Certificate Manager is installed. See ","type":"text"},{"text":"Smart ID Certificate Manager","type":"text","marks":[{"type":"link","attrs":{"href":"https://nexusdoc.atlassian.net/wiki/spaces/PUB/pages/65346056"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop the Nexus CIS, CF, and SNMP services. For more information, see ","type":"text"},{"text":"Start Certificate Manager server components","type":"text","marks":[{"type":"link","attrs":{"href":"https://nexusdoc.atlassian.net/wiki/spaces/PUB/pages/65349541"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use the files in the folder ","type":"text"},{"text":"Upgrade/Upgrade from CM x.x.x to x.x.x","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To upgrade from 8.9.0 to 8.11.0, use the files in the following folders in sequence:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade from CM 8.9.x to 8.10.0","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade from CM 8.10.x to 8.11.0","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step-by-step instruction","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1. Upgrade database","type":"text"}]},{"type":"paragraph","content":[{"text":"Database scripts for MSSQL, MySQL, PostgreSQL, Oracle, MariaDB, and AzureSQL are often included in the delivery of Certificate Manager. Some releases do not include database scripts to run due to no updates in the databases. The following applies: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If there are no scripts included in the release bundle, go to the next step in this upgrade instruction (","type":"text"},{"text":"Upgrade Certificate Manager services","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If there are scripts included in the release bundle, run all included scripts. ","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Select version","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Make sure to select the specific script for the upgrade. You must run each DB script from the start version to the target version in sequence.","type":"text"}]},{"type":"paragraph","content":[{"text":"The script examples below displays ","type":"text"},{"text":"x_x_x","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" as a reference to the CM version number that you are upgrading to. ","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Exception: Upgrade from 8.10.0 and earlier","type":"text"}]},{"type":"paragraph","content":[{"text":"Support for MariaDB version below 10.5 has been removed in version 8.10.0 (and later) of Certificate Manager. If you use MariaDB version below 10.5, you must upgrade before you proceed with the steps below. ","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Exception: Upgrade from 7.18.x to 8.0.0","type":"text"}]},{"type":"paragraph","content":[{"text":"Support for the Oracle database version 11g has been removed in version 8.0.0 of Certificate Manager due to EOL. If you use Oracle 11g, you must upgrade before you proceed with the steps below. ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To upgrade the CMDB (Certificate Manager Database), run the appropriate script in the MSSQL Server Management Studio, MySQL client, Oracle SQLPlus, or PostgreSQL client.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that no errors occurred.","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"full-width","width":1755.0,"localId":"113e52b2-5d3a-44d2-8286-4ee44c7f6707"},"marks":[{"type":"fragment","attrs":{"name":"Table 1","localId":"0a6fbd6e-3988-44fa-8aef-7bfd6f7d83cf"}}],"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"Database","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[470.0]},"content":[{"type":"paragraph","content":[{"text":"Script","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1130.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"MSSQL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[470.0]},"content":[{"type":"paragraph","content":[{"text":"database/CMDBUpgrade_MSSQL_x_x_x.sql","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":4,"colwidth":[1130.0]},"content":[{"type":"paragraph","content":[{"text":"The following applies: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If there are no scripts included in the release bundle, go to the next step in this upgrade instruction (","type":"text"},{"text":"Upgrade Certificate Manager services","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If there are scripts included in the release bundle, run all included scripts. ","type":"text"}]}]}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"MySQL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[470.0]},"content":[{"type":"paragraph","content":[{"text":"database/CMDBUpgrade_MySQL_x_x_x.sql","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"Oracle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[470.0]},"content":[{"type":"paragraph","content":[{"text":"database/CMDBUpgrade_Oracle_x_x_x.sql","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"PostgreSQL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[470.0]},"content":[{"type":"paragraph","content":[{"text":"database/CMDBUpgrade_PostgreSQL_x_x_x.sql","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"MariaDB","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[470.0]},"content":[{"type":"paragraph","content":[{"text":"database/CMDBUpgrade_MariaDB_x_x_x.sql","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1130.0]},"content":[{"type":"paragraph"},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"AzureSQL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[470.0]},"content":[{"type":"paragraph","content":[{"text":"database/CMDBUpgrade_AzureSQL_x_x_x.sql","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1130.0]},"content":[{"type":"paragraph"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2. Upgrade Certificate Manager services","type":"text"}]},{"type":"paragraph","content":[{"text":"The Certificate Manager server components are installed and run as services. Do the following steps at the server(s) that runs any of the Nexus CF, Nexus CIS, or Nexus SNMP services. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Final upgrade step - the lib, bin, and tool folders","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The lib, bin, and tool folders should always be postponed until the last step of the upgrade procedure to enable a successful upgrade to the latest version. Starting the system while upgrading may lead to error, such as corrupted data or failure to use the system.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Before you start, make sure to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade the Certificate Manager databases, see step \"1. Upgrade database\".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 7.18.x to 8.0.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the server(s) running the Nexus CF, Nexus CIS, or Nexus SNMP services:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes in ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove the following files from ","type":"text"},{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"requestformats/httpclient.conf","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"http.conf","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The suggested default log levels for CM-SNMP has been reduced from FINEST to INFO. If you use CM-SNMP and want to change to the new default values, change this in the file ","type":"text"},{"text":"/config/snmplog.properties","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The following deprecated modifiers have been replaced or removed. If you use customized format files, make sure that none of the deprecated modifiers are used.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"These deprecated modifiers have been replaced:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SubjectKeyIdAdder > SubjectKeyIdentifierModifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ScepUniqueness > RenewalAllowed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AltNameModifier > SubjectAltNameModifier","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"These deprecated modifiers have been removed:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CheckCertWithSubject","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CisFailoverModifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DynamicValidity","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"InputStringBoundChecker","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MonetaryLimitAttributeModifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PublicKeyHash","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RelativeValidity","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ScepUniqueness","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SubjectIdentifierSs","type":"text"}]}]}]}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Updated license file required","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"CM 8.x requires an updated license file in order to start. License files issued for CM 7.x cannot be used for CM 8.x. Place the updated license file in the directory ","type":"text"},{"text":"/license/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.0.x to 8.1.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the server(s) running the Nexus CF, Nexus CIS or Nexus SNMP services:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes in ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder. ","type":"text"},{"type":"hardBreak"},{"text":"Note the important changes described in the file ","type":"text"},{"text":"changes-formats.txt","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":". The file is located here: ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":". The tool used in ","type":"text"},{"text":"changes-formats.txt","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" requires updated lib files. Therefore those instructions should be executed after the new jar files has been replace in the final upgrade instruction.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From ","type":"text"},{"text":"Upgrade files CM 8.1.0/server/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", add the following files to ","type":"text"},{"text":"/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", or replace if any of these files already exist:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"acme-account-reg-search.conf","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"acme-prereg-search.conf","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"countries.conf","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"device-cert-registration.conf","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"estsecretsearch.conf","type":"text"}]}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.1.x to 8.2.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the server(s) running the Nexus CF, Nexus CIS, or Nexus SNMP services:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes in ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.2.x to 8.3.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the server(s) running the Nexus CF, Nexus CIS or Nexus SNMP services:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes in ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From <","type":"text"},{"text":"Upgrade files CM 8.3.0/server/inputviews>","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", add the following file to ","type":"text"},{"text":"/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"scepdynamicpasswordregsearch.conf","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.3.x to 8.4.1","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of this folder before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes in ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From ","type":"text"},{"text":"Upgrade files CM 8.4.1/server/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", add these files to ","type":"text"},{"text":"/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":":","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"est-auth-cert.conf","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"its-station-registration.conf","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.4.x to 8.5.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes in ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder. ","type":"text"},{"type":"hardBreak"},{"text":"Depending on which 8.4.x version you are currently on, some of the changes may already have been performed as part of an earlier upgrade.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.5.x to 8.6.1","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes in ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Depending on which 8.5.x version you are currently on, some of the changes may already have been performed as part of an earlier upgrade.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ability to manually build CRLs and CILs has been moved from the officer role \"Use AWB\" to its own role in \"Manual build of CRL and CIL\". As such, if you have officers that should be able to perform manual builds of CXLs, then their officer profiles will need to be updated.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.6.x to 8.7.1","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"paragraph","content":[{"text":"When you upgrade CM from 8.6.x to 8.7.1, execute only the database script in the folder \"Upgrade from CM 8.6.x to 8.7.0\" in the release bundle.","type":"text"}]},{"type":"paragraph","content":[{"text":"Do not use the script in the folder \"Upgrade from CM 8.7.0 to 8.7.1\"","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes in ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"From 8.7.0 to 8.7.1","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Important! ","type":"text","marks":[{"type":"strong"}]},{"text":"Certificate Manager version 8.7.0 is no longer available on Nexus support portal.","type":"text"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes on the server(s) running the Nexus CF, Nexus SNMP and Nexus CIS service in: ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" and ","type":"text"},{"text":"/inputviews/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder. ","type":"text"},{"type":"hardBreak"},{"text":"From ","type":"text"},{"text":"Upgrade files CM 8.7.1/server/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", add the following file to ","type":"text"},{"text":"/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"kerberos-pkinit-san.conf","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.7.x to 8.8.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes on the server(s) running the Nexus CF, Nexus SNMP and Nexus CIS service in: ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" and ","type":"text"},{"text":"/inputviews/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder. Depending on which 8.7.x version you are currently on, some of the changes may already have been performed as part of an earlier upgrade.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From ","type":"text"},{"text":"Upgrade files CM 8.9.0/server/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", add the following files to ","type":"text"},{"text":"/inputviews","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" v2x-enroll-enabling-registration.conf","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"kerberos-pkinit-san.conf","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" From ","type":"text"},{"text":"Upgrade files CM 8.9.0/server/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", add the following file to ","type":"text"},{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"rapcacsv2.conf","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Only for upgrades coming from earlier that 8.1.x: Run any steps that may have been postponed in earlier steps, such as those required for \"copycacerts\" when upgrading from CM 7.17.x or those in ","type":"text"},{"text":"changes-format.txt","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" when upgrading from CM 8.0.x.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.8.x to 8.9.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes on the server(s) running the Nexus CF, Nexus SNMP, and Nexus CIS service in: ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.9.x to 8.10.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"},{"type":"hardBreak"},{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes on the server(s) running the Nexus CF, Nexus SNMP, and Nexus CIS service in: ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"From 8.10.x to 8.11.0","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade steps"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make a backup copy of these folders before applying any changes:","type":"text"},{"type":"hardBreak"},{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Linux, if you are upgrading from a Certificate Manager version earlier than 8.9.x, remove the Nexus CIS, CF and SNMP services using the cmservices tool:","type":"text"},{"type":"hardBreak"},{"text":" /bin/cmservices remove cf","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":" /bin/cmservices remove cis","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":" install_root>/bin/cmservices remove cmsnmp","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do the configuration changes on the server(s) running the Nexus CF, Nexus SNMP, and Nexus CIS service in: ","type":"text"},{"text":"/config/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" described in the respective files under the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename any custom formats files used by Certificate Manager that has a filename that begins with the \"_\" character to something the does not begin with the \"_\" character. Formats starting with \"_\" will not be loaded.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the servers running the Nexus CF, Nexus CIS, or Nexus SNMP service, remove all jar files in the ","type":"text"},{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy all jar files in ","type":"text"},{"text":"Upgrade files CM 8.11.0/server/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" to ","type":"text"},{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace all files in ","type":"text"},{"text":"/tools","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" with the new ones in ","type":"text"},{"text":"Upgrade files CM 8.11.0/server/tools","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy all files in ","type":"text"},{"text":"Upgrade files CM 8.11.0/server/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" to ","type":"text"},{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", replacing the old ones.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy all files in ","type":"text"},{"text":"Upgrade files CM 8.11.0/server/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" to ","type":"text"},{"text":"/deliverynotes","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", replacing the old ones.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are upgrading from a Certificate Manager version earlier than 8.9.x, you must re-install the ","type":"text"},{"text":"cmservices","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":". On Linux, reinstall the Nexus CIS, CF and SNMP services using cmservices tool, replacing \"cmuser\" with the user who shall run the systemd services:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"/bin/cmservices install cf cmuser cmuser","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":" /bin/cmservices install cis cmuser cmuser","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"type":"hardBreak"},{"text":" /bin/cmservices install cmsnmp cmuser cmuser","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure 64-bit Java SE 17 is installed and properly configured to be used by the CF, CIS and SNMP services. See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://nexusdoc.atlassian.net/wiki/spaces/PUB/pages/136019978"}},{"text":" for more information.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure services to use Java 17.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Windows open the Registry Editor. In \"HKEY_LOCAL_MACHINE\\SOFTWARE\\Nexus\\Service Parameters\\\". Edit the variable JREPath so it instead points to Java 17 home directory.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Linux, navigate to ","type":"text"},{"text":"/bin","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" and edit the JAVA variable in the <","type":"text"},{"text":"cf/cis/cmsnmp>_launch.conf","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" to point to Java 17.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start the Nexus CIS, CF, and SNMP services.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3. Upgrade Certificate Manager clients","type":"text"}]},{"type":"expand","attrs":{"title":"From 7.18.x to 8.0.0"},"content":[{"type":"paragraph","content":[{"text":"The directory containing user-specific settings has moved. These settings include the list of favorite CM servers, the trust store for the server TLS certificates, selected columns in various GUI elements, and other client-specific settings.","type":"text"}]},{"type":"paragraph","content":[{"text":"To keep the settings from a previous client installation, move the following directories to the new location:","type":"text"}]},{"type":"paragraph","content":[{"text":"On Windows:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Previously : %USERPROFILE%\\CertificateManager","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New location: %APPDATA%\\Nexus\\CertificateManager","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"On Linux:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Previously : ~/CertificateManager","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New location: ~/.config/certificatemanager","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"Upgrade CM clients"},"content":[{"type":"paragraph","content":[{"text":"Do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Shut down all the Certificate Manager clients.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure Java SE 17 is installed and set as default Java on the system. Certificate Manager clients can be run on both 32-bit and 64-bit JDKs with the following limitations:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Linux:","type":"text"},{"type":"hardBreak"},{"text":"64-bit Java is required in order to use clients with Personal.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Windows: ","type":"text"},{"type":"hardBreak"},{"text":"After the upgrade, if a ","type":"text"},{"text":"javaw.exe","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" binary exists under the ","type":"text"},{"text":"C:\\Windows\\SysWOW64","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder, clients will continue to run on 32-bit Java even if default JDK is 64-bit. Remove this binary (and ","type":"text"},{"text":"javaws.exe","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", ","type":"text"},{"text":"java.exe","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":") in order to run the clients on 64-bit Java.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backup the ","type":"text"},{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Uninstall the Certificate Manager clients components, see ","type":"text"},{"text":"Uninstall Certificate Manager server components and clients","type":"text","marks":[{"type":"link","attrs":{"href":"https://nexusdoc.atlassian.net/wiki/spaces/PUB/pages/65351280"}}]},{"text":". ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Windows use \"Programs and Features\" to uninstall \"Certificate Manager Clients Components\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Linux, run ","type":"text"},{"text":"/install/setup.sh -u","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove any remaining hotfix jar files in the ","type":"text"},{"text":"/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Linux, if there is a ","type":"text"},{"text":"/P11","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder, backup any config file with customizations to Personal Desktop Client and then delete the folder.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the new version of the clients, included in the delivery of Certificate Manager.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Apply any customizations to the new configuration files in the ","type":"text"},{"text":"/config","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The officer role \"Use AWB\" is now used for read-only access to the AWB and no longer has permission to do manual builds of CRLs and CILs. Instead, the role \"Manual build of CRL and CIL\" is needed to perform manual builds.","type":"text"}]},{"type":"paragraph","content":[{"text":"The officer profile that was previously used by the officer that performed manual builds must now be modified to include the role \"Manual build of CRL and CIL\".","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"4. Upgrade Certificate Manager Protocol Gateway","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Upgrade Protocol Gateway","type":"text","marks":[{"type":"link","attrs":{"href":"https://nexusdoc.atlassian.net/wiki/spaces/PUB/pages/65350310"}}]},{"text":". ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"5. Upgrade Certificate Manager SDK","type":"text"}]},{"type":"expand","attrs":{"title":"Upgrade Certificate Manager SDK"},"content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Exception when upgrading from 7.18.x","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When upgrading from 7.18.x to 8.0.0, many deprecated methods have been removed from the CM SDK. See ","type":"text"},{"text":"changes-cmsdk.txt","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" in the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" folder.","type":"text"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Shut down all applications that are using the CM SDK except for CMWS and PGW.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Backup the library folder of the CM SDK application.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove the CM hotfix jar files in the library folder of the CM SDK application folder that adhere to the following patterns:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a-*.jar","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"aa*.jar","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace the jar files in the library folder of the CM SDK application with the supplied files in ","type":"text"},{"text":"Upgrade files CM x.x.x/sdk/lib","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported