Zen v14 Release Notes
General Release – August 2019
Contents
Welcome to the General Release of Zen v14. This release follows PSQL v13 R2. It contains significant new functionality, as well as bug fixes and enhancements to existing features. For more information, see What’s New in Zen v14.
These release notes cover the following topics:
This document is included in your Zen installation but may be updated after the release. Its latest version is always posted on the Actian website.
Overview
Product Editions
This release includes the following editions, listed by operating system.
Windows
Windows IoT Core
Linux
macOS
Raspbian 32-bit
Platforms Supported
This release has been successfully tested on the following operating systems, on both their 32- and 64-bit editions if not specifically listed. For more information about platform support, see What’s New in Zen and Getting Started with Zen.
This release has been tested successfully with Windows 10 version 1809.
Zen installation has been tested successfully with Docker for Windows.
Zen Enterprise Server on Windows IoT Core supports use of the SDKs for Btrieve, DTI, and ODBC. Throughout the Zen documentation, all references to Enterprise Server apply to installations on Windows IoT Core systems as well as personal computer and server editions of Windows.
We recommend updating all operating systems to their latest service packs.
Product Authorization
Zen database engines come with a trial key for evaluation installations. These trial keys have limits of 20 users for Enterprise Server, 5 users for Workgroup, and Medium size (20 GB) for Cloud Server.
If you are installing this release of Zen, you are required to authorize the product, either at the time of installation or after installation using the License Administrator utility.
Additional details on authorization are covered in the following topics:
Authorizing on Windows
On Windows, product authorization is required for Zen Enterprise Server, Cloud Server, and Workgroup. Product authorization can be performed during installation or using the license administrator utility after installation. Authorizing Cloud Server during installation requires an Internet connection. To authorize Cloud Server after installation, see the alternative authorization procedures outlined in Zen User’s Guide.
Note On Windows IoT Core x86 and ARM32, online authorization through a proxy server is not currently supported.
License Authorization Access Through Proxy Servers on Windows
We recommend that you use Windows Internet Explorer to configure proxy servers. If your proxy server was not configured using Internet Explorer, we recommend that you use Internet Explorer to configure it again. If you are unable to use Internet Explorer, then you can use the manual steps given here. These steps involve editing the Windows registry.
Caution Editing the registry is an advanced procedure. If done improperly, the changes can cause your operating system to fail to start. If necessary, obtain the services of a qualified technician to do the editing. Actian Corporation does not accept responsibility for a damaged registry.
Two registry keys can store proxy server settings:
All Zen editions use the first ELS key. Zen editions on 64-bit Windows also use the second ELS key. License Administrator checks for proxy server subkeys in both locations.
Follow these steps to edit registry settings for proxy servers. You must complete both steps.
1
2
Note Zen itself requires only the proxy_host and proxy_port subkey values. Depending on the configuration of your proxy server, you may also need to add proxy_userid and proxy_passwd.
3
Authorizing on Linux
On Linux, product authorization is required for Zen Enterprise Server and Cloud Server. Product authorization must be performed after installation using the license administrator utility. Authorizing Zen v14 requires an Internet connection. To authorize after installation, see the alternative authorization procedures outlined in Zen User’s Guide.
Note On Linux openSUSE AArch64 and Raspbian ARM32, online authorization through a proxy server is not currently supported.
Authorizing on macOS
On macOS, product authorization is required for Zen Enterprise Server and Cloud Server. Product authorization must be performed after installation using the license administrator utility. Authorizing Zen v14 requires an Internet connection. To authorize after installation, see the alternative authorization procedures outlined in Zen User’s Guide.
License Authorization Access Through Proxy Server on Linux, macOS, and Raspbian 32-bit
On Linux, macOS, and Raspbian 32-bit systems, to configure a proxy server to allow license authorization, you must edit the els.ini file. Zen does not support any other method of configuring proxy access on these operating systems.
1
2
Note Zen requires only the proxy_host and proxy_port values. Depending on the configuration of your proxy server, you may also need to add proxy_userid and proxy_passwd.
3
Client Compatibility
On Windows and Linux, Zen v14 Enterprise Server and Workgroup support PSQL v13 Client, except for Windows IoT Core and Raspbian 32-bit, where only a Zen v14 or later version of Client is supported.
For macOS servers, clients must be 14.00 or later.
Upgrading Zen with AuditMaster, Backup Agent, or DataExchange
AuditMaster, Backup Agent, and DataExchange installed with PSQL v13 or earlier Zen versions must be uninstalled before upgrading to Zen v14. Before removing them, we recommend that you capture their configuration settings for later use in reinstalling and configuring their upgraded versions.
New Features and Enhancements
See What’s New in Zen for coverage of new and changed features in this release of Zen. This document is included with the installed documentation and at the Actian website on the download page. The download version may be updated after the product release, so we recommend you refer to that version for the latest information.
Installing Zen
This topic discusses installation of the product. Before reading further, be familiar with Product Authorization.
Installation files are available for download from the Actian website.
You must remove any previously installed prerelease version, such as a beta or release candidate from any edition, before installing a final General Availability (GA) release of Zen.
If you have not installed the product before or are upgrading for the first time and want to read about installation in detail, see Getting Started with Zen, available on the installation media or the Actian website.
Installation steps vary with the platform where Zen is to run:
The following topics provide additional installation information:
Installing on Windows
To start the installation, run the installer application (Install_*.exe) for the Zen product that you want to install and follow the instructions displayed by the installer.
The Zen installer automatically detects the bit architecture of the operating system and installs the right components. You do not have to choose the 32- or 64-bit installer application.
The following table describes Zen installers on Windows operating systems.
Important Notes about Installing or Upgrading on Windows
The following information applies only to Zen users on Windows systems.
Installing Silently on Windows
To install Zen silently, run the installation using the quiet command line option /qn, as shown in this example:
Install_Zen<InstallType>.exe /s /v"/qn /l*v \"%temp%\Zenv14_InstallLogFileName.log\""
This example creates an installation log file in the Windows temp directory.
Optionally, to authorize Zen after the installation has completed, use the License Administrator command line tool clilcadm.exe:
"<Zen_install_path>\bin\clilcadm.exe" -a <key>
Installing on Windows IoT Core
This release has been tested on Windows IoT Core. For information about installing or upgrading on these platforms, see Getting Started with Zen.
Installation Packages
On Windows IoT Core, Zen offers full server and client installations as noted in the following table. A full server installation includes necessary engine and client files and utilities. A client installation provides only files needed to support a client, including utilities. The following table lists the installation packages. Microsoft PowerShell and the .zip archive format are used for the installation.
.Zip Archive1                                                                         
Install-Zen-EnterpriseServer-yy.yy.zzz.zzz-winuwp.x86.zip
Install-Zen-EnterpriseServer-Any-yy.yy.zzz.zzz-winuwp.arm32.zip
1 yy.yy and zzz.zzz represent the digits in the file name for the release and build numbers of the product.
Installing on Linux
Zen v14 has been tested on Red Hat Enterprise Linux 7, OpenSUSE, and CentOS. For information about installing or upgrading to Zen v14 on Linux, see Getting Started with Zen.
Installation Packages
On Linux, Zen offers full server and client installations as both RPM and TAR Linux packages. A full server installation includes engine and client files, utilities, and the complete user documentation. A client installation provides only files needed to support a client, including utilities and documentation. The following table lists the installation packages.
Package Names1                                                               
Zen-EnterpriseServer-linux-yy.yy-zzz.zzz.x86_64.rpm
Zen-EnterpriseServer-linux-x86_64-yy.yy.zzz.zzz.tar.gz
Zen-CloudServer-linux-yy.yy-zzz.zzz.x86_64.rpm
Zen-CloudServer-linux-x86_64-yy.yy.zzz.zzz.tar.gz
Zen-Client-linux-yy.yy-zzz.zzz.x86_64.rpm
Zen-Client-linux-x86_64-yy.yy.zzz.zzz.tar.gz
Note: Glibc and stdc++ packages are prerequisites for the Client Access installation. Before installing Client Access, you can add these packages from the repository of your Linux distribution using a yum command:
Zen-Client-Access-linux-yy.yy-zzz.zzz.x86_64.rpm
Zen-Client-Access-linux-x86_64-yy.yy.zzz.zzz.tar.gz
1 yy.yy and zzz.zzz represent the digits in the file name for the release and build numbers of the product.
Note To upgrade to Zen v14 from a previous PSQL version on Linux, you must first uninstall the current version. Also, you must stop any process owned by user psql that may still be running on your system.
Installing on macOS
Zen v14 has been tested on macOS 10.14. For information about installing or upgrading to Zen v14 on this operating system, see Getting Started with Zen.
Installation Packages
On macOS, Zen offers full server and client installations of both TAR and DMG packages. A full server installation includes necessary engine and client files, utilities, and the complete user documentation. A client installation provides only files needed to support a client, including utilities and documentation. The following table lists the installation packages.
Package Names1                                                         
Zen-EnterpriseServer-macos-x86_64-yy.yy.zzz.zzz.tar.gz
Zen-EnterpriseServer-macos-x86_64-yy.yy.zzz.zzz.dmg
Zen-CloudServer-macos-x86_64-yy.yy.zzz.zzz.tar.gz
Zen-CloudServer-macos-x86_64-yy.yy.zzz.zzz.dmg
Zen-Client-macos-x86_64-yy.yy.zzz.zzz.tar.gz
Zen-Client-macos-x86_64-yy.yy.zzz.zzz.dmg
1 yy.yy and zzz.zzz represent the digits in the file name for the release and build numbers of the product.
Note To upgrade to Zen v14 from a previous version on macOS and Raspbian 32-bit, you must first uninstall the current version.
Installing on Raspbian 32-bit
This release has been tested on Raspbian 32-bit. For information about installing or upgrading on this platform, see the Linux documentation in Getting Started with Zen.
Installation Packages
On Raspbian 32-bit, Zen offers full server and client installations of TAR packages. A full server installation includes necessary engine and client files, utilities, and the complete user documentation. A client installation provides only files needed to support a client, including utilities and documentation. The following table lists the installation packages.
Package Names1                                                               
Zen-Client-linux-armhf-yy.yy.zzz.zzz.tar.gz
1 yy.yy and zzz.zzz represent the digits in the file name for the release and build numbers of the product.
Important Notes about Installing on macOS and Raspbian 32-bit
The following information applies when you install on macOS and Raspbian 32-bit systems. These notes all relate to access and authentication using the Samba implementation of the SMB/CIFS networking protocol. The instructions for configuring Samba on Linux also apply to macOS and Raspbian 32-bit, but with the exceptions shown here.
 
Source Code for Zen unixODBC
In accordance with GNU General Public Licensing (GPL), on Linux, macOS, and Raspbian 32-bit systems the source code for Zen unixODBC functionality is redistributed in the /etc directory of the installation as psql-unixODBC-2.2.11.tar.gz.
JRE Components Included in Installation
Zen bundles JRE 8 from OpenJDK in its installations on Windows, Linux-based systems, and macOS. The version is OpenJDK 8, Update 222, build 10 (8u222b10). You may replace this copy with a later update of OpenJDK 8 without interfering with the Zen installation.
Installing Backup Agent
Backup Agent does not require a separate license when used with Zen Enterprise Server. It is included with Zen Enterprise Server for Windows. To use Backup Agent with Zen Workgroup, you must have a separate license.
Windows IoT Core
Backup Agent v14 is not currently supported on Windows IoT Core.
Linux Red Hat, openSUSE, and CentOS
On Linux Red Hat, openSUSE, and CentOS before installing Zen v14, you must manually uninstall any existing version of Backup Agent. After installing Zen v14, you can manually install Backup Agent v14.
macOS
Backup Agent v14 is not currently supported on macOS.
Raspbian 32-bit
Backup Agent v14 is not currently supported on Raspbian 32-bit.
Fixed and Known Issues
The Actian community forums and knowledge base both enable you to search for a history log that lists issues fixed and enhancements added since the previous release. You can also find a list of current known issues.
Usage Notes
This topic discusses situations you might encounter using the product after installation.
For Windows
 
Technical Support
You can find information and obtain help from several online options at the Actian website:
Community Forums. Join the technical discussion under Actian Zen.
Knowledge Base. Search articles for answers and solutions others have found useful.
Technical Support. Open a help ticket, submit a defect, or purchase services.
Copyright and Legal Statements
Copyright © 2019 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 (pharvey@codebydesign.com), modified and extended by Nick Gorham (nick@easysoft.com), 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 (nick@easysoft.com).
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.