1) Install Informix

a. Select option to create an instance during installation. If installing Informix 12.10, it would create a
server/instance with name ol_informix1210
b. For the rest of this document we assume Informix
i. install location as INFORMIXDIR=/opt/IBM/Informix
ii. server/instance name as INFORMIXSERVER=ol_informix1210
2) cd /opt/IBM/Informix
a. There should two shell script files ol_informix1210.ksh & ol_ informix1210.csh. Execute one of them.
Eg: . ol_informix1210.ksh
3) Check /etc/services
a. There should be two Informix related entries. One for the regular Informix access and one for the
Mongo/JSON wire listener access. For instance it would be something as follows:
ol_informix1210

9088/tcp

#Use for standard client TCP access

ol_informix1210_json

27256/tcp

#For JSON

4) cd INFORMIXDIR/etc
a. There should be an INFORMIXSQLHOSTS file named sqlhosts. INFORMIXSERVER. In this file there should
be some entries, the two main for our purposes could be as follows:
ol_informix1210

olsoctcp

mon_ol_informix1210

localhost

olsoctcp

ol_informix1210

localhost

ol_informix1210_json

b. There should be a configuration file named onconfig. INFORMIXSERVER

i. Edit the DBSERVERALIASES parameter to point to mon_ol_informix1210

DBSERVERALIASES

mon_ol_informix1210

5) If there are no/missing entries as mentioned in steps 3 & 4 above, please add them.
a. NOTE: ensure the port numbers you pick are ones that are not in use already
6) During installation, a user ifxjson should have been created and you would have been prompted to create the
password for the same.
a. If not, then create user ifxjson.
b. Give this user admin privileges using the DB-Access utility
i. From your console, enter dbaccess sysadmin
ii. Press enter/return key twice
iii. Paste the following:
execute function task ("grant admin", "ifxjson", "Replication");

iv. Hit the Esc key and hit the enter/return key to run the above task
v. This will give user ifxjson admin privileges
vi. Exit out of DBAccess utility by pressing letter E on keyboard until you get back to your
command prompt
7) Bounce the Informix engine
a.
b.

onmode ky
oninit

8) Start the Informix Mongo-interop wire listener

a. First ensure the properties file is set properly
i. cd $INFORMIXDIR/etc
ii. You should see a file: jsonListener.properties
1. It should have at least the following two parameters set: listener.port & url. If not, enter
something as follows:

a.

listener.port=37017

b.

url=jdbc:informix-sqli://localhost:37017/sysmaster:INFORMIXSERVER=mon_ol_informix1210

b. From the console, enter

i.

java jar $INFORMIXDIR/bin/jsonListener.jar config $INFORMIXDIR/etc/jsonListener.properties logfile

$INFORMIXDIR/jsonListener.log -start

c. This will start the wire listener.

9) You should see the newly created log file:
10)

$INFORMIXDIR/jsonListener.log

You can verify it is working by

a. if you already have MongoDB installed, you can enter the command: mongo port 37017 to start the
Mongo command shell that will connect to the Informix server.
b. If you have Meteor installed,
i. Set environment variable MONGO_URL=mongodb://localhost:37017/test
1. Where 37017 is the port number specified in the jsonListener.properties file
2. test is a database name. This can be whatever DB you want to connect to.