Installing files on a QNX Neutrino or embedded Linux mobile device

This section describes how to install DB2 Everyplace on a QNX Neutrino or embedded Linux mobile device. These mobile devices take various forms. Depending on the type of mobile device that you have, there are several installation options:

For additional information on transferring files to your mobile device, see the documentation provided with the mobile device. QNX Neutrino users can also consult the QNX Neutrino Software Developer's Kit (SDK).

Procedure

  1. Install the DB2 Everyplace database files. DB2 Everyplace database files for QNX Neutrino and embedded Linux mobile devices are located in the following directory: 
    %DSYINSTDIR%/Clients/Linux/database/proc
    where proc is your processor type.
  2. Install the DB2 Everyplace Sync Server and sample application files. To use the DB2 Everyplace Sync Server, you need to install the DB2 Everyplace Sync Server files with the DB2 Everyplace files included in the library path. Sync Server and sample application files are located in the following directories:

    For QNX Neutrino mobile devices:
    %DSYINSTDIR%/Clients/neutrino/sync

    For Linux mobile devices:
    %DSYINSTDIR%/Clients/linux/sync
  3. Copy the following library files and the goISync sample application for the appropriate processor into user\lib\DB2e\: 
    libisyncxpt.so
libimsaconfig.so
libimsadb2e.so
libimsafile.so
libisyncore.so
libisyncconf.so
libwbxml.so
goISync

Setting the environment variable

Set the environment variable, LD_LIBRARY_PATH, to the path where the DB2 Everyplace CLI shared library (libdb2e.so) was installed. For example, if the DB2 Everyplace CLI shared library is stored in /DB2e/database/x86, append /DB2e/database/x86 to your existing LD_LIBRARY_PATH using the following statement: 

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/DB2e/database/x86

Setting up encryption support

This section applies only to QNX Neutrino mobile devices. To enable encryption on a QNX Neutrino device, the mqueue process must be started.

  1. To ensure the mqueue process is running, type: ps. A list of active processes is displayed on the device.
  2. Verify that mqueue is listed. If not, use the mqueue command to start the process.

If the application terminates unexpectedly after you initialized the encryption library, the library could be corrupted.

Running sample applications

Sample applications are included with the DB2 Everyplace database and the DB2 Everyplace Sync Server packages.

See Overview of DB2 Everyplace sample applications for more information on DB2 Everyplace sample applications for QNX Neutrino and Linux.

You can run the DB2 Everyplace Sync Server sample, goISync, from the directory where it is installed. After the first run, a subdirectory /data is created in this directory.

When you launch goISync for the first time, configure the settings for synchronization. To configure the settings:

  1. When goISync starts for the first time, select Change server settings.
  2. Enter values that are associated with your Sync Server or Sync Server client Neutrino device for Server IP, Server Port, Username, and Password fields.

You are now ready to synchronize.

Related tasks

Related reference