Page History

XConf XCONF is usually installed on several VM's VMs in production.   The number of VM's VMs for the Data Service depends on the number of devices that will be calling it.   For the Admin UI, only a few VM's VMs are required since there are usually only a few users making changes each day.

These instructions assume that the XConf XCONF artifacts have already been built.   The artifacts required are the Data Service and Admin UI war WAR files.

Data Service

Install Java

If it's not already installed, install Java.

Note: Currently, OpenJDK 1.8.x is required.

sudo yum install java-1.8.0-openjdk-devel

java -version
openjdk version "1.8.0_212"
OpenJDK Runtime Environment (build 1.8.0_212-b04)
OpenJDK 64-Bit Server VM (build 25.212-b04, mixed mode)

Install wget

sudo yum install wget

Install Jetty

This creates the xconfserver directory and installs the Jetty files.

...

cd xconfserver

mkdir tmp

cd tmp

wget https://repo1.maven.org/maven2/org/eclipse/jetty/jetty-distribution/9.13.07.v20131115v20160115/jetty-distribution-9.13.07.v20131115v20160115.tar.gz

gzip -d jetty-distribution-9.13.07.v20131115v20160115.tar.gz

cd /opt/xconfserver

tar -xf tmp/jetty-distribution-9.13.07.v20131115v20160115.tar --strip=1

Install

...

XCONF Data Service

The xconf-dataservice.war file should be copied to the VM.  It must be renamed to root.war.

cp xconf-dataservice.war /opt/xconfserver/tmp/.

cd /opt/xconfserver/tmp

mv xconf-dataservice.war root.war

Install service.properies file

The service.properties file configures XConf XCONF with various settings, such as the Cassandra seed hosts and other Cassandra and service related properties.

In the /opt/xconfserver directory, create a file, service.properties, and add the following lines.

connectionPools.SharedConnectionPool.maxConnsPerHost=15
connectionPools.SharedConnectionPool.localDatacenter=<name of Cassandra data center>
connectionPools.SharedConnectionPool.seeds=<IP addresses or resolvable hostnames of Cassandra seed nodes>
connectionPools.SharedConnectionPool.nodeDiscoveryType=RING_DESCRIBE
connectionPools.SharedConnectionPool.readConsistencyLevel=CL_LOCAL_QUORUM
connectionPools.SharedConnectionPool.useConnectionPoolMonitor=true
connectionPools.SharedConnectionPool.writeConsistencyLevel=CL_LOCAL_QUORUM
connectionPools.SharedConnectionPool.autoDiscoverHosts=true

Starting XConf Data Service

XConf Data Service is started as a separate process.

...

nohup java -DappConfig=/opt/xconfserver/service.properties -DserviceName=xconfDataService -verbose:gc -XX:+PrintGCDateStamps -XX:+PrintGCDetails -Xloggc:/opt/xconfserver/logs/gc.log -Xms2048m -Xmx2048m -XX:NewSize=512m -XX:MaxNewSize=512m -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8081 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.rmi.port=8081 -Djetty.logs=/opt/xconfserver/logs -Djetty.home=/opt/xconfserver -Djetty.base=/opt/xconfserver -Djava.io.tmpdir=/opt/xconfserver/tmp -DENABLE_OBIEE_SCP_URL_PROP=false -Dtheplatform.log.dir=/opt/xconfserver/logs -Djava.library.path=/opt/xconfserver/lib/ext -DSTOP.PORT=8083 -Djetty.port=8080 -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/xconfserver/logs/xconfDataService.heapDump -XX:OnOutOfMemoryError=/opt/xconfserver/bin/OOM.rb -jar start.jar jetty.port=8080 > /opt/xconfserver/logs/xconfDataService.stdout.log 2> /opt/xconfserver/logs/xconfDataService.stderr.log &

Verifying that XConf is running

curl http://127.0.0.1:8080/version

Admin UI