Rocket iCluster



    Posted 09-14-2020 14:43
    Edited by Mark Watts 09-21-2020 15:05

    Rocket iCluster includes a configuration 'fast start' command to perform some of the configuration steps based on a typical installation.  This command, DMAUTOCFG, can assist in defining a node pair, some replication groups, selections of objects for replication and set some iCluster product system values.  The command was designed for administrators that will be setting up a two node cluster and the resulting low-complexity configuration can be a reasonable starting point.  Once the config is up and running, more customization can be easily performed.  Note: This procedure is only one of the ways to add selections to an existing replication group.  (See DMWRKGRP for another starting place for Group Administration.)

    The iCluster command DMAUTOCFG is great for initially configuring your iCluster environment, and can be used even after you are up and running.

    You may have added new libraries or applications to your IBM i and may be wondering what else is out there on your system that could be added to iCluster. DMAUTOCFG will show you a list of all libraries on your system so you can see what's out there. But if you or your consultant did not use DMAUTOCFG to initially configure the product, DMAUTOCFG checks to see if it is the first run or subsequent run, so if you have never used this command, you can set the environment so it will run for this example!

    DMAUTOCFG will not run for this example unless the data area AICSECRUN exists as described below.

    • Create a data area called AICSECRUN in the iCluster product library 'iCluster' of type *CHAR and length 1, with initial value Y.

    To add new libraries to existing groups:

    1. Best to start with the latest available iCluster version and fix pack from the Rocket Community.
    2. End the replication groups you will be adding a new selection to. (other groups can remain active)
    3. Run DMAUTOCFG and specify the existing primary and backup nodes
    4. Specify two existing groups to which you want to add new object specifiers
      1. The first you select will be considered Primary
      2. The second group you specify will be considered Secondary
      3. Note: Primary and Secondary has no special meaning, just think group #1 and group #2 in the command usage.
    5. Hit PF10 and page down to get the additional parameters for the command.
    6. Specify *YES for "Select object specifiers only" and *NO for Object spec. library size.  NOTE: This command can also retrieve and calculate the number of objects and total size of all the libraries if desired.  If there are a large number of libraries on the system, the command could take a significant amount of time before it completes the retrieval and displays the result..
    7. Hit Enter and the command will show a list of all libraries on your system (and optionally their size).   You can safely cancel the command at this point if required and run it again with different options.
    8. You can then use P or S to select individual libraries to add to the primary group or secondary groups respectively.
    9. Press PF6 to process your selections and review the updated group selections to verify your desired result.
    10. Now that these groups that have been modified with new selections, they can be started normally ( DMSTRGRP, no special options ).
    11. Once the group(s) is fully started again, run *OBJATTER Sync Checks and activate the new objects (resulting in NFD exceptions) to refresh them over the communications link to the backup Node.

    Mark Watts
    Rocket Software