Previous Topic: Other Parameters

Next Topic: Add a New CA XCOM Gateway X509 Certificate

Configure Global Parameters Offline

Global parameters are stored externally in a file called xcom-globals.xml within the JBoss conf folder. This file is updated whenever parameters are changed using the Global Parameters page of the CA XCOM Gateway website. It is read when CA XCOM Gateway is started and its content at that time dictates the global parameters that are used. Therefore, when the file is updated, parameter changes do not take effect until the next time that CA XCOM Gateway is started.

As an alternative to updating the xcom-globals.xml file using the website facilities, it is also possible to edit this file using any suitable text editor. This method of changing global parameters can be used, for example, to correct parameter settings that prevent CA XCOM Gateway from starting.

The same xcom-globals.xml contains global parameters not only for CA XCOM Gateway, but also for the CA XCOM Interface Server and CA XCOM Management Center (if installed). Within the file, each product has its own section, which takes the form of a parent xml element embodying all of the attributes related to that product. When editing the file, it is important to ensure that only the correct section is modified and that sections relating to other products are left unchanged.

Important! We strongly recommend that a copy of the xcom-globals.xml file should always be saved before making any changes to the global parameters. Problematic changes can then be reversed by restarting CA XCOM Gateway after reinstating the saved file.

For security reasons, some global parameters are excluded from the website administration facilities and can be changed only by editing the xcom-globals.xml file. For example, to change parameters associated with only CA XCOM Gateway's keystore and X509 certificates, or to set up CA XCOM Data Transport Client Authentication, it is necessary to edit the appropriate section of the xml file, as described below.

For more information about the format of the xcom-globals.xml file, see the appendix “Configuration XML Formats.”