Creating a snapshot for deployment on Windows

The second task in the embeddability tutorial is to create a snapshot of the HCL OneDB™ install binary files and the dbspaces on the template computer by using the deployment assistant.

About this task

Prerequisites:

  • The HCL OneDB installation and an instance of it are on a template computer.
  • You must be logged in to the template computer as user informix or as a user with Administrator privileges.
  • In order to package dbspaces, the user must have CONNECT privileges to the sysadmin database. By default, only the user informix has this permission. If you log in as a user other than user informix, you must grant the CONNECT privilege to the sysdamin database for this user. This is a security mechanism implemented to protect the data.
  • Save copies of the files %INFORMIXDIR%\bin\ifxdeploy.exe and %INFORMIXDIR%\etc\ifxdeploy.conf files in a folder outside %INFORMIXDIR%. You will need these files when you deploy HCL OneDB on the target computer.
  • The HCL OneDB instance from which you want to create the snapshot is running.

Procedure

  1. Start a command window.
  2. Set the INFORMIXDIR and INFORMIXSERVER environment variables.

    For example, for the embeddability tutorial, specify:

    set INFORMIXDIR=C:\Program Files\IBM\Informix
set INFORMIXSERVER=demo_on
  3. Start the deployment assistant with the following command.

    For example, for the embeddability tutorial, specify:

    cd C:\Program Files\IBM\Informix\bin
ifxdeployassist
  4. Verify that the deployment assistant detects the HCL OneDB instance to be used as a template for the snapshot.
  5. Specify the full path name of the snapshot to be created.
    For the embeddability tutorial, specify C:\Documents and Settings\Administrator\Desktop\demo_on.zip.
  6. Optional: Clear the features or packages that you do not want to include in the snapshot to reduce the footprint.
    Important: The deployment assistant does not enforce any interdependencies between components of a functional instance.
  7. If you are prompted with the Data Spaces window, decide whether to include the dbspaces associated with the template HCL OneDB instance in the snapshot. Keep the Include the Data Spaces box checked if you are creating a snapshot following the embeddability tutorial.
    Tip: Record the full path names of the dbspaces if you select to include them in the snapshot. You will need to know the locations of the dbspaces when you deploy the snapshot.
  8. Review the deployment configuration summary.
  9. Record the information displayed in the Deployment Summary window and click Close . Save the information that you have recorded because you will need to know the snapshot locations for the next step.
  10. Save the snapshots that you created with the deployment assistant, the %INFORMIXDIR%\bin\ifxdeploy.exe file and the %INFORMIXDIR%\etc\ifxdeploy.conf file on external media (for example, a flash drive or CD). You will need these for the next task.

    For the embeddability tutorial: save the database server snapshot as demo_on.zip and the dbspaces snapshot as demo_on_db.zip.