boot and store updates

After upgrade, manual editing is required for files:

  • boot.json
  • phenix-store.json

Update must be done prior to starting the system.

Step by step document for upgrade can be found here:
Upgrade

NOTE: Both outgoing and incoming communication has changed with this new module, where 2MB (2097152) is the default value.
The following patch (for version 4.0.5), needs to be applied to increase this value for http communication:
Httpclient
To change this value for file upload, use the startup parameter:
-Dcom.phenixidentity.globals.httpRequestBodyMaxSize=<property-value>
This parameter is set in the startup file for Linux and in phenixidservice.vmoptions on Windows.
More information:
Globals

boot.json

Locate the section "default_modules".  Insert the section below:

{
                "name": "com.phenixidentity~phenix-httpclient-mod",
                "scope": "global",
                "singleton": "true",
                "config": {
                    "_proxy": "",
                    "ssl_tls_version": "TLSv1.2",
                    "ssl_trust_all": "false",
                    "_ssl_keystore_ref": "",
                    "_ssl_truststore_ref": "",
                    "request_timeout": "2000",
                    "connect_timeout": "-1",
                    "socket_timeout": "-1",
                    "allow_redirect": "false",
                    "allow_relative_redirect": "false",
                    "max_redirects": "0",
                    "request_body_max_size": "2097152",
                    "response_body_max_size": "2097152"
                }
}

See attached reference file  for detailed view.

phenix-store.json

On the "ADVANCED" tab, locate the section "MODULES". 

Insert the section below:

{
    "name" : "com.phenixidentity~phenix-httpclient-mod",
    "scope" : "global",
    "singleton" : "true",
    "config" : {
      "_proxy" : "",
      "ssl_tls_version" : "TLSv1.2",
      "ssl_trust_all" : "false",
      "_ssl_keystore_ref" : "",
      "_ssl_truststore_ref" : "",
      "request_timeout" : "2000",
      "connect_timeout" : "-1",
      "socket_timeout" : "-1",
      "allow_redirect" : "false",
      "allow_relative_redirect" : "false",
      "max_redirects" : "0",
      "request_body_max_size" : "2097152",
      "response_body_max_size" : "2097152"
    },
    "enabled" : "true",
    "created" : "2020-11-24 11:17:56.988",
    "id" : "84d7028c-9174-459d-8eeb-c6fed70d77ab"
  }

Locate the section "NODE_GROUPS"

Locate the "node group" with the name "default" ( "name" : "default").

In the "module_refs" parameter, add the id if the newly added module, 84d7028c-9174-459d-8eeb-c6fed70d77ab.

Example:

 {
    "name" : "default",
    "description" : "Default node group (created automatically) - all nodes belong to this group",
    "config" : {
      "module_refs" : "84d7028c-9174-459d-8eeb-c6fed70d77ab"
    },
    "created" : "2020-11-24 11:17:57.007",
    "id" : "7dda2447-2f86-4743-88ba-3ce65bd984fa",
    "modified" : "2020-11-24 11:17:57.017"
  }

Note that the example above does not represent a working production configuration.