You are here: MyURC.org > Tools & Prototypes > UCHe > tutorial > Configuration File

How to Modify the UCHe Configuration File

---

Page Contents:

---

File Location

The UCH configuration file is located at: [Apache_HOME]/cgi-bin/uch.config.

In case of UCHe installation with Apache, the location is /usr/local/[ApacheFolder]/cgi-bin/uch.config.

Basic Settings

1. Set the debug level to a number between 0 and 3:

   <debug>0</debug>

   Available debug levels:

   • 3 - information + warning + error
   • 2 - warning + error
   • 1 - error
   • 0 - no log file (recommended)

2. As such UCHe automatically detects system's IP address, but still one can also specify the IP address manually, as follows:

   <ipAddress>192.168.1.1</ipAddress>

   Note 1: Replace "192.168.1.1" in the above example with the IP address of your server.

3. Specify the Port No. of the Apache server, as in the following example:

   <portNO>8080</portNO>

   portNo specifies the port number on which Tomcat server is running. If it is port 80 then no need to specify it. Else specify the value of port number on which Apache server is running.
4. In order to download the host compatible resources from resource server, it is necessary that platform property is set to current host architecture. Currently resources for two architectures ('intel' and 'arm') are available from the resource server. Accordingly set the platform as follows:

   <platform>intel</platform> or <platform>arm</platform> whichever is applicable.

5. Set UCH's Properties as applicable. Current UCHe 2.0 Intel version properties are:

   	<uch>
   
   		<prop>
   
   			<name>http://purl.org/dc/elements/1.1/title</name>
   
   			<value>Universal Control Hub</value>
   
   		</prop>
   
   		<prop>
   
   			<name>http://purl.org/dc/terms/modified</name>
   
   			<value>2010-05-20T00:00:00Z</value>
   
   		</prop>
   
   		<prop>
   
   			<name>http://myurc.org/ns/res#type</name>
   
   			<value>http://myurc.org/TR/uch/</value>
   
   		</prop>
   
   		<prop>
   
   			<name>http://purl.org/dc/terms/conformsTo</name>
   
   			<value>http://myurc.org/TR/uch1.0-20091103/</value>
   
   		</prop>
   
   		<prop>
   
   			<name>http://myurc.org/ns/res#docRoot</name>
   
   			<value>/usr/local/intelapache/htdocs</value>
   
   		</prop>
   
   	</uch>

   The set up of the document root is very important setting. UCH looks for 'resources' folder located under docRoot for searching offline resources like TA, TDM, UIPM, UIPM Client, TD, UIS, RSHEET.

Resource Server Settings

Following information must be filled in for connection to Global Online Resource Server:

	<resserver.username>res.dotui.com</resserver.username>
	<resserver.password></resserver.password>
	<resserver.appPath></resserver.appPath>

• resserver.appPath specifies resource server path. Currently a global Resource Server is available at res.dotui.com. If blank or incorrect, then no connection will be made to the Resource Server. UCH will still read offline resource as specified in the UCH resource management tutorial.
• resserver.username specifies login userName to Resource Server. If blank or incorrect, then UCH can still communicate with Resource Server using Guest access.
• resserver.password specifies login password for access to the Resource Server.

For access information please contact Dr. Gottfried Zimmermann at zimmer@trace.wisc.edu

---

Last update: Parikshit Thakur & Team, 2010-05-20