ZKS Applications - Release and Rollout

This page describes, how the ZKS/PAS Java Services and ZKS Applications as well as a new Version of the ZKS Info Website is released and rolled out.

DEV: locally test a new DEV version

Services

Regarding DEV, there are no central ZKS/PAS DEV services. To start e.g. a ZKS DEV service within your local workspace, you need to checkout/clone the zks-reactor project, make it compile (right mouse -> maven -> update Project -> checkbox "force update of snapshot/releases"). To start the ZKS DEV service, you need to open an ssh tunnel to recieve the UWZ text protocol.

 ssh -l myusername -L localhost:16123:zkl152.acc.gsi.de:21377 zkl151.acc.gsi.de

Then select this class:

de.gsi.aco.zks.service.web.ZksServer

right mouse -> run as -> Java Application with the following VM arguments:

-Dspring.profiles.active=3tier -Dzks.service.server=local -Dzks.jdbc.properties=zks-dev.jdbc.properties

The running ZKS service can then be tested either directly in the Browser by calling e.g. http://localhost:49491/api/privileges/ or by starting a Java application against it.

Applications

Applications can then be started similarly by selecting e.g. the class

de.gsi.aco.zks.app.useradmin.ZksUserAdminApp

with the following VM arguments

-Dspring.profiles.active=3tier -Dzks.service.server=local -Dsun.awt.disablegrab=true -Duser.language=EN

INT: Deploy a new version on INT

Services and Applications

In your workspace directory, on the pas-reactor project, call

cd repos/git/pas-reactor
mvn deploy

Then rollout the new INT versions by navigating to the ansible project and calling

cd repos/git/acoapp-ansible/
make zks ENV=int

PRO: Release and Rollout of a new version on PRO

Full Release (Services and Applications)

Make sure that non-reactor dependency versions are replaced by actual version numbers.

In your workspace directory, on the pas-reactor project, call

cd repos/git/pas-reactor

mvn release:prepare
mvn release:perform

Inform MCR (tel. -2222) prior to the update.

Then rollout the new PRO versions by navigating to the ansible project and calling.

cd repos/git/acoapp-ansible/
make zks ENV=pro

Release of a single Application

We always release the whole reactor:

cd repos/git/pas-reactor

mvn release:prepare
mvn release:perform

if there were no incompatible API changes, it is possible to rollout only one application

make zks ENV=pro ANS_ARGS='-e "app_artifactid=zks-useradmin-app-swing"'

The updated application can be started as usual by calling

webstart https://websvcpro.acc.gsi.de/groups/fcc/applications/zks-remotecontrol-app-swing.zip --config=pro --vmargs="-Dzks.mode=full"

-- JuttaFitzek - 2025-07-14