About This Document
Welcome to Zen
About Zen
Competitive Advantages
Transactional (Direct Data) Access or Relational Access
The Zen MicroKernel Engine
Benefits
Features
The Zen Relational Engine
Benefits
Features
About the Zen Database Editions
Zen Enterprise Server and Cloud Server
Zen Workgroup
Server and Workgroup Comparison
Zen SDK
Development Environment
Preparing to Install Zen
Installation Requirements
Access Rights
No Other Zen Database Engine Installed
Upgrading to a New Version
Operating Requirements
Installation Options
Complete Installation
Custom Installation
Zen Products
Enterprise Server and Cloud Server
Workgroup
Client
Zen Optional Features
Access Methods
ADO.NET Provider
Btrieve DOS
DTO
JCL
JDBC Driver
PDAC
Utilities
Cobol Schema Executor
Data Dictionary File Builder
Zen Control Center
Zen System Analyzer
Documentation
Java Runtime Environment (JRE)
Installation Review
Quick Checklist
Common Questions Before Installation
Where do I install Zen Enterprise Server or Cloud Server?
What about the server’s client software?
Where do I install Zen Workgroup?
What about Workgroup clients?
How do I install Zen in a Microsoft Cluster Server environment?
How do I install Zen in a Microsoft Remote Desktop Services or XenApp environment?
How do I install Zen in a Microsoft Active Directory environment?
Where do I install Zen Clients accessing web applications?
Does the Zen Client version have to match the Zen Server version?
Does it matter where I download the Zen installer?
My system runs 24/7. What is the best time for installing or upgrading Zen?
How can I restrict users running in Terminal Services from changing Zen configuration settings, creating DSNs, and using the Monitor utility?
Are there special settings not listed here that I need to make for my configuration?
Upgrading Your Installation for Windows
Upgrading to Zen v16 from a Previous Version
Considerations When Upgrading to Zen v16
Common Questions After Upgrading
How to Handle Data Source Names (DSNs)
How Do I Convert Files from Previous Releases?
What User License Was Installed?
Installing Zen Enterprise Server and Cloud Server for Windows
Before You Install
Platform Notes
Installing the Engine on Terminal Server
Running the Engine on Terminal Server
Installation Tips
Failover Clusters
Installing a Zen Server on Windows
Where to Go from Here
Installing Zen Clients for Windows
Before You Install the Windows Client
Installing Zen Client for Windows
Installing the BTRBOX Requester
Win32 DOS Box Support
Understanding Client Requesters
Types of Windows Requesters
DOS Requesters
Trace Requesters
Where to Go from Here
Installing Zen Workgroup for Windows
Before You Install Workgroup
Installation Tips
Installing Zen Workgroup for Windows
Authorization of Workgroup Key on Windows with UAC
Where to Go from Here
Installing the Client Reporting Engine for Windows
Before You Install the Windows Client Reporting Engine
Installing Zen Client Reporting Engine for Windows
Where to Go from Here
After Installing Zen for Windows
Common Questions After Installing
Where are the files installed?
Where are the files installed?
What is an application data file?
What is a program file?
What is the difference between 32- and 64-bit program files?
What if I need a 64-bit Client in a Workgroup environment?
Do I need to install the Client with Workgroup?
How do I read the online documentation?
How do I verify or update my user license?
What user license was installed?
Where to Go from Here
Uninstalling Zen
Setting Up Network Communications for Servers
Engine Network Communication Settings
Setting Up TCP/IP Support
Setting Up Network Communications for Clients
Client Network Communication Settings
Network Path Formats Supported by Zen Requesters
Universal Naming Convention (UNC) Path Formats
Drive-based Formats
Linux and Raspbian Path Formats
Share Names
Absolute Paths
IPv6
IPv6 Addresses
Recommendations for Numeric IPv6 Addresses
Unicast Addresses
IPv6 Address Modifiers
Address Presentations
IPv6-literal.net Names
Bracketed IPv6 Addresses
IPv6 and the MicroKernel Engine
IPv6 and the Relational Engine
IPv6 with Linux and Raspbian
Suggested Distributions
Limitations and Conditions
Best Practices
Frequently Asked Questions About IPv6
Using TCP/IP to Connect to a Windows Server
Configuring a Client for the Server IP Address
Using DNS to Configure the Server IP Address
Using the Hosts File to Configure the Server IP Address
Preventing the Windows Dial-Up Network Dialog Box from Displaying When Using a Zen Application with TCP/IP
Changing the Default Communication Ports
Services File
Windows FireWalls
Profile Changes After Installation
Notes About Policies
Using TCP/IP to Connect a Windows Client to Linux or Raspbian Servers
Configuring a Client for the Server IP Address
Using DNS to Configure the Server IP Address
Using the Hosts File to Configure the Server IP Address
Preventing the Windows Dial-Up Network Dialog Box from Opening
Data Encoding
Using the DOS Requester
Supported Configurations
DOS Box Support on Windows
Running DOS Applications on Windows 32-bit Platforms
Using DOS Box Support
Setting Up a Workgroup Engine
Overview
Installation Requirements
Operating System Security
When to Use Workgroup
Small Client-Server Configuration
Peer-to-Peer Configuration
Gateway Configuration
What is a Gateway Engine?
Setting Up a Small Client-Server Configuration
Setting Up a Peer-to-Peer Configuration
Setting Up a Gateway Configuration
Floating or Fixed Gateway
Use the Gateway Locator Utility
Use a Command Prompt
Use Windows Explorer
Working with the Gateway Locator Utility
Running the Workgroup Engine as a Service
Configuration
Stopping the Service
Setting Up a Client Reporting Engine
Server Properties for Client Reporting Engine
Client Properties for Client Reporting Engine
Database Properties for Client Reporting Engine
Client Reporting Engine Limitations
Using the Client Reporting Engine as a Btrieve Cache Engine
Using the Client Reporting Engine with the DTI API
Application Configuration Scenarios
Terminal Services
Disabling Administrative Functions
Terminal Server as Network Server
Workgroup Engine Running as a Service
Active Directory Service
Server and Client Support
Server and Client Support
Directory and File Permissions
Microsoft Terminal Services Support
Zen Administrative Authority
Active Directory Tasks
Multiple Client Applications
Settings Affected by Multiple Applications
Compatibility | Create File Version
Data Integrity | Transaction Durability
Concurrent Local and Remote Applications
Using Server and Workgroup Engines Concurrently
Accessing Data on Other Computers
Installing Zen for Linux-based Systems
Before You Install on Linux or Raspbian
Full and Client Installations on Linux-Based Systems
Utilities on Raspbian
Connecting from Linux-Based Clients to Windows Enterprise Server or Cloud Server
Installing Zen Using TAR
Installing Zen Enterprise Server of Cloud Server for Linux and Raspbian - TAR
First-Time Zen Server Installation on Linux and Raspbian
Upgrading a Zen Server Installation on Linux and Raspbian
Installing Zen Client for Linux and Raspbian - TAR
First-Time Client Installation on Linux and Raspbian
Upgrading a Client Installation on Linux and Raspbian
After Installing Zen on Linux or Raspbian
Verifying Database Engine is Running
Server Configuration
Client Configuration
Linux and Raspbian Clients and the Monitor Utility
Licensing
Common Questions After Installation
Where Do Files Reside After Installing Zen on Linux and Raspbian?
How Do I Access the Documentation?
Man Pages
Documentation Library
Release Notes
What If I Get Errors Trying to Start the Utilities?
Uninstalling Zen on Linux or Raspbian
Using Zen on Linux and Raspbian
Finding What You Need
Accessing the User Documentation
Man Pages
Zen Account Management on Linux and Raspbian
After Installation Behavior
The User Environment
Using Utilities from Users Other Than zen-svc
Example of a Modified Profile
Configuration
Samba Configuration File
Authentication
Supported Path Formats for Samba
Windows Client
Linux or Raspbian Client
Client Information
Authentication to Remote Machines
Creating a Client DSN
Setting Up Web-based Data Access
ODBC Behavior
Configuring Web Server
PHP
Zen PHP Requirements
PHP Connection Snippet
PHP Sample
Perl
Zen Perl Requirements
Perl Connection Snippet
Perl Sample
Using Perl and ODBC with Zen
Code Snippet for Perl and DBI
Installing on Windows Nano Server or Windows IoT Core
Before You Install on Windows Nano Server or IoT Core
Special Instructions Before Installing Nano Server in a Docker Container
Windows Platform
Windows PowerShell
DLL File netapi32.dll
Sample Dockerfile
Installing Using PowerShell
Choosing a .Zip Archive for Installing
First-Time Installation on Windows Nano Server or IoT Core
About Zen Edge Server on Windows IoT Core
About Zen Edge Server on Windows IoT Core
Windows Firewall Configuration
Upgrade Installation on Windows Nano Server or IoT Core
After Installing on Windows Nano Server or IoT Core
Server Configuration
Client Configuration
Licensing
Code Page Configuration on Windows IoT Core Systems
Common Questions After Installation
How Can I Verify That the Database Engine is Running?
What Utilities Are Installed?
Where Do Files Reside After Installing?
How Do I Access the Documentation?
Where Are the Release Notes?
Uninstalling on Windows Nano Server or IoT Core
Troubleshooting After Installation
Troubleshooting Tools
Troubleshooting Strategies
Checklist for Problems
Troubleshoot the Problem
Logged Messages
Configuration for Special Installation Situations
Diagnosing Problems with Zen System Analyzer
Verifying Database Engine is Running
Zen Servers on Windows
Zen Workgroup on Windows
Zen Servers on Linux-based Systems
Obtaining File, Client, and Engine Version Number
Determining Client and Engine Version
Using Function Executor
Using the butil Utility
Determining a File Version
Using the Zen Control Center
Using Btrieve Maintenance
Using Function Executor
Using the butil Utility
Engine and Client Version Conflicts
State of Key Is "Failed Validation" or "Disabled"
Troubleshooting Common Zen Issues
I receive Status 7224 or my license is no longer listed in the License Administrator utility.
I fail to see the effects of my configuration changes.
Why do I receive Status 7012 when trying to create a new database with Workgroup Engine using ZenCC on Windows?
Why do I (now) receive Status 95, after running my application successfully?
Installing a Zen application has rendered another application unusable.
How do I verify that my DOS components are functioning properly?
Why can’t I restart my application after an improper program exit?
Why isn’t my application using Workgroup Engine?
How Do I Access the Documentation?
I received an error message during installation that begins: "Setup did not update the PATH statement in autoexec.bat because the new path would be too long for Windows."
Issues After Uninstalling Zen on Windows
How to Get Additional Help
About This Document
Troubleshooting After Installation