Welcome
Administering
In addition to administering the database server, you can tune performance, replicate data, and archive data.
Backup and Restore Guide
The HCL® Informix® Backup and Restore Guide describes how to use the HCL Informix and ontape utilities to back up and restore database server data. These utilities enable you to recover your databases after data is lost or becomes corrupted due to hardware or software failure or accident.
ON-Bar backup and restore system
Configure the storage manager and ON-Bar
The topics in this section provide the information that you need to plan and to set up with a storage manager.
Configure a storage manager
ON-Bar backup and restore operations require a storage manager that integrates with ON-Bar through an XBSA shared library interface.
Configuring Spectrum Protect
To use IBM® Spectrum Protect with HCL Informix® databases, you must install and configure the IBM Spectrum Protect client on your database server computer and IBM Spectrum Protect on your storage computer.

HCL Informix® V15.0.0 documentation
Welcome to the documentation for HCL Informix® 15.0.0 and related client tools and products.
Product overview
HCL Informix® is a fast and scalable database server that manages traditional relational, object-relational, and dimensional databases. Its small footprint and self-managing capabilities are suited to embedded data-management solutions.
Installing
These topics describe how to install HCL Informix® database servers, client products, and modules.
Administering
In addition to administering the database server, you can tune performance, replicate data, and archive data.
- System administration
  These topics contain concepts, procedures, and reference information for database and database server administrators to use for managing and tuning HCL Informix® database servers.
- Backup and Restore Guide
  The HCL® Informix® Backup and Restore Guide describes how to use the HCL Informix and ontape utilities to back up and restore database server data. These utilities enable you to recover your databases after data is lost or becomes corrupted due to hardware or software failure or accident.
  - Overview of backup and restore
    These topics provide an overview of backup and restore concepts. They also provide information about planning for backup and restore operations.
  - ON-Bar backup and restore system
    - Overview of the ON-Bar backup and restore system
      consists of various components and it works with a storage manager to back up and restore data.
    - Configure the storage manager and ON-Bar
      The topics in this section provide the information that you need to plan and to set up with a storage manager.
      - Configure a storage manager
        ON-Bar backup and restore operations require a storage manager that integrates with ON-Bar through an XBSA shared library interface.
        Determine what storage devices you need
        Before backing up, determine what and how many storage devices you need.
        Storage-manager definitions in the sm_versions file
        Most storage managers must have an entry in the sm_versions file.
        Non-IBM storage managers
        supports some third-party storage managers that can manage stackers, robots, and jukeboxes and simple tape and disk devices.
        Configuring a third-party storage manager
        Storage managers have slightly different installation and configuration requirements. If you use a third-party storage manager, make sure that you follow the manufacturer instructions carefully. If you have difficulty with the storage-manager installation and configuration, contact the manufacturer directly.
        Configuring Spectrum Protect
        To use IBM® Spectrum Protect with HCL Informix® databases, you must install and configure the IBM Spectrum Protect client on your database server computer and IBM Spectrum Protect on your storage computer.
        Editing the Spectrum Protect client options files
        The HCL® Informix® Interface for Spectrum Protect communicates with the Spectrum Protect server with the Spectrum Protect API. By default, HCL Informix Interface for Spectrum Protect uses the client user options file (dsm.opt) and, on UNIX™ systems, the client system options file (dsm.sys), both of which are located in the Spectrum Protect API installation directory.
        Assigning a Spectrum Protect management class for a backup
        When you back up a database, the default management class for your node is used. You can override the default value with a different value that is specified in the INCLUDE option.
        Setting the HCL Informix® Interface for Spectrum Protect environment variables
        When you use the HCL Informix® Interface for TSM, you need to set certain environment variables in the environment of the user.
        Registering with the Spectrum Protect server
        Before backing up to and recovering from an IBM® Spectrum Protect server, you must have a Spectrum Protect registered node name and a password. The process of setting up a node name and password is called registration.
        Initializing the HCL Informix® Interface for Spectrum Protect password
        To initialize the password for HCL Informix® Interface for Spectrum Protect, use the txbsapswd program. This program sets up a connection with the server instance that you specified in the dsm.opt file.
        Updating the storage-manager definition in the sm_versions file for Spectrum Protect
        You must update the storage-manager definition in sm_versions file for to use with IBM® Spectrum Protect.
        Configuring ON-Bar for optional Spectrum Protect features
        You can configure ON-Bar to enable or disable optional features in IBM® Spectrum Protect.
        Backup to Commvault storage manager using ON-Bar
        You can use ON-Bar to back up and restore data to or from the Commvault storage manager. User is responsible for terms and any charges associated with your use of the Commvault storage manager.
        Specifying the location of the XBSA Library
        By default, looks for the XBSA shared library in $INFORMIXDIR/lib/ibsad001.s[ol] on UNIX™. To specify a different name or location of the XBSA shared library, use the BAR_BSALIB_PATH configuration parameter.
      - Validating your storage manager
        When you convert or revert the HCL® Informix® database server, the storage manager that you used on the old version might not be validated for the version that you are migrating to. Verify that the storage-manager vendor successfully completed the HCL Informix validation process for the database server version and platform.
      - Configuring ON-Bar
        Before you begin your first backup, review the default parameters in the onconfig file and adjust the values as needed. You can also set an environment variable.
      - Verifying the configuration of ON-Bar and your storage manager
        Before you begin using and your storage manager, make sure that and your storage manager are set up correctly.
      - Files that ON-Bar and storage managers use
        , HCL Informix® Primary Storage Manager, and IBM® Spectrum Protect use particular files in your installation.
    - Back up with ON-Bar
      You can use the utility to back up and verify storage spaces (dbspaces, blobspaces, and sbspaces) and logical-log files.
    - Restore data with ON-Bar
      You can use the ON-Bar utility to restore data that was backed up by the ON-Bar utility.
    - External backup and restore
    - Customize and maintain ON-Bar
    - ON-Bar catalog tables
      These topics describe the tables that are stored in the sysutils database.
    - ON-Bar messages and return codes
      prints informational, progress, warning, and error messages to the activity log file. return codes indicate the status of the command.
  - ontape backup and restore system
  - Backup and restore a Remote Secondary Server(RSS)
  - Integrated Backup Encryption
    These topics provide information about Integrated Backup Encryption.
  - HCL Informix® Primary Storage Manager
    HCL Informix® Primary Storage Manager is an application that manages storage devices used for backup and restore requests that are issued by . This storage manager supports both serial and parallel processing for backup and restore requests.
  - archecker table level restore utility
  - Backup and restore configuration parameter reference
  - Cloud Backup
    These topics provide information about storing and retrieving the backups directly to the ecosystem of selected cloud providers, namely Amazon S3 and Softlayer Object Storage.
  - Appendixes
- Enterprise Replication
  The describes the concepts of data replication using HCL Informix® Enterprise Replication, including how to design your replication system, as well as administer and manage data replication throughout your enterprise.
Migrating and upgrading
You can upgrade to the 15.0.0 release of HCL Informix® or migrate from other database servers to Informix. Upgrading is an in-place migration method that uses your existing hardware and operating system software. Some changes to the Informix database server can affect upgrading from a previous release.
Client APIs and tools
You can use the HCL Informix® implementation of client APIs to develop applications for Informix database servers.
Embedding Informix®
When you embed HCL Informix®, you can use enterprise-class high-availability and high performance with embeddability features such as easy programmability, a small disk and memory footprint, and silent deployment.
Extending Informix®
Beyond standard relational database objects, HCL Informix® can be extended to handle specialized data types, access methods, routines, and other objects. Informix includes many built-in extensions that are fully integrated in the database server. Informix also provides modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for Informix.
Data warehousing
In addition to designing and implementing Informix® dimensional databases, you can use tools to create data warehouse applications and optimize your data warehouse queries.
Designing databases
The first step in creating a relational database is to construct a data model, which is a precise, complete definition of the data you want to store. After you prepare your data model, you must implement it as a database and tables. To implement your data model, you first select a data type for each column and then you create a database and tables and populate the tables with data. You can also implement fragmentation strategies and control access to your data.
JSON compatibility
You can use the popular JSON-oriented query language created by MongoDB to interact with data stored in HCL Informix®.
Security
You can secure your Informix® database server and the data that is stored in your Informix databases. You can encrypt data, secure connections, control user privileges and access, and audit data security.
SQL programming
You can use the HCL Informix® implementation of the SQL language to develop applications for Informix database servers.
Troubleshooting HCL Informix®
Several troubleshooting techniques, tools, and resources are available for resolving problems that you encounter in your HCL Informix® database server environment.

Configuring Spectrum Protect

To use IBM® Spectrum Protect with HCL® Informix® databases, you must install and configure the IBM Spectrum Protect client on your database server computer and IBM Spectrum Protect on your storage computer.

You must also configure HCL® Informix® Interface for Spectrum Protect and perform other Spectrum Protect configuration tasks on your HCL® Informix® database server computer.

Starting with versions 8.1.2 and 7.1.8, IBM Spectrum Protect requires SSL communication between the client and the server, and therefore additional configuration steps must be followed:

To configure Spectrum Protect:

Edit the Spectrum Protect client options files.
Assign a Spectrum Protect management class for the server to use for backups.
Set the HCL® Informix® Interface for Spectrum Protect environment variables.
Register with the Spectrum Protect server.
Initialize the HCL® Informix® Interface for Spectrum Protect.
Optional. Configure ON-Bar to support optional Spectrum Protect features.

The version of the XBSA shared library for Spectrum Protect is 1.0.3.

For details about Spectrum Protect, read the following manuals:

IBM Spectrum Protect Backup-Archive Clients Installation and User's Guide
IBM Spectrum Protect Using the Application Program Interface
IBM Spectrum Protect Administrator's Guide
IBM Spectrum Protect Administrator's Reference