Linux Integration Guide Version 2.4.1 Published December, 2019 Legal Notices Documentation Feedback: [email protected] Legal Notices © Copyright 2019 Hewlett Packard Enterprise Development LP. All rights reserved worldwide. Notices The information contained herein is subject to change without notice. The only warranties for Hewlett Packard Enterprise products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein. Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documen- tation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise website. Acknowledgments Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks of Intel Corporation in the United States and other countries. Microsoft® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated. Java® and Oracle® are registered trade- marks of Oracle and/or its affiliates. UNIX® is a registered trademark of The Open Group. Publication Date Tuesday December 10, 2019 15:18:04 Document ID gob1536692193582 Support All documentation and knowledge base articles are available on HPE InfoSight at https://infosight.hpe.com. To register for HPE InfoSight, click the Create Account link on the main page. Email: [email protected] For all other general support contact information, go to https://www.nimblestorage.com/customer-support/. Copyright © 2019 by Hewlett Packard Enterprise Development LP. All rights reserved. Contents HPE Nimble Storage Linux Toolkit (NLT)...................................................6 Prerequisites.........................................................................................................................................6 NORADATAMGR Prerequisites................................................................................................6 NCM Prerequisites.....................................................................................................................7 Docker Prerequisites.................................................................................................................7 NLT Backup Service Prerequisites............................................................................................8 Nimbletune Prerequisites...........................................................................................................8 Kubernetes Prerequisites..........................................................................................................8 Download the NLT Installation Package..............................................................................................9 Install NLT Using the GUI.....................................................................................................................9 NLT Commands.................................................................................................................................10 HPE Nimble Storage Oracle Application Data Manager.........................12 The noradatamgr.conf File.................................................................................................................12 ASM_DISKSTRING Settings...................................................................................................13 Accessing NORADATAMGR..............................................................................................................13 NORADATAMGR Workflows..............................................................................................................14 Describe an Instance...............................................................................................................15 Describe a Diskgroup..............................................................................................................16 Enable NPM for an instance....................................................................................................17 Disable NPM for an instance...................................................................................................18 Edit an Instance.......................................................................................................................18 Take a Snapshot of an Instance..............................................................................................19 List and Filter Snapshots of an Instance.................................................................................21 List Pfile and Control File.........................................................................................................23 Clone an Instance....................................................................................................................24 Delete a Snapshot of an Instance...........................................................................................29 Destroy a Cloned Instance......................................................................................................30 Destroy an ASM Diskgroup.....................................................................................................30 Overview of Using RMAN with NORADATAMGR .............................................................................31 Add a NORADATAMGR Backup to an RMAN Recovery Catalog...........................................33 Clean Up Cataloged Diskgroups and Volumes Used With RMAN..........................................34 RAC Database Recovery........................................................................................................36 Oracle NPM and NLT Backup Service...............................................................................................38 NPM Commands.....................................................................................................................38 Troubleshooting NORADATAMGR....................................................................................................39 Log Files..................................................................................................................................39 SQL Plus..................................................................................................................................39 Copyright © 2019 by Hewlett Packard Enterprise Development LP. All rights reserved. Information for a noradatamgr Issue.......................................................................................39 ASM Disks Offline When Controller Failure Occurs................................................................40 noradatamgr Command Fails after NLT Installation................................................................40 Snapshot and Clone Workflows Fail if spfile not Specified......................................................40 Failover causes ASM to mark disks offline or Oracle database fails.......................................41 Bringing Up the RAC Nodes After an RMAN Recovery Operation..........................................41 HPE Nimble Storage Docker Volume Plugin............................................42 Docker Swarm and SwarmKit Considerations...................................................................................42 The docker-driver.conf File.................................................................................................................43 Docker Volume Workflows.................................................................................................................46 Create a Docker Volume.........................................................................................................48 Clone a Docker Volume...........................................................................................................49 Provisioning Docker Volumes..................................................................................................49 Import a Volume to Docker......................................................................................................50 Import a Volume Snapshot to Docker......................................................................................50 Restore an Offline Docker Volume with Specified Snapshot ..................................................51 Create a Docker Volume using the HPE Nimble Storage Local Driver...................................51 List Volumes............................................................................................................................52 Run a Container Using a Docker Volume................................................................................52 Remove a Docker Volume.......................................................................................................53 HPE Nimble Storage Connection Manager (NCM) for Linux..................54 Configuration......................................................................................................................................54