Welcome
Administering
In addition to administering the database server, you can tune performance, replicate data, and archive data.
Backup and Restore Guide
These topics describe how to use the Informix® ON-Bar 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 ON-Bar 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 ISM
You can use the Informix® Storage Manager (ISM) with ON-Bar.
Updating the storage-manager definition in sm_versions file for use with ISM
Before ON-Bar starts a backup or restore process, it calls the currently installed version of the storage-manager-specific XBSA shared library to get its version number. If this version is compatible with the current version of ON-Bar and is defined in the sm_versions file, ON-Bar begins the requested operation.

HCL Informix® V14.10 documentation
Welcome to the documentation for HCL Informix® 14.10 and related client tools and products. The current fix pack level of Informix is 14.10.xC12.
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 DataBlade® 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
  These topics describe how to use the Informix® ON-Bar 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
      ON-Bar 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 ON-Bar 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.
        Configuring ISM
        You can use the Informix® Storage Manager (ISM) with ON-Bar.
        ISM environment variables and onconfig parameters
        When you use ISM, you must set the required environment variables in the onbar script or in your environment.
        Updating the storage-manager definition in sm_versions file for use with ISM
        Before ON-Bar starts a backup or restore process, it calls the currently installed version of the storage-manager-specific XBSA shared library to get its version number. If this version is compatible with the current version of ON-Bar and is defined in the sm_versions file, ON-Bar begins the requested operation.
        Non-IBM storage managers
        ON-Bar 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 Spectrum Protect with Informix® databases, you must install and configure the Spectrum Protect client on your database server computer and Spectrum Protect on your storage computer.
        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, ON-Bar 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 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 Informix validation process for the database server version and platform.
      - Configuring ON-Bar
      - Verifying the configuration of ON-Bar and your storage manager
        Before you begin using ON-Bar and your storage manager, make sure that ON-Bar and your storage manager are set up correctly.
      - Files that ON-Bar and storage managers use
        ON-Bar, Informix® Primary Storage ManagerInformix Storage Manager (ISM), and Spectrum Protect use particular files in your installation.
    - Back up with ON-Bar
      You can use the ON-Bar 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 ON-Bar tables that are stored in the sysutils database.
    - ON-Bar messages and return codes
      ON-Bar prints informational, progress, warning, and error messages to the ON-Bar activity log file. ON-Bar 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.
  - Informix® Primary Storage Manager
    The Informix® Primary Storage Manager manages storage for ON-Bar backup and restore operations, including parallel backups, that use file devices (disks).
  - 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
  These topics describe the concepts of data replication using 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 14.10 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 DataBlade® 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.
Informix PDF guides

Updating the storage-manager definition in sm_versions file for use with ISM

Before ON-Bar starts a backup or restore process, it calls the currently installed version of the storage-manager-specific XBSA shared library to get its version number. If this version is compatible with the current version of ON-Bar and is defined in the sm_versions file, ON-Bar begins the requested operation.

Procedure

To update the storage-manager definition in sm_versions file:

Copy the sm_versions.std template to a new file, sm_versions in the $INFORMIXDIR/etc directory on UNIX™ or the %INFORMIXDIR%\etc directory on Windows™.
Issue the ism_startup -init command to automatically update sm_versions with the correct version number and storage-manager name or manually edit sm_versions.
Important: The ism_startup -init command erases records of previous backups.
If you are installing an ISM patch, you must manually edit sm_versions.
If you manually edit the sm_versions, you must put ism in the sm_name field.
Stop any ON-Bar processes (onbar_d, onbar_w, or onbar_m) that are currently running and restart them for the changes to take effect.

Example

The following example shows an ISM definition in the sm_versions file:

1|1.0.1|ism| ISM.2.20.UC1.114|