Getting Started

How to Configure

Configuration involves editing XML content.  Configuration can be achieved in one of two ways:

1. Configuration in the CLIP Web UI "Configuration" TAB - this is a convenient way to make little adjustments and apply the changes quickly: perform the changes, then
   1. (optionally) "Validate" the content to assure it is syntactically correct
   2. Hit "Save" ( to once again validate the content and ), then Choose "OK" to reload and apply the configuration  
      
   3. "Revert to saved" reloads the editor with the current configuration should you have done changes and wanted to revert back.
   4. The "Password Encryptor" is the tool to encrypt passwords so you dont have to enter them in cleartext when connecting systems. Type and re-type your password, then click "Generate" and copy the Encrypted password to the appropriate attribute when configuring a connected system.
2. Edit the configuration file [Clip]/conf/ClipConfig.xml on the Clip server 
   For more extensive configuration tasks, it is recommended to edit the config file by means of an editor ( like Notepad++ on Windows or "vi" on Linux ) which may also support additional features like XML syntax highlighting. To apply changes, CLIP needs to be restarted.

What to configure

The XML configuration has a well defined structure and contains the following elements, in order :

• license : your license
• database : settings for the database, there is no need to change anything to get started
• targets : a list of predefined configurations for different types of systems. Each target definition provides information for Clip to specify how to connect to a system and how to receive, create and modify events, incidents or other artifacts. Each target has 
  • a type : this is determined by its element name, e.g. there are targets with element names <omiTarget/>, <bmcTarget/>, <snTarget/>, <cherwellTarget/>, ...
  • a name : the target name is referenced by an integration
  • a <create.../> element to define how new artifacts should be created
  • an <update.../> element to define how artifacts should be updated 
• integrations : each integration has an integration name and contains two references to targets in the target list by the target name. The first one is considered to be the source and the second one the destination. An integration can be set to "active" or "inactive" by setting the status attribute. 

Activating preconfigured integrations

To activate a preconfigured out-of-the-box (OOTB) integration

1.  identify the integration of interest in the list of example integrations at the very end of the configuration and set it to "active":
   
2. Per integration, configure the mandatory basic settings for the two systems to integrate, therefore
   1. identify the two target names involved ( "MF_OMi2ITSM" and "BMC_ITSM" in the example  )
   2. find the two targets referenced in the integration in the list of targets and configure the "basic" settings, like URL, server name, user and password. Depending on the system, please refer to the appropriate section in the chapter Setup .  
3. Save and apply the new configuration
4. Review the Status Tab in the Clip Web GUI and start using the integration.

Integration Examples

Clip provides some example configurations out-of-the-box which are "inactive" by default, please note that the following list is not complete and does not show all integrations provided. To activate an example integration

1. activate the integration as described in 
2. configure the "Connection Settings" for the two targets involved, follow the link of teh two "System Types" and review the documentation of each system type