Modifying the core configuration file

The festival.xml file is the core configuration file in server interface services. You configure your system by modifying entries in the file. Modify the entries for f:broker, f:repository-mapping and f:properties to match your broker, repository, and license server setup.

Procedure

  1. The festival.xml file has three f:broker entries that describe where the interface services broker is. Edit these entries to point to the URL of the system where you installed the broker with the default port (61616). If the server interface services broker is on the same machine as the server interface services server, you do not have to edit these entries.
    <!-- Brokers we know about -->
    <f:endpoints>
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
    </f:endpoints>
  2. The f:repository-mapping defines the URN of the repository.
    1. The name attribute is the name displayed on the server interface services logon page. You can change this attribute. The default is DOORS ERS Repository.
    2. The repositoryUrn attribute must match the uniform resource name (URN) of the database server you identified in Identifying the database uniform resource name. You must change this attribute.
    <!-- Mapping from Repository IDs to the broker we use to reach the repository -->
       <f:mappings>
          <f:repository-mapping 
             .
             .
             name="DOORS ERS Repository"
             repositoryUrn="urn:rational:ers-38f5c98719f27b6d:" />
       </f:mappings>
  3. You must change the f:properties section of the file.
    1. Required: Enter the location of the license server. Update the value in this line: This location is added to the list of license locations held on your system.
  4. The f:properties entry defines the location of the license server. The property name attribute is licence.server.location with the value 19353@localhost, which is the port number and machine name of the license server. Edit this value to point to the location of your license server. This location is added to the list of license locations held on your system.
    <f:properties>
      <f:property name="licence.server.location" value="19353@localhost"/>
  5. Save and close the file.

Feedback