pi_mcps/zoo_backup/work/skills/vmhalling-eau-test/SKILL.md

name, description

name	description
vmhalling-eau-test	Run EAU integration tests on vmhalling CENTER instance (Zentrale.120 + Mandant.JB). Deploy JAR, prepare test data, run in CENTER mode, verify DB changes and logs. Use when asked to test EAU on vmhalling, run CENTER integration test, or verify EAU changes on a real PAISY instance.

vmhalling EAU Integration Test

When to use

• Testing EAU module changes on a real PAISY CENTER instance
• Verifying CENTER-mode behavior (multi-mandant loop via connections.csv)
• Testing writeRequestData / loadReturnXml flows end-to-end
• Deploying and running EAU.jar on vmhalling

When NOT to use

• Unit tests (use mvn test locally)
• Testing on Package/CLIENT instances (use ssh-test-deploy skill with qa host)
• Testing modules other than EAU on vmhalling

Environment

Item	Value
Host	halling (oracle@vmhalling.ad.esi.adp.com)
Zentrale	/user2/mkn/Zentrale.120 (RunType=CENTER)
Mandant.JB	/user2/mkn/Mandant.JB (RunType=CLIENT/Package)
Java	WEB/JAVA/jdk17.0.17-0/bin/java (relative to instance)
JAR path	<instance>/JAR/EAU.jar
connections.csv	Zentrale.120/ADMIN/SETTINGS/connections.csv (MJB, TS8, MA1, FUB)
H2 DB	<instance>/ELSDAP/eau.mv.db
SSH auth	ed25519 key in authorized_keys (scp works directly)
Batch scripts	BATCH/SCRIPTS/PST_eau.ksh

RunType Configuration

EAU determines RunType via CommonRoutines.isCenter() / CommonRoutines.islocal():

RunType	Env var	Routes to
CENTER	RMZ_KUNDE=DEUEV	Center.java (multi-mandant loop)
CLIENT	RMZ_KUNDE=<anything else> or SVBEA_KUNDE=<anything else>	Package.java (single mandant)
PACKAGE	Neither set	Package.java (no mandant kürzel)

Workflow

1. Switch to vmhalling host

set-host(host="halling")

2. Build and deploy EAU.jar

# Build locally
cd /Users/pplate/git/paisy-<TICKET_KEY>
mvn package -pl :EAU -am -DskipTests -f java/pom.xml -Drevision=100.0.0-TEST -o -q

# Deploy via scp (SSH key already configured)
scp -o StrictHostKeyChecking=no \
  java/modules/cs-modules/eau/target/EAU-*-TEST-jar-with-dependencies.jar \
  oracle@vmhalling.ad.esi.adp.com:/user2/mkn/Zentrale.120/JAR/EAU.jar

# Also deploy to Mandant.JB if testing CLIENT path
scp -o StrictHostKeyChecking=no \
  java/modules/cs-modules/eau/target/EAU-*-TEST-jar-with-dependencies.jar \
  oracle@vmhalling.ad.esi.adp.com:/user2/mkn/Mandant.JB/JAR/EAU.jar

3. Prepare test data (if needed)

To make Anforderungen "ready to send" (triggers writeRequestData):

# H2 Shell access
export JAVA=/user2/mkn/Zentrale.120/WEB/JAVA/jdk17.0.17-0/bin/java
$JAVA -cp /user2/mkn/Zentrale.120/JAR/EAU.jar org.h2.tools.Shell \
  -url "jdbc:h2:file:/user2/mkn/Mandant.JB/ELSDAP/eau" -user sa -password ""

# Null out AGTOSV_ID to make Anforderungen sendable again
UPDATE ADP_EAU_ANFORDERUNGEAUAG SET AGTOSV_ID = NULL WHERE AGTOSV_ID IS NOT NULL;

4. Run on Mandant.JB (CLIENT/Package mode — creates AGTOSVs)

cd /user2/mkn/Mandant.JB && source ADMIN/SETTINGS/PAISYPROFILE
export JAVA_HOME=/user2/mkn/Zentrale.120/WEB/JAVA/jdk17.0.17-0
export PATH=$JAVA_HOME/bin:$PATH
java -jar JAR/EAU.jar --targetdir $PAISY_OUTPUT

5. Run on Zentrale.120 (CENTER mode — iterates connections.csv)

cd /user2/mkn/Zentrale.120 && source ADMIN/SETTINGS/PAISYPROFILE
export JAVA_HOME=/user2/mkn/Zentrale.120/WEB/JAVA/jdk17.0.17-0
export PATH=$JAVA_HOME/bin:$PATH
export RMZ_KUNDE=DEUEV   # ← triggers CENTER mode!
java -jar JAR/EAU.jar --targetdir $PAISY_OUTPUT

6. Verify results

# Check DB for changes
$JAVA -cp /user2/mkn/Zentrale.120/JAR/EAU.jar org.h2.tools.Shell \
  -url "jdbc:h2:file:/user2/mkn/Mandant.JB/ELSDAP/eau" -user sa -password "" \
  -sql "SELECT sd.AKTENZEICHENVERURSACHER FROM ADP_EAU_STEUERUNGSDATEN sd"

# Check exported XML files
ls -la /user2/mkn/Zentrale.120/USER/master/OUTPUT/EEAA*

# Check logs for WARN messages
# (output is inline from java -jar command)

7. Store results in BigMind

memory_store_fact(
    category="codebase",
    fact=f"{TICKET_KEY}: SSH integration test on vmhalling CENTER — <result summary>"
)

Key Tables (H2)

Table	Purpose
ADP_EAU_STEUERUNGSDATEN	Contains AKTENZEICHENVERURSACHER (AZVU)
ADP_EAU_ANFORDERUNGEAUAG	Anforderungen (AGTOSV_ID=null = ready to send)
ADP_EAU_AGTOSV	Created AGTOSVs (sent containers)
ADP_EAU_ANTRAG	Anträge (parent of Anforderungen)

Troubleshooting

Issue	Resolution
java: not found	Use full path: WEB/JAVA/jdk17.0.17-0/bin/java
Runs through Package.java instead of Center.java	Set export RMZ_KUNDE=DEUEV before running
"Nothing to send"	Null out AGTOSV_ID on Anforderungen to make them sendable
scp permission denied	SSH key should be in ~oracle/.ssh/authorized_keys on vmhalling
Upload timeout via MCP	Use scp directly (92MB JAR too large for 60s MCP timeout)
H2 version warning	Non-blocking — H2 2.4.240 works fine