Notes about Environment

www.altova.com Expand/Collapse All Print this Topic Previous Page Up One Level Next page

Home >  Setting Up MobileTogether Server > Setup on Linux >

Notes about Environment

Folders

Given below is a list of important folders in your MobileTogether Server setup.

 

Click to expand/collapseInstallation root

/opt/Altova/MobileTogetherServer/

 

Click to expand/collapseLicense Files

/var/opt/Altova/MobileTogetherServer

 

Click to expand/collapseEnvironment settings

/etc/profile.d/jdbc.sh

The environment settings file (typically named jdbc.sh) is executed at system start. The definitions in it must be specific to your particular environment. The example path above serves only as a general guide.

Note:The environment settings file sets the variables for all users on the system, so you must be careful when modifying settings. For example, if you modify a class path in this file, then the modifications will be applied across the system. If you wish to make changes for MobileTogether Server only, you might want to consider using a unit file (explained in the section JDBC Connections below).

 

 

Filesystem triggers and permissions

In order for filesystem triggers to be fired, the user that started the MobileTogether Server service (altovamobiletogetherserver) must have the following permissions:

 

For the triggered folder: Read and Execute
For the triggered file: Read
For ancestor folders of the triggered folder: Read and Execute

 

 

File-based databases

File-based databases (such as SQLite databases) must reside in the folder defined in the Settings tab of MobileTogether Server as the Server Side's Solutions Working Directory. By default, this folder is:

 

/var/opt/Altova/MobileTogetherServer/SolutionFiles

 

Adding class paths to the MobileTogether service file on CentOS

If your MobileTogether Server is installed on CentOS, you will need to add the class path to the mobiletogether.service file (which should be located at /usr/lib/systemd/system/mobiletogether.service).

 

Add the class path as follows:

 

1.In the mobiletogether.service file, find the [Service] section, which begins with "PIDFile=/var ..."
2.Above the [Service] section add the line: Environment="CLASSPATH=<classpaths-go-here>"

 

Database connections

On Linux, the following database connections are supported:

 

JDBC — You can use JDBC for all supported databases except Microsoft Access
Native connections — Currently available for SQLite and PostgreSQL databases

 

If you are using JDBC, note the following points:

 

The Java Runtime Environment or SDK must be installed.
The JDBC drivers for the target database must be installed.
The following environment variables must be set correctly for your environment:
οCLASSPATH: to find the jar-files that connect to the JDBC database; the jar-files can be entered either in (i) an executable script (like jdbc.sh) that is executed on system start, or (ii) a unit file that is executed when MobileTogether Server is started as a service. Using a unit file to specify the jar-files has the advantage that the files required for MobileTogether Server's JDBC connections will be located without you having to modify the existing system configuration. A unit file is listed below.
οPATH: to find the JRE, but might not be necessary depending on the installation
οJAVA_HOME: if necessary, depending on the installation.

 

Listing of important files

The following shell script (or unit file) is copied to the folder /opt/Altova/MobileTogetherServer/etc so as not to overwrite already existing configuration files. Make the necessary changes as required. Also see the section JDBC Connections above. The parts highlighted in blue are environment-specific and will need to be adjusted to match your environment:

 

Click to expand/collapseShell script (unit file)

#- jdbc - environment -

export PATH=/usr/local/jdk1.7.0_17/bin:/usr/lib64/qt-3.3/bin:/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:/home/qa/bin

export JAVA_HOME=/usr/local/jdk1.7.0_17

export CLASSPATH=/usr/local/jdbc/oracle/ojdbc6.jar:/usr/local/jdbc/oracle/xdb.jar:/usr/local/jdbc/oracle/xmlparserv2.jar:/usr/local/jdbc/postgre/postgresql-9.0-801.jdbc4.jar:/usr/local/jdbc/mssql/sqljdbc4.jar:/usr/local/jdbc/iseries/lib/jt400.jar:/usr/local/jdbc/mysql/mysql-connector-java-5.1.16-bin.jar:/usr/local/jdbc/sqlite/sqlitejdbc-v056.jar:/usr/local/jdbc/Informix_JDBC_Driver/lib/ifxjdbc.jar:/usr/local/jdbc/sybase/jconn7/jconn4.jar:/usr/local/jdbc/db2/db2jcc.jar:/usr/local/jdbc/db2/db2jcc_license_cu.jar:./:

 

 

 


© 2019 Altova GmbH