system_mapping

This option maps domain names or IP addresses to names displayed on web pages and stored in the database. It can be best illustrated by the following example:

'system_mapping' => array(
    '192.168.47.25' => array(
        'name' => 'DEMO',
        'id'   => 'DEMO_ID'
    ),
    '192.168.47.14' => array(
        'name' => 'SYSH',
        'id'   => 'SYSH_ID'
    ),
    'SYSH1' => array(
        'name' => 'SYSH1',
        'id'   => 'SYSH1_ID'
    ),
    'SYSH2' => array(
        'name' => 'SYSH2',
        'id'   => 'SYSH2_ID'
    ),
),

There are 4 systems defined in this example. First two by IP addresses and last two by domain names.

The name parameter contains a text displayed on the web page (in select boxes for instance). The id parameter is stored to the database. You should never edit id once it has been used at least once. This is because every member stored in the database is uniquely identified by the system id, dataset name and member. If you want for some reason to edit a name of a system that has already been used in a process in the past, you can edit the name parameter, but never its id.

Sometimes it can be useful (mainly for testing) to have two different system names but the same IP address. It can be achieved by the following syntax, there is one more array level (SYSH and SYSH_COPY use the same IP address):

'system_mapping' => array(
    '192.168.47.25' => array(
        'name' => 'DEMO',
        'id'   => 'DEMO_ID'
    ),
    '192.168.47.14' => array(
        array(
            'name' => 'SYSH',
            'id'   => 'SYSH_ID'
        ),
        array(
            'name' => 'SYSH_COPY',
            'id'   => 'SYSH_COPY_ID'
        )
    )
),