Zen v15 Advanced Operations Guide Procedures and References for Advanced Users Copyright © 2021 Actian Corporation. All Rights Reserved. This Documentation is for the end user’s informational purposes only and may be subject to change or withdrawal by Actian Corporation (“Actian”) at any time. This Documentation is the proprietary information of Actian and is protected by the copyright laws of the United States and international treaties. The software is furnished under a license agreement and may be used or copied only in accordance with the terms of that agreement. No part of this Documentation may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, or for any purpose without the express written permission of Actian. To the extent permitted by applicable law, ACTIAN PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY KIND, AND ACTIAN DISCLAIMS ALL WARRANTIES AND CONDITIONS, WHETHER EXPRESS OR IMPLIED OR STATUTORY, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTY OF MERCHANTABILITY, OF FITNESS FOR A PARTICULAR PURPOSE, OR OF NON- INFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT WILL ACTIAN BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF ACTIAN IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE. The manufacturer of this Documentation is Actian Corporation. For government users, the Documentation is delivered with “Restricted Rights” as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227-7013 or applicable successor provisions. Actian, Actian DataCloud, Actian DataConnect, Actian X, Avalanche, Versant, PSQL, Actian Zen, Actian Director, Actian Vector, DataFlow, Ingres, OpenROAD, and Vectorwise are trademarks or registered trademarks of Actian Corporation and its subsidiaries. All other trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. This product includes software developed by Powerdog Industries. Copyright 1994 Powerdog Industries. All rights reserved. This product includes software developed by KeyWorks Software. Copyright 2002 KeyWorks Software. All rights reserved. This product includes software developed by DUNDAS SOFTWARE. Copyright 1997-2000 DUNDAS SOFTWARE LTD., all rights reserved. This product includes software developed by the Apache Software Foundation (www.apache.org). This product uses the free unixODBC Driver Manager as written by Peter Harvey ([email protected]), modified and extended by Nick Gorham ([email protected]), with local modifications from Actian Corporation. Actian Corporation will donate their code changes to the current maintainer of the unixODBC Driver Manager project, in accordance with the LGPL license agreement of this project. The unixODBC Driver Manager home page is located at www.unixodbc.org. For further information on this project, contact its current maintainer: Nick Gorham ([email protected]). A copy of the GNU Lesser General Public License (LGPL) is included on the distribution media for this product. You may also view the LGPL at www.fsf.org/licensing/licenses/lgpl.html. Advanced Operations Guide July 2021 Contents About This Documentation . xi Who Should Read This Documentation . xii Conventions . xiii 1 Zen Databases . 1 An Exploration of Object Names, Named Databases, and DSNs Zen Database Concepts. 2 Named Database . 2 Metadata . 2 Identifiers and Object Names. 2 The Default Database and the Current Database . 5 File Structure . 6 Access Methods . 9 Client-Server Communications . 10 Database Code Page . 10 ODBC DSN Creation Options . 11 Using the idshosts File. 11 2 Concepts of Database Maintenance . 13 An Introduction to Database Maintenance Configurations . 14 Database Security . 16 Data Archival and Restoration . 17 Troubleshooting. 18 Helpful Utilities . 19 3 The Zen Component Architecture. 21 A Discussion of Architecture Features Zen Database Management System . 22 Common Address Space . 22 Row Level Locking . 22 MicroKernel Engine . 22 Relational Engine . 23 Relational Architectural Overview . 24 Zen Relational Architecture for Servers and Workgroups. 24 Error Codes . 26 Auto Reconnect . 27 4 Configuration Reference. 29 Configuration Methods and Property Settings in Zen Configuration Overview . 30 Ensuring Configuration Changes Take Effect . 30 Connecting to Different Machines . 30 Configuration Using ZenCC. 31 Configuration Using Bcfg . 32 Command Syntax . 32 Example Scenario: Configuring a Single Setting from a Command Prompt . 33 iii Editing an Input File. 34 Restarting the Engines After Applying a New Setting . 34 Troubleshooting . 35 Service Configuration Properties . 36 Server Configuration Properties on All Platforms. 37 Access . 39 Communication Protocols . 46 Compatibility . 48 Data Integrity. 49 Debugging . 53 Directories . 55 Information. 57 Memory Usage . 57 Performance Tuning. 59 Windows Client Configuration Properties. 66 Access . 67 Application Characteristics . 69 Cache Engine . 70 Cache Engine Debugging . 71 Communication Protocols . 72 Performance Tuning. 73 Security . 74 Linux, macOS, and Raspbian Client Configuration Properties . 75 Case of Configuration Values. 75 Client Performance Affected by Local Setting . 75 File Names with Embedded Spaces . 75 Configuration Reference . 76 Access . 76 Communication Protocols . 77 Application Characteristics . ..