Resources

Resources is a set of tools for viewing and configuring the servers cluster, temporary files and configuration backups. There are two tools: Cluster and Maintenance.

Figure 76. Resource

Resource

Cluster

Once you installed PowerServer to several application servers, you can use the AEM Cluster tool to create a PowerServer cluster and configure the load balancing and failover settings of the cluster.

Note that the load balancing and failover features mentioned in this section are implemented using a plug-in specially provided by Appeon. You will need to configure this Appeon plug-in after creating the PowerServer cluster in AEM. For detailed instructions, refer to Tutorial 5: Configure PowerServer Cluster in PowerServer Mobile Tutorials.

You can also implement the load balancing feature (but not failover) using the plug-in provided by the application server. Detailed instructions can also be found in the Web Server Configuration Guide.

Figure 77. Cluster

Cluster

Cluster Server List

Use the Cluster Server List to create a PowerServer cluster. The PowerServer listed in the Cluster Server List group share the same AEM settings, and can work as a cluster in supporting the requests from their associated Web server.

Important requirements
  • All of the PowerServer to be added into the cluster must have the same connection type: HTTP or HTTPS; it cannot be a mix.

  • Use the IP address or machine name of the PowerServer when adding a PowerServer. Do not use "localhost" or "127.0.0.1".

  • The IP address or machine name and port number must match the HTTP or HTTPS settings in the application server.

  • Add the server that the current AEM runs on as the first member of the cluster, and if you want to remove all servers from the list, remove it last.

  • To successfully synchronize/save a specific setting to all servers in the list, verify that servers are running before you save it.

  • An application must be deployed to all servers in the cluster to make sure the cluster functions properly. Use the Appeon Deployment Wizard to perform the application deployment. For detailed instructions, refer to the Chapter 5, Deploying PowerBuilder Applications in PowerServer Toolkit User Guide.

  • To ensure the most efficiency and stability of the PowerServer cluster, verify that the environment of all PowerServer is identical. For example, the application server (type and version) and PowerServer (version and license) must be the same.

  • If you need to reinstall the operating system of a PowerServer in the cluster, be sure to remove the PowerServer from the cluster first.

Adding a PowerServer

Make sure you add the server that the current AEM runs on as the first member of the cluster.

Step 1: Select the connect type (HTTP or HTTPS) for the PowerServer cluster.

All of the PowerServer to be added into the cluster must have the same connect type: HTTP or HTTPS.

Step 2: If using the Amazon Web Service cloud server, select the configuration mode for auto scaling.

  • Manual - does not support auto scaling (so the developer needs to manually update the PowerServer list in the cluster).

  • Auto - supports auto scaling by automatically detecting PowerServers and updating the PowerServer list in the cluster.

For more about configuration for auto scaling in Amazon Web Service, see the section called “Special instructions for Auto Scaling in Amazon Web Service” in PowerServer Mobile Tutorials.

Step 3: Click the Add PowerServer button in the Cluster Server List table. The Add PowerServer page opens.

Figure 78. Add PowerServer

Add PowerServer

Step 4: Verify that the PowerServer to be configured is running and provide the required information (IP address, port, and the AEM login user name and password). For example:

  • IP address: 161.0.0.1

  • Port: 80

  • AEM User Name: admin

  • AEM Password: admin

Step 5: Click the Save and Save and Add button. The program will automatically test the connection and add the PowerServer if the test is successful.

Adding a PowerServer will succeed only if:

  1. The PowerServer is new to AEM.

  2. The information provided is correct.

  3. The PowerServer is running.

  4. The first PowerServer that you add is the one hosting the current AEM.

  5. The password is correct.

Removing a PowerServer

Make sure you remove the server that the current AEM runs on first.

To remove a PowerServer from the list:

Step 1: Click the Delete button in the Actions column of the PowerServer in the PowerServer Cluster table.

Step 2: A message box appears requiring confirmation. Choose OK to proceed with the deletion, or choose Cancel to cancel.

Step 3: By clicking on the OK button, the PowerServer is removed from the PowerServer list. AEM no longer interfaces with the PowerServer.

To remove all PowerServer from the list:

Click the Remove All button and then click OK in the popup message box to confirm the deletion.

Checking status of PowerServer

A PowerServer in a cluster must be in the "Running" status in order to handle the requests from Web server. PowerServer has the following status:

  • Shut down: PowerServer is not started or not available.

  • Ready: PowerServer is preparing itself to accept user requests by taking the essential initialization process.

  • Running: PowerServer is started and accepts user requests.

  • Failed: PowerServer failed to start or failed to verify license.

Load Balancing Settings

Load Balancing Settings determine how requests will be distributed among the servers in the cluster to optimize system performance and how servers in the cluster will be picked as peer servers. PowerServer cluster supports the following two load balancing algorithms:

  • Random -- distributing requests across servers in random order, regardless of the status of servers.

  • Sequence -- directing requests to servers in an allocated order. The sequence algorithm, which is also known as round-robin, is simple, cheap and very predictable.

Either algorithm can provide optimal performance for servers of similar configuration and specification, because it evenly sends requests to each server in the cluster.

Failover Settings

Failover Settings determine how the session information in the servers of the cluster is backed up in the system for failover support. With the backup settings, the sessions at a failed server can be continuously supported by the same server after the server is restarted by its status monitor, or supported by another server in the cluster. Because session backup does not back up transaction information, there may be some loss to the operations in the sessions, but the users can continue running the sessions without re-login.

PowerServer cluster provides two major backup options for failover: session backup and heartbeat backup.

Session backup

Session backup options enable a session to be backed up when PowerServer detects that the session status changes or it receives a request from the same session. You can specify the backup with different levels:

  • Session level -- backing up a session when PowerServer detects that the session is created or destroyed, or when a transaction starts or ends in the session.

  • Request level -- backing up a session each time when PowerServer receives a request from the same session, regardless of the session status.

Heartbeat backup

Heartbeat backup options enable PowerServer to automatically back up sessions at the internals you specify.

  • Remote backup: backing up all sessions from the local machine to the peer server (another server in the cluster which was picked randomly or in sequence) at the intervals you specify in the Interval Time box. Remote backup includes mirror backup and rotation backup.

    • Mirror backup: periodically backing up all sessions from the local machine to the peer server. A session is backed up at a fixed peer server. If the peer server fails, the session backup no longer works.

    • Rotation backup: periodically backing up all sessions from the local machine to the peer server. The peer server at which a session is backed up can be changed. That is, if the first peer server fails, another server will be picked as the peer server for the backup.

  • Logical Restore with Status Monitor -- backing up all sessions from the local machine to the peer server and allowing both "active" and "passive" sessions to be restored after a failed server is restarted by status monitor. If this option is disabled, only "active" sessions on the failed server will be recovered. Each server in the cluster maintains a list of "active" sessions and a list of "passive" sessions. The server recognizes a session as an "Active" session if it is created here and recognizes a session as a "Passive" session if it is created in another server and backed up here. The interval of this backup option is specified in the configuration file (monitor.props) of Status Monitor.

Synchronizing AEM settings to servers in a cluster

Once a PowerServer is added to the Cluster Server list, you can use the AEM which maintains the list to manage all servers in the cluster. Whenever you change the settings of this AEM and click Save, the settings will be saved to the other servers in the cluster. Therefore, you do not need to repeat the configuration in each AEM. However, not all of the AEM settings can be synchronized, because some settings are not necessary to be the same for all servers. The following settings will not be synchronized:

  • Logging: displays the log files on the current server only.

  • Auto cleanup and Manual cleanup in Maintenance: clears the temporary files of the current server only.

  • Deployment Sessions: displays the active deployment sessions of the current server only.

  • Licensing: displays the license information and status of the current server only.

  • Data Source: displays and configures the data source related with the current server only.

  • DataWindow Data Cache: displays and configures the DataWindow data cache related with the current server only.

  • AEM login: displays and configures the login information of AEM on the current server only.

The following action will not be synchronized:

  • Killing active sessions: this action will terminate the session on the current server only.

Maintenance

Maintenance is a set of tools for clearing temporary files and backing up configurations.

Figure 79. Maintenance

Maintenance

Auto cleanup

To perform an auto-cleanup for temporary files in the "Clean Up Periodically" group box:

Step 1 -- Specify to clean up files that have not been accessed for the specified period.

For example, "Clean up the information that is last accessed over: 2 days 4 hours ago" denotes that files that were accessed over 2 days and 4 hours ago will be cleaned up everyday.

Step 2 -- Choose whether to clean up the temporary register and profile configuration files by selecting or de-selecting the check box for "Clean up temporary register and profile configuration files".

Step 3 -- Click the Save button to apply changes.

Manual cleanup

This feature is not usually necessary if the auto-cleanup feature is used, but it can be helpful between scheduled cleanups if a sudden increase in activity on the system causes an influx of temporary files resulting in declines in performance.

To perform a manual cleanup in the "Cleanup Now" group box:

Step 1 -- Choose whether the temporary register and profile configuration files to be cleaned up by selecting or de-selecting the check box for "Clean up temporary register and profile configuration files".

Step 2 -- Click the Clean Up button to commit the cleanup.

The selected temporary files will be deleted immediately from all the PowerServer that are configured in the AEM PowerServer Cluster page.

Configuration Backup

The AEM configuration files can be backed up and restored easily using the Configuration Backup tool.

To back up the AEM configuration files:

Step 1: Select one or more configuration file from the file list.

Step 2: Select the backup mode.

  • Server Mode -- Backs up the configuration files and stores on the PowerServer machine.

  • Client Mode -- Backs up the configuration files and stores on the local client machine. You will be prompted to specify the location to store the backup file after clicking the Back Up button.

Step 3: If you select Server Mode in Step 2, then specify the destination location for the backup files. The destination location must be an existing directory on the PowerServer machine.

Step 4: Specify the archive mode for the backup files.

  • Archive Mode indicates the backup files will be packaged into a zip file. If Client Mode is selected as the backup mode, Archive Mode will be used by default.

  • Non-Archive Mode indicates the backup files will be existing in separate files.

Step 5: Click the Back Up button to back up files.

To import the AEM configuration files:

Step 1: Click the Import button.

Step 2: In the Import Configuration File page, click Browse to select the backup file to import. The backup file can be a single file or a zip file which contains multiple files.

Step 3: Click Import to import the selected backup file.