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
External backup and restore
Data restored in an external restore
External restore commands

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.
    - 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
      - External backup and restore overview
        An external backup and restore eliminates the downtime of systems because the backup and restore operations are performed external to the HCL® Informix® system.
      - RS secondary server external backup
        You can perform an external backup of an RS secondary server. Performing a backup of an RS secondary server blocks that RS secondary server, but does not block the primary server.
      - Data restored in an external restore
        Rename chunks
        External restore commands
        Rules for an external restore
        External restores have specific rules.
      - Performing an external restore
      - Initializing HDR with an 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.

External restore commands

Use the onbar -r -e command to perform a warm or cold external restore. This command marks the storage spaces as physically restored and restores the logical logs. The following diagram shows the external restore syntax.

Figure 1. Performing an external restore with

Notes:

¹ See onbar -b syntax: Backing up


Element	Purpose	Key considerations
onbar -r	Specifies a restore	In a cold restore, if you do not specify storage space names, all of them are marked as restored.
-e	Specifies an external restore	Must be used with the -r option. In a warm external restore, marks the down storage spaces as restored unless the -O option is specified.
`dbspace_list`	Names one or more storage spaces to be marked as restored in a warm restore	If you do not enter `dbspace_list` or -f `filename` and the database server is online or quiescent, marks only the down storage spaces as restored. If you enter more than one storage-space name, use a space to separate the names.
-f`filename`	Restores the storage spaces that are listed in the text file whose path name `filename` provides	To avoid entering a long list of storage spaces every time, use this option. The `filename` can be any valid UNIX™ or Windows™ file name.
-n `last_log`	Indicates the number of the last log to restore	If any logical logs exist after this one, does not restore them and data is lost. The -n option does not work with the -p option.
-O	Restores online storage spaces	None.
-p	Specifies an external physical restore only	After the physical restore completes, you must perform a logical restore.
-t `time`	Restores the last backup before the specified point in time. If you pick a backup made after the point in time, the restore will fail.	You can use a point-in-time restore in a cold restore only. You must restore all storage spaces. How you enter the time depends on your current GLS locale convention. If the GLS locale is not set, use English-style date format.
-w	Performs a whole-system restore of all storage spaces and logical logs from the last whole-system backup	You must specify the -w option in a cold restore. If you specify onbar -r -w without a whole-system backup, return code 147 appears because cannot find any storage spaces backed up as part of a whole-system backup.