A RESTful API servlet for managing IBM i Web Services servers and services.

This project provides a modern REST API interface to the IBM Web Services Administration Script Processor (iwsadmin.jar), with interactive Scalar API documentation.

• ✅ RESTful API design (proper HTTP methods)
• ✅ JSON responses
• ✅ OpenAPI 3.0 specification
• ✅ Interactive Scalar API documentation
• ✅ Java 21 LTS

• Java 21 or later
• Maven 3.8+
• IBM i Web Services JARs:
  • iwsadmin.jar - Web Services Admin Scripts
  • iasadmin.jar - IAS Admin Library

wsadmin/
├── pom.xml
├── lib/
│   ├── iwsadmin.jar
│   └── iasadmin.jar
└── src/main/
    ├── java/com/ibm/systemi/iws/servlet/
    │   ├── RestApiServlet.java       # REST API
    │   └── ScriptProcessorServlet.java  # Legacy script interface
    └── webapp/
        ├── index.html                # Scalar API docs
        ├── openapi.json              # OpenAPI spec
        └── WEB-INF/web.xml

# Set Java 21
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

# Build
mvn clean package

# WAR file: target/wsadmin.war

JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 mvn jetty:run

# Access at: http://localhost:8080/wsadmin/

curl http://localhost:8080/wsadmin/api/servers

curl http://localhost:8080/wsadmin/api/servers/MYSERVER

curl -X POST http://localhost:8080/wsadmin/api/servers/MYSERVER/start

curl http://localhost:8080/wsadmin/api/servers/MYSERVER/services

curl -X POST "http://localhost:8080/wsadmin/api/servers/MYSERVER/services?name=MyService&pcml=/path/to/file.pcml"

curl -X POST http://localhost:8080/wsadmin/api/servers/MYSERVER/services/MyService/start

curl -X POST http://localhost:8080/wsadmin/api/servers/MYSERVER/services/MyService/stop
curl -X DELETE http://localhost:8080/wsadmin/api/servers/MYSERVER/services/MyService

All responses are JSON:

{
  "success": true,
  "server": "MYSERVER",
  "count": 3,
  "servers": [
    {"name": "SERVER1"},
    {"name": "SERVER2"},
    {"name": "SERVER3"}
  ],
  "raw": "... original command output ..."
}

Interactive API documentation is available at the root URL using Scalar.

Access: http://localhost:8080/wsadmin/

Deploy target/wsadmin.war to any Jakarta EE 10 compatible server:

• Open Liberty
• WildFly
• Tomcat 10+
• Jetty 11+

This project wraps IBM proprietary libraries. Use in accordance with IBM licensing terms.