Installing Zen for Linux-based Systems
The following topics explain how to install and uninstall Zen Enterprise Server, Cloud Server, and Zen Client on Linux, macOS, and Raspbian.
Before You Install on Linux, macOS, or Raspbian
Before installing or upgrading Zen Enterprise Server, Cloud Server, Edge Server, or Client, review the following information:
• System requirements listed in the Zen release notes, readme_zen.htm, which also includes other late-breaking updates that may not be included in the user documentation.
You must be logged in as root to install any of the products. If you are installing from a CD, you must be at the CD root directory.
If you have any trouble with an installation, see
Troubleshooting After Installation.
Full and Client Installations
Zen offers the following 64-bit full and client installations:
• TAR packages for Linux, macOS, and Raspbian
• RPM packages for Linux
• DMG packages for macOS
A full installation includes the engine and client files, utilities, and the complete user documentation. Client installations provide only files needed to support a client, including utilities and documentation. If you have 32-bit applications, support is provided as an additional client access installation. The following table lists the installation packages.
Utilities on Raspbian
On Raspbian systems, Zen provides a subset of the command line utilities that are available in full installations. These utilities consist of the following:
Connecting from a Linux-Based Client to a Windows Enterprise Server or Cloud Server
The Server Message Block (SMB) protocol enables network access to the Zen MicroKernel Engine from a Linux, macOS, or Raspbian client at the Btrieve file level. You can find information about SMB-compatible file sharing at
www.samba.org. For more information on remote Btrieve-level access, see
Supported Path Formats for Samba.
If your database server engine fails to meet certain installation requirements, your applications may receive the status code “
3031: Linux requester cannot connect to this server,” indicating a client-server incompatibility. In some cases, you may receive “
94: The application encountered a permission error.”
Installing Zen Using RPM
The RPM format allows you to install Zen if your Linux distribution contains the Red Hat Package Manager (RPM).
The following topics explain how to install Zen products using RPM:
If you have any trouble with installation, see
Troubleshooting After Installation.
Note: MacOS does not support RPM. Use DMG or TAR instead.
Installing Zen Enterprise Server or Cloud Server for Linux - RPM
Choose the package name to use for the installation using the following table and the distribution media.
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First-Time Installation
The package manager copies all necessary files onto disk (default location is /usr/local/actianzen) and runs a post-installation script which performs the following tasks:
• Creates user zen-svc and group zen-data
• Sets user:group ownership to zen-svc:zen-data for the installed files
• Authorizes a trial license
• Creates a new ODBC DSN (data source name) for the Demodata test database
• Creates startup and shutdown scripts for Zen daemons
• Launches the Zen daemon (mkded)
To install Zen Enterprise Server or Cloud Server using RPM
1. Log in as the root user.
2. Assuming the RPM package is in the current directory, enter the following command:
rpm -ivh <server_package_name>
If the RPM package is in another directory, preface the package name with a path.
Upgrade Installation
If you have a previous version of Zen already installed, you must uninstall that version and then install the new release of the product. See
Uninstalling Zen on Linux, macOS, or Raspbian for more information.
Installing Zen Client for Linux - RPM
The name of the Zen Client installation package uses the conventions in the following table.
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First-Time Installation
If you need to provide 32-bit client access for an application, you must install the Zen Client 64-bit first, and then add Zen Client Access 32-bit. Otherwise, the steps are the same.
To install Zen Client using RPM
1. Log in as the root user.
2. Assuming the RPM package is in the current directory, execute the following command.
rpm -ivh <client_package_name>
If the RPM package is in another directory, preface the package name with a path.
Upgrade Installation
If you have a previous version of Zen already installed, you must uninstall that version and then install the new release of the product. See
Uninstalling Zen on Linux, macOS, or Raspbian for more information.
Installing Zen Using TAR
The tape archive (TAR) format allows you to install Zen on Linux, macOS, and Raspbian. The following topics explain how to install Zen products using TAR:
If you have any trouble with installation, see
Troubleshooting After Installation.
Installing Zen Enterprise Server or Cloud Server for Linux and Raspbian - TAR
The name of the Zen server installation package uses the conventions in the following table.
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First-Time Zen Server Installation on Linux and Raspbian
The 64-bit installation scripts perform the following tasks:
• Verify necessary permissions to complete install
• Create user zen-svc and group zen-data if they do not exist
• Sets user:group ownership to zen-svc:zen-data for the installed files if not already set
To install a Zen Server on Linux or Raspbian using TAR
1. Log in as the root user.
2. Change to the /usr/local directory.
cd /usr/local
3. Enter the following command to copy the .tar file to /usr/local.
For example, if you downloaded the installation package to /home/bholly:
cp /home/bholly/<server_package_name> .
4. Unpack the .tar file using the following command.
tar -zxf <server_package_name>
5. Change directories to the /usr/local/actianzen/etc folder where the installation scripts reside.
cd actianzen/etc
6. Run the preinstallation script:
./preinstall.sh
7. Run the postinstallation script:
./postinstall.sh
The installation is complete. For additional information, see
Installing Zen Using TAR.
Upgrading a Zen Server Installation on Linux and Raspbian
If you have a previous version of Zen already installed, you must uninstall that version and then install the new Zen product. See
Uninstalling Zen on Linux, macOS, or Raspbian for more information.
Installing a Zen Server on macOS - TAR
The name of the Zen server installation package uses the conventions in the following table.
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First-Time Zen Server Installation on macOS
The 64-bit installation scripts perform the following tasks:
• Verify necessary permissions to complete install
• Create user zen-svc and group zen-data if they do not exist
• Sets user:group ownership to zen-svc:zen-data for the installed files if not already set
To install a Zen Server on macOS using TAR
You must be logged in as a user with administrator rights to use the sudo command.
1. Open a terminal window by entering terminal in a Spotlight search.
2. At the prompt, enter a sudo command like the following to gain administrative rights to install applications:
sudo -i bash -l
3. Zen installation requires a /usr/local directory. Use the following command to create it:
mkdir /usr/local
4. Change directories to the newly created location.
cd /usr/local
5. Unpack the .tar file using the tar command.
For example, if you downloaded the installation package to your Desktop:
tar -zxf /Users/<name>/Desktop/<server_package_name>
6. Change directories to /usr/local/actianzen/etc where the installation scripts reside.
cd actianzen/etc
7. Run the preinstallation script:
./preinstall.sh
8. Run the postinstallation script:
./postinstall.sh
The installation is complete. For additional information, see
After Installing Zen on Linux, macOS, or Raspbian.
Upgrading a Zen Server Installation on macOS
If you have a previous version of Zen already installed, you must uninstall that version and then install the new Zen product. See
Uninstalling Zen on Linux, macOS, or Raspbian for more information.
Installing Zen Client for Linux and Raspbian - TAR
The name of the Zen Client installation package uses the conventions in the following table.
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First-Time Client Installation on Linux and Raspbian
If you need to provide 32-bit client access for an application, you must install the Zen Client 64-bit first, and then add Zen Client Access 32-bit. The installation steps are the same except for the pre- and post-installation scripts, as described below. Note that 32-bit client access does not apply to Raspbian systems.
To install Zen Client for Linux Using TAR
1. Log in as the root user.
2. Change to the /usr/local directory.
cd /usr/local
3. Enter the following command to copy the .tar file to /usr/local.
For example, if you downloaded the installation package to /home/bholly:
cp /home/bholly/<client_package_name> .
4. Unpack the .tar file using the following command.
tar -zxf <client_package_name>
The unpacking action creates a directory named zenclient.
5. Change directories to the /usr/local/actianzen/etc folder where the Zen installation scripts reside.
cd actianzen/etc
6. Run the preinstallation script needed by the client package that you are installing:
• Client 64-bit: ./clientpreinstall.sh
or
• Client Access 32-bit: ./clientaccesspreinstall.sh
7. Run the postinstallation script needed by the client package that you are installing:
• Client 64-bit: ./clientpostinstall.sh
or
• Client Access 32-bit: ./clientaccesspostinstall.sh
Upgrading a Client Installation on Linux and Raspbian
If you have a previous version of Zen already installed, you must uninstall that version and then install the new version. See
Uninstalling Zen on Linux, macOS, or Raspbian for more information.
Installing Zen Client for macOS - TAR
The name of the Zen Client installation package uses the conventions in the following table.
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First-Time Client Installation on macOS
To install Zen Client for macOS using TAR
You must be logged in as a user with administrator rights to use the sudo command.
1. Open a terminal window by entering terminal in a Spotlight search.
2. At the prompt, enter a sudo command like the following to gain administrative rights to install applications:
sudo -i bash -l
3. Zen installation requires a /usr/local directory. Use the following command to create it:
mkdir /usr/local
4. Change directories to the newly created location.
cd /usr/local
5. Unpack the .tar file using the tar command.
For example, if you downloaded the installation package to your Desktop:
tar -zxf /Users/<name>/Desktop/<client_package_name>
The unpacking action creates a directory named zenclient.
6. Change directories to the /usr/local/actianzen/etc folder where the Zen installation scripts reside.
cd actianzen/etc
7. Run the preinstallation script needed by the client package that you are installing:
./clientpreinstall.sh
8. Run the postinstallation script needed by the client package that you are installing:
./clientpostinstall.sh
Upgrading a Client Installation on macOS
If you have a previous version of Zen already installed, you must uninstall that version and then install the new version. See
Uninstalling Zen on Linux, macOS, or Raspbian for more information.
Installing Zen Using DMG on macOS
On macOS, you can install Zen using a native Apple disk image (DMG). A DMG is a container file commonly used to distribute applications for macOS.
The following topics explain how to install Zen products using DMG:
If you have any trouble with installation, see
Troubleshooting After Installation.
Installing a Zen Server on macOS - DMG
The name of the Zen server DMG uses the conventions in the following table.
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First-Time Zen Server Installation on macOS
The 64-bit installation scripts perform the following tasks:
• Verify necessary permissions to complete install
• Create user zen-svc and group zen-data if they do not exist
• Sets user:group ownership to zen-svc:zen-data for the installed files if not already set
To install a Zen Server on macOS using DMG
1. Copy the .dmg file to your system.
2. Double-click the file to mount the disk image and open a window that shows three items:
• Zen installer
• Readme file containing release notes in HTML
• License agreement in PDF
3. To open the installer, double-click it and then follow the instructions.
4. When asked, enter an account name and password with administrator rights.
5. When the installer displays the dialog saying that Zen has been installed, you can click Show Me to see it or click Continue.
6. In the dialog offering information about Zen, you can click Show Me to see it or click Continue to unmount the .dmg file and finish.
The installation is complete. For possible next steps, see
After Installing Zen on Linux, macOS, or Raspbian.
Upgrading a Zen Server Installation on macOS
If you have a previous version of Zen already installed, you must uninstall that version and then install the new version. See
Uninstalling Zen on Linux, macOS, or Raspbian for more information.
Installing Zen Client for macOS - DMG
The name of the Zen Client DMG uses the conventions in the following table.
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First-Time Client Installation on macOS
To install Zen Client for macOS using DMG
1. Copy the .dmg file to your system.
2. Double-click the file to mount the disk image and open a window that shows three items:
• Zen installer
• Readme file containing release notes in HTML
• License agreement in PDF
3. To open the installer, double-click it and then follow the instructions.
4. When asked, enter an account name and password with administrator rights.
5. When the installer displays the dialog saying that Zen has been installed, you can click Show Me to see it or click Continue.
6. In the dialog offering information about Zen, you can click Show Me to see it or click Continue to unmount the .dmg file and finish.
Upgrading a Client Installation on macOS
If you have a previous version of Zen already installed, you must uninstall that version and then install the new version. See
Uninstalling Zen on Linux, macOS, or Raspbian for more information.
After Installing Zen on Linux, macOS, or Raspbian
The following topics may be useful after you install Zen on Linux, macOS, or Raspbian:
Verifying Installed Products with RPM
The following table provides commands with which you can verify which packages the RPM packager installed. The commands are case sensitive.
Verifying Database Engine is Running
Optionally, after the installation script finishes, you can verify that the database engine is running with the ps command. To do this, enter the following at a command prompt:
ps -e | egrep mkded
Server Configuration
Generally, the default configuration settings for Zen Enterprise Server and Cloud Server are sufficient. See
Configuration for settings that you may want or need to set.
If you want to explore all of the configuration settings, see
Configuration Reference in
Advanced Operations Guide.
Client Configuration
All configuration settings for Zen Client are discussed in
Linux, macOS, and Raspbian Client Configuration Properties in
Advanced Operations Guide.
Linux, macOS, and Raspbian Clients and the Monitor Utility
This information applies only to Linux, macOS, or Raspbian clients that use a static IP address. Ignore it if you use DHCP and have a DSN to resolve named addresses.
When you monitor clients using the Zen Monitor utility, the client IP address that gets transmitted across the network originates from the hosts file. If the system name and IP have not been added to the hosts file, network communication uses the local host IP address, which is 127.0.0.1 or ::1 (a loopback address).
If you change the loopback address to the correct IP, or if you add the system name and IP to the hosts file on the client, the client name is displayed correctly in the Monitor utility.
Licensing
Once you have completed installation, you may need to update your license to increase the user count for Zen Enterprise Server, or to increase the session count or data in use limits for Cloud Server. See
Increase User Count or Data in Use in
Zen User’s Guide.
Common Questions After Installation
If you have problems with your installation, see
Troubleshooting After Installation or get help online from the Zen knowledge base at the
Actian website. The following are common questions after installation of the products:
Where Do Files Reside After Installing Zen on Linux, macOS, and Raspbian?
The following table lists the primary directories and files that result from installation on Linux, macOS, or Raspbian. $ACTIANZEN_ROOT refers to the root directory where the files are installed. By default it is set to /usr/local/actianzen. Unless otherwise noted, the primary directories and files are the same for 32- and 64-bit products.
For an upgrade installation, your existing Zen files were updated to the latest versions.
How Do I Access the Documentation?
The documentation installed with Zen includes the following:
• Man pages for command line utilities
• Documentation Library
• Release Notes
Man Pages
Man pages are provided for the command line utilities. To make these man pages available, add $ACTIANZEN_ROOT/man to the MANPATH environment variable.
Man pages are installed with Zen Enterprise Server, Cloud Server, and Client. Command line utilities are also covered in the user documentation.
Documentation Library
The Zen documentation library contains the complete set of user documentation, including the user documentation for the Zen engine and software development kit.
The documentation library is integrated into Zen Control Center (ZenCC). You can access the documentation library in the Welcome tab opened from the Help menu or by pressing F1 (Windows) or Shift F1 (Linux) to open context-sensitive topics.
Release Notes
The release notes in readme_zen.htm contain general information about the release, sometimes including late-breaking advice not yet covered in the user documentation. These release notes are located in the /usr/local/actianzen/docs/ directory and are linked in the Welcome tab opened from the Help menu in ZenCC. The
Actian website posts the latest version of the release notes.
What If I Get Errors Trying to Start the Utilities?
Uninstalling Zen on Linux, macOS, or Raspbian
The following topics explain how to remove Zen from your system.
Removing a Zen RPM Package
The following table lists the RPM commands to uninstall Zen packages on Linux. You must log in as the root user using the su command before executing any of the commands.
Note: Uninstalling does not remove the system databases DEFAULTDB and PERVASIVESYSDB.
Removing a Zen TAR Package
This topic provides a table that lists the shell scripts used to remove various Zen installations. The uninstalling of a TAR package is slightly different for Linux, macOS, and Raspbian, as shown in the following steps.
To uninstall a Zen TAR installation on Linux and Raspbian
1. At a command prompt, log in as the root user using the su command.
2. Change directories to the /usr/local/actianzen/etc folder where the Zen installation scripts reside.
cd /usr/local/actianzen/etc
3. Use the uninstall scripts from the following table that apply to your installation.
To uninstall a Zen TAR installation on macOS
You must be logged in as a user with administrator rights to use the sudo command.
1. Open a terminal window by entering terminal in a Spotlight search.
2. At the prompt, enter a sudo command like the following to gain administrative rights to install applications:
sudo -i bash -l
3. Change directories to the /usr/local/actianzen/etc folder where the Zen installation scripts reside.
cd /usr/local/actianzen/etc
4. Use the uninstall scripts from the following table that apply to your installation.
Note: Uninstalling does not remove the system databases DEFAULTDB and PERVASIVESYSDB.
Removing a Zen DMG
1. In Finder, open Applications > Actian Zen vxx and double-click Zen Uninstaller.
2. The uninstaller displays a notice about license keys remaining authorized. Do one of the following:
• Click
Cancel to exit from the uninstaller if you need to manage your product keys before continuing. For more information, see
License Administration Tasks in
Zen User’s Guide.
or
• Click Continue.
3. When asked, enter an account name and password with administrator rights.
4. When the installer displays the dialog saying that Zen has been uninstalled, click OK.
Note: Uninstalling does not remove the system databases DEFAULTDB and PERVASIVESYSDB.