DTACS 5.2 Installation and Migration Guide Please Read Important Read this entire guide. If this guide provides installation or operation instructions, give particular attention to all safety statements included in this guide. Notices Trademark Acknowledgments Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R) Publication Disclaimer Cisco Systems, Inc. assumes no responsibility for errors or omissions that may appear in this publication. We reserve the right to change this publication at any time without notice. This document is not to be construed as conferring by implication, estoppel, or otherwise any license or right under any copyright or patent, whether or not the use of any information in this document employs an invention claimed in any existing or later issued patent. Copyright © 2018-2019 Cisco and/or its affiliates. All rights reserved. Information in this publication is subject to change without notice. No part of this publication may be reproduced or transmitted in any form, by photocopy, microfilm, xerography, or any other means, or incorporated into any information retrieval system, electronic or mechanical, for any purpose, without the express permission of Cisco Systems, Inc. Contents About This Guide vii Planning the Install or Migration 1 Site Requirements .................................................................................................................... 2 Estimated Timeline .................................................................................................................. 5 Determine Which Optional Features to Enable ................................................................... 6 Accessing the root and dncs User Accounts ........................................................................ 7 Deploy the DTACS Virtual Machine 9 Deploying the VM From the Linux Platform Template ................................................... 10 Reconfiguring the Virtual Hardware Settings on the VM ............................................... 12 Setting the Power Policy ....................................................................................................... 13 Power on the New DTACS VM ........................................................................................... 14 Updating the Network Configuration File for the Corporate Interface ......................... 15 Adding Additional Network Interfaces ............................................................................. 17 DTACS 5.2 Installation 19 Generating and Installing HTTPS X.509 Certificates for the DTACS using an Internal Root CA .................................................................................................... 20 Installing DTACS 5.2 ............................................................................................................. 26 Creating the config.json File on the DTACS ...................................................................... 28 Configuring the Certificate/Key Pair on the DTACS ....................................................... 30 Migrate DTACS 5.0 or DTACS 4.1 to DTACS 5.2 33 Creating an Admin User on the DTACS 4.1 System ......................................................... 34 Delete the DTACS Registration from an ECS .................................................................... 35 Migrating the Database and Key Files to DTACS 5.2 ....................................................... 38 Updating the Network Configuration Files ....................................................................... 46 Reconnecting the Network Adapters .................................................................................. 49 Post Upgrade Procedures 51 Adding User-defined /etc/hosts Entries ........................................................................... 52 Adding User-defined .profile Entries ................................................................................. 53 Creating User Accounts ........................................................................................................ 54 Updating the site_info Database Table for a Hostname Change .................................... 57 Verifying the DTACS Certificate Configuration ............................................................... 59 iii Contents Setting Up SFTP Support ...................................................................................................... 61 Configuring the DTACS Server for the EC ........................................................................ 65 Configuring the EC for DTACS ........................................................................................... 66 Testing Synchronization Between the DTACS and EC Databases ................................. 68 Configuring DTACS BOSS Proxy (Optional) ..................................................................... 69 Restart Apache and Tomcat Services .................................................................................. 70 Starting DTACS Processes .................................................................................................... 71 CentOS cron and anacrontab Overview ............................................................................. 72 Verifying the crontab Entries Managed by cron ............................................................... 74 Verifying User-Defined CRON Entries on the Migrated VM ......................................... 75 Testing dbsync from the DTACS Web UI .......................................................................... 76 Enabling RADIUS and LDAP (Optional) ........................................................................... 77 Configure and Operate the Replicated Database 79 Prerequisites for RepDB ........................................................................................................ 80 Overview of the Replicated Database Package ................................................................. 81 Cloning the Secondary VM from the Primary VM ........................................................... 83 Configure RepDB ................................................................................................................... 87 Post RepDB Verifications ...................................................................................................... 92 Customer Information 95 Appendix A Hardware Configuration Procedures for the Cisco UCS C240 97 Hardware Diagram of the Cisco UCS C240 M3 Server .................................................... 98 Hardware Diagram of the Cisco UCS C240 M4 Server .................................................. 101 Hardware Requirements for a New UCS Install ............................................................. 104 Cisco UCS C240 Server CIMC Configuration .................................................................. 105 Cisco UCS C240 Host Configuration ................................................................................ 106 RAID Configuration ............................................................................................................ 107 ESXi Installation ................................................................................................................... 117 Configure the VM Host ....................................................................................................... 123 Appendix B SR 5.2 Rollback Procedures 127 Activate the Old System Release ....................................................................................... 128 iv Contents Appendix C DTACS SR 5.2 Upgrade 129 DTACS SR 5.2 Upgrade Prerequisites .............................................................................. 130 Preparing for the Upgrade.................................................................................................. 131 Upgrading the Secondary VM ........................................................................................... 132 Cloning the Primary VM..................................................................................................... 137 Enabling RepDB on the Upgraded System ...................................................................... 141 Appendix D DTACS 5.2 Patch Installs 143 Preparing for a Patch Install ............................................................................................... 144 Installing a DTACS Patch ................................................................................................... 145 Uninstalling a DTACS Patch .............................................................................................. 148 Appendix E Configure SNMP3 151 Configuring SNMPv3 .......................................................................................................... 152 Appendix F Configure Multiple Interfaces in a CentOS Environment 155 Background ........................................................................................................................... 156 Solution to this Issue ............................................................................................................ 157 Appendix G Increase the Size of Hard Disk 2 161 Increasing the Size of Hard Disk