This chapter describes the X-UP Server and X-UP Builder environment settings required for development.

X-UP Server Setup

A variety of environment settings files are provided to configure an X-UP Server. The following describes environment settings files under the assumption that X-UP Server is already installed.

Go to [webapps > xup > WEB-INF > xup > conf] in the WAS installation path to see the many environment settings files shown below.

xup_config.xml

The xup_config.xml file contains the following X-UP Server environment settings information.

The exception log levels used in X-UP Server are as follows:

log4j.xml

To help users with rapid and effective logging, X-UP supports log4j, an open source project by Apache.

A brief guide on log4j:

Log4j Logging Level

auth_info.xml

The auth_info.xml file contains X-UP account information.

The default account is xup/xup. Modify the <password></password> value to change a password, and enter new <user> information in <userList></userList> and save to add a new account.

<?xml version='1.0' encoding='uft-8'>
<authInfo>
	<userList>
		<user>
			<name>xup</name>
			<password>xup</password>
			<roles>admin</roles>
		</user>
		<user>
			<name>administrator</name>
			<password>admin</password>
			<roles>admin</roles>
		</user>
	</userList>
</authInfo>

web.xml

The web.xml file is located in xup/WEB-INF under the X-UP Server web application root folder. It's responsible for servlet, servlet mapping, filtering, and encoding settings.

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
	<servlet>
		<servlet-name>FrontControllerServlet</servlet-name>
		<servlet-class>com.tobesoft.xup.service.FrontControllerServlet</servlet-class>
		<load-on-startup>1</load-on-startup>
	</servlet>
	<servlet-mapping>
		<servlet-name>FrontControllerServlet</servlet-name>
		<url-pattern>*.do</url-pattern>
	</servlet-mapping>
</web-app>

JCO Library

We recommend placing the below libraries in the system path that was configured in the SAP instruction manual.

X-Up provides libraries for JCo for more convenient development with X-UP Builder. In the case of JCo 2.0, users are required to load librfc32.dll within X-UP and then sapjcorfc.dll within JCo. For JCo 3.0, users are not required to load any file within X-UP because all they need to do is loading sapjco3.dll within JCo.

The following explanations are about JCo 3.0 with sapjco3.dll applied.

• When using NetWeaver

  • X-UP does not load JCo-related libraries.

    • Using xup_env.property com.tobesoft.useJcoStandalone= false

    • Deleting sapjco3.jar and sapjco3.dll of SAP RFC DataSource

• For development and administration

  • When X-UP loads sapjco3.jar

    • Loading the library from SAP RFC DataSource

  • When sapjco3.jar located in System Path

    • Using xup_env.property com.tobesoft.useStandAlone = false

• *** Deleting sapjco3.jar and sapjco3.dll of SAP RFC DataSource

• When using a Java ext folder

  • Using xup_env.property com.tobesoft.useStandAlone = false

  • Moving sapjco3.jar of SAP RFC DataSource to the Java ext folder

  • Moving sapjco3.dll of SAP RFC DataSource to the Java bin folder

X-UP Builder Preferences Setup

All X-UP Builder environment settings can be configured in X-UP's preferences. X-UP's preferences can be found at [Window > Preferences… > X-UP].

Currently, the X-UP preferences consist of two pages.

• X-UP Page: General X-UP Builder settings.

• DataSource Page: Frequently-used data source management.

X-UP

You can define common environment settings in the X-UP page.

You can output log messages to the console by enabling the "Show X-UP Builder log messages to console" option. In addition, you can enable the "Include package and class debug line messages" sub-option to include package and class line messages in the output.

You can limit the possible retrieval of too much data by defining a constraint in the "SAP RFC GROUP Search limit count" option. More environment settings are planned to be added in the future.

DataSource

The DataSource page includes frequently-used data sources for reference or reuse when creating X-UP models.

Registered data sources can be referenced anywhere regardless of the project or model.

Defining Data Sources in X-UP Builder Preferences

1. Go to [Window > Preferences…] and run the Preferences Wizard.

2. Select [DataSource] from the [X-UP] menu to display the data source configuration screen.

3. Click the [New] button to define a new data source.

4. As shown in the above image, a defined data source can be copied in an X-UP project. Click the [Copy From…] button in the [Define DataSource] window of the New X-UP Model Wizard, and copy a data source defined in [Preferences].

Compiler Version Change

JRE version 1.6 is used in X-UP Builder. The user can change the compiler version in X-UP Builder as shown below.

The following instructions explain how to change the compiler version to 1.5 using the Preferences Wizard in X-UP Builder.

1. Go to [Window > Preferences…] and run the Preferences Wizard.

2. Click [Compiler] from the [Java] menu.

3. Select "1.5" from the [Compiler compliance level] drop-down menu under JDK Compliance, and then click the [Apply] button.