SL1 PowerFlow powerflowcontrol (pfctl) Command-line Utility Release Notes, version 2.7.4

The SL1 PowerFlow powerflowcontrol (pfctl) command-line utility version 2.7.4 includes a number of new actions, including a set of cluster-actions that let you control the memory allocation of the PowerFlow nodes and ensure full replication of all services in any failover scenario. This release also includes additional updates and new node-actions and cluster-actions.

For more information about the commands you can run using this utility, see Using the powerflowcontrol (pfctl) Command-line Utility.

The powerflowcontrol command-line utility was called iservicecontrol in previous release of PowerFlow.

Features Included in this Release

The following features were included in this version of the powerflowcontrol (pfctl) command-line utility:

• Added the following cluster-actions to apply and verify 16 GB, 32 GB, and 64 GB overrides to SaaS PowerFlow systems only. These actions let you control the memory allocation of the PowerFlow nodes and ensure full replication of all services in any failover scenario. In addition, when you run these commands on a SaaS PowerFlow system, the docker-compose.yml file is updated with deployment configurations specific to a SaaS environment.

• apply_16GB_override and verify_16GB_override. These settings support up to 25,000 to 30,000 devices, depending on the relationship depth of the devices.

• apply_32GB_override and verify_32GB_override. These settings support up to approximately 70,000 devices.

• apply_64GB_override and verify_64GB_override.

  The following command is an example of a pfctl command to apply the 32 GB override:

  pfctl --host 10.10.10.100 'isadmin:testing@is' --host 10.10.10.102 'isadmin:testing@is' --host 10.10.10.105 'isadmin:testing@is' cluster-action --action apply_32GB_override

• When you run the overrides listed above, the updates are applied automatically to the PowerFlow server as well as to the docker-compose.yml file. You do not need to redeploy the whole stack.
• Updated the healthcheck action to detect additional issues in the docker-compose.yml file, and updated the autoheal action to fix those issues in the the docker-compose.yml file.
• The healthcheck node-actions and cluster-actions include the following features:

• check_debug_run. Checks if you have run any debug-level runs of PowerFlow applications in the past day and provides a notification if you have.
• check_schedule_debug_enable. Checks if you have scheduled any debug-level runs of PowerFlow applications and provides a notification if you have.

• Added the check_docker_service_update_status action as a node-action or a cluster-action. This action iterates over all the running services in PowerFlow and checks the status of the Docker service after running a docker service update command.

• In addition, you can use the --update-parallelism option with the docker service update command to along with a value of 0, to update all Docker services at once.

  Use the following format for the docker service update command:

  docker service update --update-parallelism <uint><configurations_to_update><service_name>

  where <uint> is the number of replicas that you want to update in parallel. Use a value of 0 to update all Docker services at once. For example:

  docker service update --update-parallelism 0 iservices_couchbase-worker --env-add AUTO_REBALANCE=true

• Updated the increase couchbase allocations setting so that Couchbase will not increase the memory if the memory has been increased already. You can check the value of the memory allocation on the Settings tab of the Couchbase user interface at https://<IP of PowerFlow>:8091.

To view release notes and manuals for all versions of the SL1 PowerFlow Platform, see SL1 PowerFlow Platform Documentation. To view release notes and manuals for PowerFlow SyncPacks, see SL1 PowerFlow SyncPack Documentation.

Known Issues

This release does not contain any known issues.

Installing the powerflowcontrol (pfctl) Command-Line Utility

To locate and download the powerflowcontrol (pfctl) utility:

1. Go to the ScienceLogic Support site at https://support.sciencelogic.com/s/.

2. Click the Product Downloads tab and select PowerFlow. The PowerFlow page appears.

3. Click the link for the current release. The Release Version page appears.

4. In the Release Files section, click the link for the version of PowerFlow Control you want to download. The Release File Details page appears.

5. Click the Download File button to download the .whl file for the powerflowcontrol utility.

6. Using WinSCP or another file-transfer utility, copy the .whl file to a directory on the PowerFlow system.

7. Go to the console of the PowerFlow system or use SSH to access the PowerFlow system.

8. To install the utility, run the following command:

   sudo pip3 install iservicecontrol-2.7.4-py3-none-any.whl

9. To check the version number of the utility, run the following command:

   pip3 show iservicecontrol