The JPIP Configuration File

Configuring your JPIP server is done by editing the parameters of the configuration files included with your installation. .

JPIP Configuration

The JPIP configuration file for both Windows and Unix is an XML file called jpiphost.exe.config. By default it is installed in <Express Server installation directory>/ImageServer/bin.

Editing the Windows JPIP Configuration File

In the configuration file (see the sample Windows JPIP configuration file below), each switch is listed on its own line followed by another line containing its value. For example, the switch for the port option (-port) appears midway down the list of options, as highlighted in yellow below: 

<string>-max_rate</string>  

<string>999999</string>
                  

<string>-port</string> 

<string>9013</string> 

<string>-catcfg</string> 

<string>auto</string> 

<string>-passwd</string> 

<string>notTooCryptic</string> 

This means that the port is set to 9013. To edit the options in this configuration file, consult the list of options (see JPIP Server Options) for the valid values and ranges for each parameter, locate the switch in the configuration file, and change the value.

NOTE: Most options are composed of a switch (identified by a minus sign) and immediately followed by a value, but there are a few switches, such as -rss_debug and -report, that have no specified values – they either appear and are thus enabled or do not appear and are thus disabled.

Sample JPIP Configuration File

Following is a JPIP configuration file very similar to the one that comes with your Express Server and sets the parameters for your JPIP server.

<?xml version="1.0" encoding="utf-8" ?>

<configuration>
   

<configSections>
      

<sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
         

<section name="jpiphost.jpipLib" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />

      </sectionGroup>
   

</configSections>
   

<applicationSettings>
      

<jpiphost.jpipLib>
         

<setting name="RunAdminCmdArgs" serializeAs="Xml">
            

<value>
               

<ArrayOfString xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
                  

<string>requiredDummyFirstArg</string>
                  <string>-host</string>
                  

<string>_JSHOSTPORT_</string>
                  <string>-passwd</string>
                  

<string>notTooCryptic</string>
                  

<string>-shutdown</string>
               

</ArrayOfString>
            

</value>
         

</setting>
         

<setting name="RunServerCmdArgs" serializeAs="Xml">
            

<value>
               

<ArrayOfString xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
                  

<string>requiredDummyFirstArg</string>
                  

<string>-initial_timeout</string>

                  <string>60</string>
                  

<string>-completion_timeout</string>
                  

<string>60</string>
                  

<string>-time</string>
                  

<string>6000</string>
                  

<string>-max_chunk</string>
                  

<string>8192</string>
                  

<string>-max_rate</string>
                  

<string>999999</string>
                  

<string>-port</string>
                  

<string>9013</string>
                  

<string>-catcfg</string>

<string>auto</string> 

<string>-passwd</string>

                  <string>notTooCryptic</string>
                  

<string>-wd</string>

                  <string>_IS_ROOT_</string>
                  

<string>-log</string>

                  <string>_IS_ROOT_\var\log\jpip.log</string>
                  

<string>-cd</string>
                  

<string>_IS_ROOT_\var\cache\jpip</string>

                  <string>-clients</string>
                  

<string>1000</string>
                  

<string>-sources</string>
                  

<string>6000</string>

                  <string>-connection_threads</string>
                  

<string>100</string>
               

</ArrayOfString>

            </value>
         

</setting>
         

<setting name="LogFilePath" serializeAs="String">

            <value>_IS_ROOT_\var\log\jpipservice.log</value>

         </setting>

      </jpiphost.jpipLib>
   

</applicationSettings>
   

<system.diagnostics>
      

<trace autoflush="true" indentsize="4">

      </trace>
   

</system.diagnostics>

</configuration>