Start the multiplex write server in single node mode

To ensure a smooth multiplex migration, start the write server in single node mode to clean internal state information. To do this, start the writer node in single node mode, then shutdown, start up again normally, and shut down.

Start the writer node with the server arguments -gm 1 and -iqmpx_sn 1:

-gm 1 -iqmpx_sn 1

If you use administrative startup scripts, create a copy of the start_server script to start the write server you want to migrate.

For example, copy the existing file start_server to a new file called start_server_single_node.

Suppose that start_server contains the following startup command:

start_asiq -STARTDIR /work/iq-127/mpx/main @/work/iq-
127/mpx/main/params.cfg -n mpx_main $readonly $nomain -
x tcpip{port=62631} /work/iq-127/mpx/main/main.db
$dbkey

Add the two single node startup arguments to change the preceding command as follows in start_server_single_node:

start_asiq -STARTDIR /work/iq-127/mpx/main @/work/iq-
127/mpx/main/params.cfg -n mpx_main -gm 1 - iqmpx_sn 1 
$readonly $nomain -x tcpip{port=62631} /work/iq-127/
mpx\main/main.db $dbkey

There are now two script files, start_server and start_server_single_node that you will use to put the server into a good state for migration:

  1. Start the writer node with start_server_single_node.

  2. Shutdown the writer node.

  3. Start the writer node with start_server.

  4. Shut down the writer node.