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.
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.

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.
      - 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.
        ON-Bar security
        By default, only the informix or root users on UNIX™ system or members of the Informix-Admin group on Windows™ systems can run commands.
      - 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 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.

You can configure the behavior of ON-Bar by setting the following configuration parameters and environment variable.

Table 1. ON-Bar configuration parameters and environment variable
Behavior	Configuration parameters
Control the number and size of data buffers and the number of parallel processes.	BAR_NB_XPORT_COUNT configuration parameter BAR_XFER_BUF_SIZE configuration parameter IFX_BAR_NO_LONG_BUFFERS environment variable BAR_MAX_BACKUP configuration parameter BAR_MAX_RESTORE configuration parameter
Set the debugging level and the location of debug log file.	BAR_DEBUG configuration parameter BAR_DEBUG_LOG configuration parameter
Change the path of the ON-Bar boot file.	BAR_IXBAR_PATH configuration parameter
Maintain a history of expired backups.	BAR_HISTORY configuration parameter
Change the location and contents of ON-Bar activity log.	BAR_IXBAR_PATH configuration parameter
Maintain a history of expired backups.	BAR_ACT_LOG configuration parameter BAR_PROGRESS_FREQ configuration parameter BAR_PERFORMANCE configuration parameter
Set automatic retrying of failed back ups or restores.	BAR_RETRY configuration parameter
Allow a failed restore to be restarted.	RESTARTABLE_RESTORE configuration parameter
Increase backup size estimate sent to the storage manager.	BAR_SIZE_FACTOR configuration parameter
Extend the time an RS secondary server waits for a checkpoint during an external backup.	BAR_CKPTSEC_TIMEOUT configuration parameter
Configure continuous log backup.	ALARMPROGRAM configuration parameter
Filter or transform backed up data with an external program.	BACKUP_FILTER configuration parameter ids_bar_176.html
Optimize the deduplication capabilities of storage managers.	IFX_BAR_USE_DEDUP environment variable
Disable the ability to replicate, import, or export backup objects among TSM servers.	IFX_TSM_OBJINFO_OFF environment variable
Force the use of the sm_versions file.	IFX_BAR_NO_BSA_PROVIDER environment variable

Do not set the LTAPEDEV configuration parameter to /dev/null or NUL because logical-log backups would be disabled and you can restore only whole-system backups.