workWithSessions
This setting can be set to a boolean flag that specifies whether the Work with Profound.js Sessions interface is enabled.
The default value is true. To disable the interface, use the following:
workWithSessions: false
When enabled, the interface is accessed using the following URL: http://server:port/sessions, where server is the Profound.js server name or IP address, and port is the Profound.js port number.
The Work with Sessions interface shows a list of active Profound.js sessions.
Click here for information on how to modify this setting.
Adding security
By default, the page is password-protected on IBM i servers, but is not password protected on non-IBM i servers.
To add password protection on servers like Windows or Linux, specify the workWithSessions configuration option as an object with a credentials property. For example:
workWithSessions: {
enabled: true,
credentials: "C:\my-project\sessions-credentials"
}
The basic authentication credentials file is created by the "store_credentials.js" command-line utility. You can find an example of how to use the "store_credentials.js" command line utility here.
Multiple Profound.js Servers
If your environment uses a load balancer with multiple Profound.js servers, you can enable a combined view of sessions on all servers by specifying an object with a servers array for the workWithSessions configuration. For example:
workWithSessions: {
enabled: true,
servers: [
"http://server1:8081",
"http://server2:8082"
]
}
With this configuration, the servers must be able to reach each other on the network. If each server is configured with a full list of servers used by the application, then the combined Work with Profound.js Sessions interface (/sessions URL) can be accessed from any Profound.js server.
The servers can also be specified with http request options, as defined by the pjs.httpRequest() API. For example:
Dynamic Servers
If the list of servers is dynamic, the servers property can be specified as a JavaScript function that returns an array of servers dynamically.
The function can either be synchronous or an async function.
Some documentation pages have recently moved to a new section: Profound AppDev. If you are having trouble finding specific pages, try the documentation search capability or reach out to our Support team!