Understanding the PowerServer Architecture

Understanding the PowerServer architecture helps you recognize issue types. A PowerServer deployment spans five key components across the build, server, and client layers. Errors are typically tied to one of them:

Issue Type

Typical Symptoms

Detection

Development PC

PowerBuilder IDE with PowerServer Toolkit plug-in and PowerServer NuGet packages — where the application is analyzed, compiled, and deployed

Build & Deploy stage

Web Server

IIS, Apache, or Nginx — functions purely as a static file server; serves granular p-code files and app resources to clients (no code execution occurs here)

Install/Access stage

PowerServer Web API (.NET Server)

Kestrel or IIS-hosted API layer — handles business logic and data exchange

Runtime stage/Access stage

Database Server

SQL Anywhere, PostgreSQL, etc. — stores and retrieves application data

Runtime stage

Client

Installable cloud app running on the desktop — initially installed via browser URL, then runs independently of the browser (type, version, or settings); auto-updates over the Internet

Install & Run stage

When an error occurs, quickly identifying which component is involved narrows down the possible causes significantly. Note that the Web Server acts purely as a static file server in this architecture; runtime logic errors will trace back to the PowerServer Web APIs or the database, not the web server itself.