• 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
    • Required Windows Updates
    • 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
      • ActiveX Interface Controls
      • ADO.NET Provider
      • Btrieve DOS
      • DTO
      • JCL
      • JDBC Driver
      • OLE DB
      • 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 v14 from a Previous Version
    • Considerations When Upgrading to Zen v14
  •  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 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, macOS, and Raspbian Path Formats
      • Share Names
      • Absolute Paths
    • Native SMB File Sharing on macOS
  •  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, macOS, 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, macOS, 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
    • 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, macOS, or Raspbian
    •  Full and Client Installations
      • Utilities on Raspbian
    • Connecting from a Linux-Based Client to a Windows Enterprise Server or Cloud Server
  •  Installing Zen Using RPM
    •  Installing Zen Enterprise Server or Cloud Server for Linux - RPM
      • First-Time Installation
      • Upgrade Installation
    •  Installing Zen Client for Linux - RPM
      • First-Time Installation
      • Upgrade Installation
  •  Installing Zen Using TAR
    •  Installing Zen Enterprise Server or 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 a Zen Server on macOS - TAR
      • First-Time Zen Server Installation on macOS
      • Upgrading a Zen Server Installation on macOS
    •  Installing Zen Client for Linux and Raspbian - TAR
      • First-Time Client Installation on Linux and Raspbian
      • Upgrading a Client Installation on Linux and Raspbian
    •  Installing Zen Client for macOS - TAR
      • First-Time Client Installation on macOS
      • Upgrading a Client Installation on macOS
  •  Installing Zen Using DMG on macOS
    •  Installing a Zen Server on macOS - DMG
      • First-Time Zen Server Installation on macOS
      • Upgrading a Zen Server Installation on macOS
    •  Installing Zen Client for macOS - DMG
      • First-Time Client Installation on macOS
      • Upgrading a Client Installation on macOS
  •  After Installing Zen on Linux, macOS, or Raspbian
    • Verifying Installed Products with RPM
    • Verifying Database Engine is Running
    • Server Configuration
    •  Client Configuration
      • Linux, macOS, and Raspbian Clients and the Monitor Utility
    • Licensing
    •  Common Questions After Installation
      • Where Do Files Reside After Installing Zen on Linux, macOS, 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, macOS, or Raspbian
    • Removing a Zen RPM Package
    • Removing a Zen TAR Package
    • Removing a Zen DMG
•  Using Zen on Linux, macOS, and Raspbian
  •  Finding What You Need
    • Accessing the User Documentation
    • Man Pages
  •  Zen Account Management on Linux, macOS, and Raspbian
    • After Installation Behavior
    • The User Environment
    •  Using Utilities from Users Other Than zen-svc
      •  Examples of a Modified Profile
        • Linux and Raspbian
        • macOS
  •  Configuration
    • Samba Configuration File
    • Authentication
    •  Supported Path Formats for Samba
      • Windows Client
      • Linux, macOS, 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
      • 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

gateway:Setting Up a Gateway Configuration%A gateway is a Workgroup Engine that can be used when data is stored on a file server without a database engine.