Upgrading PowerBuilder Applications
Upgrading from PowerBuilder 2021 or earlier

Upgrade PowerServer.Core and PowerServer.Api to the latest compatible version 2.0.0. Or refer to this table for a list of NuGet packages compatible with the application deployed via PowerServer Toolkit from different builds.

If you don't manually upgrade PowerServer.Core and PowerServer.Api, you will encounter the error "Application Terminated. The version of PowerServer Nuget packages does not match that of PowerBuilder. " (view more) when running the installable cloud app.

Add the following scripts to the PowerServer C# solution > ServerAPIs project > Startup.cs:

using PowerServer.Core;

services.AddPowerServerDataProvider(this.GetType().Assembly);

app.UsePowerServerPathBase();

Add the following script to the PowerServer C# solution > ServerAPIs project > Server.json:

"PathBase": "/vpath1",

"PathBase" is used to specify the sub-folder of the Web site where PowerServer Web APIs is deployed, for example, "/vpath1".

Add the following script to the PowerServer C# solution > ServerAPIs project > OpenAPI > OpenAPIExtensions.cs:

This will add the route prefix "PowerServer" to the PowerServer Swagger UI, so that Swagger UI can start successfully.

            // Enables Swagger UI for visual debugging
            app.UseSwaggerUI(options =>
            {
                options.SwaggerEndpoint("/swagger/v1/swagger.json", "ServerAPIs v1");
                options.RoutePrefix = "PowerServer";

Add the following script to the PowerServer C# solution > ServerAPIs project > Logging > Logging.json or Logging.Development.json if you want to specify log level for logging providers such as Microsoft, Microsoft.Hosting.Lifetime, and System.Net.Http.HttpClient.PowerServer:

    // Sets the default log output level of all the logging providers
    "LogLevel": {

      // Sets the default log output level
      "Default": "Information",

      // Sets the Microsoft log output level
      "Microsoft": "Information",

      // Sets the Microsoft.Hosting.Lifetime log output level 
      "Microsoft.Hosting.Lifetime": "Information",

      // Sets the System.Net.Http.HttpClient.PowerServer log output level 
      "System.Net.Http.HttpClient.PowerServer": "Warning"
    },

Add the following script to the PowerServer C# solution > ServerAPIs project > Server.json if you want to keep the version information:

    "VersionInfo": {
      "Version": "2022",
      "Revision": "R1",
      "Build": "1878"
    }