XpoLog help - Configuration Image
 
General
A configuration image is the description of a set of XpoLog components, such as logs, reports, monitors and so on. A configuration image can be exported and saved in the file system and could be later imported to created a configuration identical to the one that was saved. A configuration image can also be published to other XpoLog nodes to create there images of a local configuration. For instance, in case XpoLog is installed in multiple locations with similar environments, one configuration image could be used to update all these configurations and to create similar configurations in newly installed XpoLogs. Another example would be to use a configuration image to duplicate a configuration on the same XpoLog, as in the case where an environment that XpoLog was configured to watch is installed on further machines. Unlike export and import of logs and folders, a configuration image saves and publishes only the components' configurations, but not their data.
Publishers are definitions containing both transformation in the names and locations of logs and folders that should take during the publishing process and information concerning the target(s) of the published configuration image. Transformation information publishers is used also during exporting of configuration images.

Defining a configuration image.
  1. From the 'Configuration' menu, select 'Configuration Image'.
  2. Click on the 'Add new Configuration Image' link to create a new configuration image or click on the 'edit' link of an existing configuration image to edit it.
  3. Enter the name of the configuration image. You can also enter a description to it.
  4. If you want to overwrite existing configurations, click the 'Overwrite existing configuration image' checkbox, otherwise leave it unchecked. You can also overwrite specific address, tasks and schedulers configurations (in case you don't want to overwrite all the configurations). You can do that by selecting the overwrite checkbox for each configuration separately. See below the list of available XpoLog components whose configuration can be added to the configuration image.
  5. Select from each tab the configuration you want to create the image for, and click 'save'.

 


Export \ Publish configuration image.
    After you save the configuration image you return to the 'Configuration Image Set' page. You can also get to this page from the 'Configuration' menu by selecting 'Configuration Image'. Here you can select for existing configuration images one of the options: export, publish, edit, delete or duplicate.
    Export - Choose export to create a zip file from the configuration image and save it to your file system. Click 'export' to go to the 'Export configuration image' page.
    Select here the publisher you want to use for the exported configuration image and click the 'export' link. After processing completes, select the 'save' option of the browser to save the created zip file to your file system.
    Publish - Choose publish to publish the configuration image to other XpoLog nodes or to the local XpoLog.
    In the 'Publishers Set page select 'Add new publisher' to create a new publisher or select 'edit' to edit an existing publisher. In the 'Folder names' page you can add (for each of the folders selected in 'Logs and folders' tab) under 'New folder name' the name of the folder as you want it to appear in the published node(s). By default the original folder names will be kept. If you selected the 'Overwrite existing configuration image' checkbox in the configuration image definition page, then the following will happen: within a subtree of folders, as long as the same folder names are used, the existing folders will be overwritten. Once a folder with a new name is encountered, then a sub tree is created from this folder's parent folder and all of this folder's ancestor will hang under it in the new subtree. Click next to go to the 'Configuration Image logs path' page.
    For each of the logs selected in the 'Logs and folders' tab enter, under 'target path', the path of the log as it should appear in the published node. If for instance the log 'client' is located in the local XpoLog node under 'c:\logs' and in the target node(s) under 'c:\xpolog\logexample', enter 'c:\xpolog\logexample' in the target path.
    Click 'next' for the 'XpoLog Enterprise Nodes' page. Select the nodes you want to publish the configuration image to. As mentioned above, you can also select the local XpoLog as a target. Click 'save' to save the publisher, or 'publish and save' to save and then publish it.
    Duplicate - Choose this option to create a copy of the configuration image.


Import configuration image.
  1. From the 'Data Support' menu select 'Import Configuration Image'.
  2. Select the file containing the configuration image and click 'next'.
Importing a configuration image might take a substantial amount of time, depending on its size. Be aware that importing a configuration image (and publishing one too) results in changes to your configuration: XpoLog component will be added and might overwrite existing ones.

 


XpoLog components that can be added to a configuration image
  1. Applications - selecting a application will add the application's configuration and all its members to the configuration image.
  2. Logs and folders - selecting a log will add the log's configuration and its account's configuration (if one exists) to the configuration image. Selecting a folder will add the folder configuration and all the folder's members (folders and logs) to the configuration image.
  3. Monitors - selecting a monitor will add the monitor's configuration and the configurations of the logs used in its definition to the configuration image.
  4. Accounts - selecting an account will add the account's configuration to the configuration image.
  5. Reports - selecting a report will add the report's configuration together with the configuration of its monitors and the logs used in its definition to the configuration image.
  6. Templates - selecting a templates will add the template's configuration to the configuration image.
  7. Wizards - selecting a wizard will add the wizard's configuration to the configuration image.
  8. Tasks - selecting a task will add the task's configuration and its accounts' (for instance in the case of an e-mail task), folders and logs (in case of an export folder task), and reports (in case of a general report task) configurations to the configuration image.
  9. Schedulers - selecting a scheduler will add the scheduler's configuration together with the configuration of its tasks and monitors to the configuration image.
  10. Enterprise - selecting an enterprise will add the enterprise's configuration to the configuration image.

 

Additional links
     
Export and import log
     Export and import folder
     Address book