SDL Upgrading Contenta Client on Windows SDL Contenta 5.7 December 2018 Legal notice Copyright and trademark information relating to this product release. Copyright © 2009–2018 SDL Group. SDL Group means SDL PLC. and its subsidiaries and affiliates. All intellectual property rights contained herein are the sole and exclusive rights of SDL Group. All references to SDL or SDL Group shall mean SDL PLC. and its subsidiaries and affiliates details of which can be obtained upon written request. All rights reserved. Unless explicitly stated otherwise, all intellectual property rights including those in copyright in the content of this website and documentation are owned by or controlled for these purposes by SDL Group. Except as otherwise expressly permitted hereunder or in accordance with copyright legislation, the content of this site, and/or the documentation may not be copied, reproduced, republished, downloaded, posted, broadcast or transmitted in any way without the express written permission of SDL. Contenta is a registered trademark of SDL Group. All other trademarks are the property of their respective owners. The names of other companies and products mentioned herein may be the trademarks of their respective owners. Unless stated to the contrary, no association with any other company or product is intended or should be inferred. This product may include open source or similar third-party software, details of which can be found by clicking the following link: “Acknowledgments” on page 27. Although SDL Group takes all reasonable measures to provide accurate and comprehensive information about the product, this information is provided as-is and all warranties, conditions or other terms concerning the documentation whether express or implied by statute, common law or otherwise (including those relating to satisfactory quality and fitness for purposes) are excluded to the extent permitted by law. To the maximum extent permitted by law, SDL Group shall not be liable in contract, tort (including negligence or breach of statutory duty) or otherwise for any loss, injury, claim liability or damage of any kind or arising out of, or in connection with, the use or performance of the Software Documentation even if such losses and/or damages were foreseen, foreseeable or known, for: (a) loss of, damage to or corruption of data, (b) economic loss, (c) loss of actual or anticipated profits, (d) loss of business revenue, (e) loss of anticipated savings, (f) loss of business, (g) loss of opportunity, (h) loss of goodwill, or (i) any indirect, special, incidental or consequential loss or damage howsoever caused. All Third Party Software is licensed "as is." Licensor makes no warranties, express, implied, statutory or otherwise with respect to the Third Party Software, and expressly disclaims all implied warranties of non-infringement, merchantability and fitness for a particular purpose. In no event will Licensor be liable for any damages, including loss of data, lost profits, cost of cover or other special, incidental, consequential, direct, actual, general or indirect damages arising from the use of the Third Party Software or accompanying materials, however caused and on any theory of liability. This limitation will apply even if Licensor has been advised of the possibility of such damage. The parties acknowledge that this is a reasonable allocation of risk. Information in this documentation, including any URL and other Internet Web site references, is subject to change without notice. Without limiting the rights under copyright, no part of this may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of SDL Group. ii SDL Upgrading Contenta Client on Windows Contents 1 Before you upgrade . ....................................... 1 Pre-upgrade procedure . 2 Upgrading Oracle . 3 2 Upgrading Contenta Client .................................... 5 Performing a Silent Upgrade . 9 LogFile.............................................. 10 Hiding the Default User Name in Contenta Login Screens . 11 Post-installation note regarding Verilk . 12 Post-Installation Steps for XMetaL Enterprise . 13 Alternate Reprise License Socket Number . 13 3 Upgrading the Contenta Database ............................... 15 upgrade_56 . 16 Path to the upgrade script . 16 Upgrade script . 16 Results . 19 Troubleshooting . 20 4 Configuring Contenta Client .................................. 21 Testing the SDL Contenta Software . 23 A Troubleshooting .......................................... 25 Editor Checkout, Timestamp, and Editing . 26 B Acknowledgments ........................................ 27 SDL Upgrading Contenta Client on Windows iii iv SDL Upgrading Contenta Client on Windows 1 Before you upgrade 1 Before you upgrade These topics describes steps to be taken before you begin your Contenta Client upgrade. Pre-upgrade procedure Follow these steps before upgrading the Contenta Client. Before you begin You must upgrade the Contenta Server first. See the SDL Contenta Server Upgrade Guide for Windows topic. Procedure 1. If upgrading a client with an Oracale database, upgrade and configure the Oracle software if needed—see the Upgrading Oracle topic. 2. See the Platform Requirements to determine the version of Perl for the Contenta version to which you are upgrading. If a newer version of Perl is required, you must remove earlier versions of ActiveState Perl before upgrading Contenta, then follow the steps to install Perl during the upgrade. Note: Contenta 5.7 installs Strawberry Perl in its own install location and does not support Ac- tiveState Perl. Before removing ActiveState Perl, make sure no other Software is dependent on it, for example, SDL XPP. 3. Save custom files, such as Contenta tools and scripts that may be overwritten by the upgrade. On the Contenta Client, save files such as those: • FilesinContenta_home/encaps/di/custom • Custom tools in Contenta_home/ encaps After the upgrade is complete, compare the differences between any custom files or files you modified for your environment and any new files delivered into the distr directory. If necessary, modify your custom files to include updates delivered in the newer versions of the files. 4. If unknown, find the name of the ODBC DNS (for use during the upgrade)—click Start > Admin- istrative Tools > Data Sources (ODBC) > System DSN. 5. Run verilk on your current database using the system and verilk utility of the version of Contenta from which you are upgrading. Run verilk before upgrading your database to check and repair the parent_list, which contains information about the relationships between parent and child objects. See the SDL Contenta Administration User topics for complete information about the verilk command. 6. Run the Contenta upgrade script. For more information about the full syntax for the upgrade command, see the upgrade_56 script topic. If the upgrade command fails, contact SDL Technical Support for help. Your database may not be at the proper version to use the upgrade script. 7. Reboot your system and make sure there are no applications running, as the installation can return an error if other applications have some files locked. 2 SDL Upgrading Contenta Client on Windows Before you upgrade 1 Related information Ӎ “Upgrading Contenta Client”on page 5 Ӎ “Configuring Contenta Client”on page 21 Ӎ “Upgrading the Contenta Database”on page 15 Upgrading Oracle If you are upgrading a client using Oracle and do not have the required Oracle Client software release and patch set installed on it, install or upgrade it before you upgrade the Contenta software. About this task Note: Be sure that the client is installed with the same version of Oracle software that is installed on the Oracle Server. Procedure 1. Follow the instructions provided by Oracle to upgrade the Oracle Client software and install the appropriate Oracle patches on the Contenta Clients that are required for this SDL Contenta release. See the Platform Requirements document for information about the system requirements. Perform the upgrade as the administrator user. 2. After the Oracle Client is installed, use the Net8 Assistant to verify that a service entry exists for Oracle. If one does not exist, use the Net Configuration Assistant to update the tnsnames.ora file. Provide the information described in the following table. See the Oracle documentation if you need additional information for this step. Note: Use the same Service Name that was used when you installed the Oracle Server. The upgrade program does not prompt for a Service Name. Net Configuration Assistant Add New Service Service name is user-defined. Protocol TCP/IP Host Name Name of database server on which the Contenta Oracle instance (SID) resides. Port Number Use the Oracle default port number unless otherwise instructed by your DBA. Service Name Name of the Contenta Oracle instance (SID). 3. Restart the Oracle Server system. After you upgrade Oracle Server and Client, test Oracle connectivity before continuing. SDL Upgrading Contenta Client on Windows 3 1 Before you upgrade 4 SDL Upgrading Contenta Client on Windows 2 Upgrading Contenta Client 2 Upgrading Contenta Client The upgrade program may prompt you to replace files on your system. About this task Answer For: Yes SDL software product files—that is, XPP software files or, if applicable, previously installed Contenta files. No