Ladon SE configuration guide

Ladon startup properties

property	meaning	default
* ladon.home	folder with config (cassandra.yaml) and data	${user.home}/ladon_data
ladon.s3.loggingenabled	logging for s3 requests	true
ladon.s3.servletthreads	count of parallel s3 requests	10
ladon.s3.requesttimeout	timeout for s3 requests	0(off)
ladon.s3.validatecontent	validate content after upload	true
* ladon.db.nodes	external addresses of all Ladon nodes, comma separated	localhost
* ladon.db.port	cassandra port for Ladon	9042
* ladon.db.user	cassandra user	cassandra
* ladon.db.password	cassandra password/ DB encryption password	generated uuid
* ladon.db.datacenter	cassandra datacenter string	datacenter1
* ladon.db.rack	cassandra rack string	rack1
* ladon.db.replicationfactor	ladon keyspace replication factor	2
server.port	tomcat port for Ladon	8080

There are some properties marked with * that must not be changed after initialization of ladon. They can be changed later but need some manual corrections!

To change default values add them as additional properties to the startup script. Example:

java -Dserver.port=8888 -jar ladon_se_1.0.4.jar

Cluster setup

To combine 2 Ladon instances to a cluster, you have to provide the hostnames of both machines on first startup. This is important since the cassandra.yaml config file is generated with the provided data. For example, you have two hosts, server1 and server2, so the startup script could look like:

java -Dladon.db.nodes=server1,server2 -jar ladon_se_1.0.4.jar

It is important for the first startup to start both instances quite simultaneous. Otherwise the first handshake will fail because there is a timeout. This won't be an issue anymore after the initial setup is finished.

Schema initialization

After you connected the two instances (or if you just want one) and before you can login the Ladon schema must be initialized. This is done by navigating your browser to the init url /admin/cassandra/init. e.g. http://localhost:8080/admin/cassandra/init

Ladon home

All data Ladon writes to the disk can be found in the ladon.home directory ( default: ${user.home}/ladon_data ) If you want to backup your data you can just backup this folder.

Admin user

After the schema initialization you can login with the admin user. Username: admin password: admin123 (please change it!)

Logging

The logs are stored relative to the executable in the file ./logs/ladon.log

Spring Actuator

You can find the health and metrics endpoint at /admin/health and /admin/metrics