Table of Contents

Search

  1. Preface
  2. Introducing Administrator
  3. Organizations
  4. Licenses
  5. Ecosystem single sign-on
  6. SAML single sign-on
  7. Source control and service upgrade settings
  8. Users and user groups
  9. User roles
  10. Permissions
  11. Runtime environments
  12. Serverless runtime environments
  13. Secure Agent services
  14. Secure Agent installation
  15. Schedules
  16. Bundle management
  17. Event monitoring
  18. File transfer
  19. Troubleshooting

Administrator

Administrator

Process Server properties

Process Server properties

To change or optimize the behavior of Process Server, configure Process Server properties. You can configure the server, Secure Agent group, Java Virtual Machine, connector, database, and logging properties.
The following image shows some Process Server properties:
You can configure the following server properties:
Name
Communication Method
Description
host-name
Secure Agent Channel
The host name of the Process Engine server.
shutdown-port
Secure Agent Channel
Process Server Tomcat shutdown port.
key-alias
HTTPS
The identifier of the keystore record that contains security keys for HTTPS communication.
key-store
HTTPS
The path to the key store file that
Application Integration
uses for HTTPS communication. When you install the Secure Agent, you find the key store in the following default location:
<Secure Agent installation directory>/apps/process-engine/conf/ae.keystore
. Here,
ae.keystore
is the key store file.
Important:
Enter only the path to the key store file.
key-store-password
HTTPS
The key store password. The default password is
password
.
trust-store
HTTPS
The path to the trust store file that
Application Integration
uses for HTTPS communication. When you download the Secure Agent, you find the trust-store in the default location,
process-engine/conf/ae.cacerts
. Here,
ae.cacerts
is the trust store file.
If you want to import public certificates for service endpoint authentication, place them in the following location:
<Secure Agent installation directory>\apps\process-engine\conf\certs
Important:
Enter only the path to the trust store file.
trust-store-password
HTTPS
The trust store password. The default password is
changeit
. You can change the password.
ldap-enabled-realm
HTTP/HTTPS
Set this property to
True
if you want to use an LDAP provider for authentication. Use the LDAP provider as a centralized form of authentication when you have clustered Secure Agents.
ldap-properties
HTTP/HTTPS
The LDAP properties that you need to configure. Edit the existing properties to suit your LDAP provider.
Your LDAP password does not appear on screen. The value of
$(pe.ldap.password)
is taken from the
PE_LDAP_PASSWORD
environment variable
ssl-enabled-protocols
HTTPS
The TLS protocol to use. The default protocol, TLSv1.2, is the most secure protocol. Change this value to an older version like TLSv1.0 or TLSv1.1 only if you face compatibility issues
ephemeral-DH-key-size
HTTPS
The key length of the secure algorithm. The default value is 2048. Change this value only if you face compatibility issues.
use-secure-ciphers-only
HTTPS
Limits the set of ciphers used during a call to the endpoint to secure ciphers only. The default value is True. Change this value to false only if you face compatibility issues.
You can configure the following Secure Agent group ('cluster' on the UI) properties:
Name
Communication Method
Description
name
HTTP/HTTPS
The name of the Secure Agent group.
primary-node
HTTP/HTTPS
Set this property to
True
if you want the Secure Agent to be the master agent. When you select a master agent, you create a Secure Agent cluster. In a cluster, all Secure Agents share the postgreSQL database of the master Secure Agent.
load-balance-url
HTTP/HTTPS
The load balancer URL that you can use to invoke the process deployed to the Secure Agent.
Applicable if you have a load balancer.
You can configure the following Java Virtual Machine properties:
Name
Communication Method
Description
min-heap
Secure Agent Channel
The minimum heap memory that Process Server allocates to the Tomcat JVM.
max-heap
Secure Agent Channel
The maximum heap memory that Process Server allocates to the Tomcat JVM.
additional-properties
Secure Agent Channel
A custom system property that you can add to the Tomcat JVM set. For example, you can set the custom property
-Dsun.net.inetaddr.ttl=60
You can configure the following connector properties:
Name
Communication Method
Description
http-port
HTTP
The HTTP port to which the Secure Agent sends data. The default port is 7080.
For more information about the construction of REST and SOAP endpoint URLs, see the
Application Integration
help.
http-maxThreads
HTTP
The maximum number of connections that Process Server creates with
Application Integration
over HTTP.
http-connectionTimeout
HTTP
The maximum time, in milliseconds, that Process Server waits for an HTTP connection to reply.
https-port
HTTPS
The HTTPS port to which the Secure Agent sends data. The default port is 7443.
For more information about the construction of REST and SOAP endpoint URLs, see the
Application Integration
help.
https-maxThreads
HTTPS
The maximum number of connections that Process Server creates with
Application Integration
over HTTPS.
https-connectionTimeout
HTTPS
The maximum time, in milliseconds, that Process Server waits for an HTTPS connection to reply.
secure-channel maxThreads
Secure Agent Channel
The maximum number of connections that Process Server creates with
Application Integration
.
secure-channel-connectionTimeout
Secure Agent Channel
The maximum time, in milliseconds, that Process Server waits for a connection to reply.
You can configure the following database properties:
Name
Communication Method
Description
type
Secure Agent Channel
The database type that Process Server runs on.
Do not change this setting. The
Application Integration
Secure Agent does not support other databases.
driver
Secure Agent Channel
The database driver that Process Server runs on.
Do not change this setting. The Informatica Cloud Secure Agent does not support other databases.
URL
Secure Agent Channel
URL at which Process Server accesses the database.
Do not change this setting. The Informatica Cloud Secure Agent does not support other databases.
maxActive
Secure Agent Channel
The maximum number of active connections allocated to Process Server database at the same time.
maxIdle
Secure Agent Channel
The maximum number of connections that can remain idle at a time in the database. Process Server releases connections if the number of idle connections crosses this number.
maxWait
Secure Agent Channel
The maximum time that the database waits for a connection if none are available.
connection-properties
Secure Agent Channel
Key-value pairs of database connection properties. Some keys are available by default.
Do not delete the default keys. You can, however, change the values of these keys.
You can add other key-value pairs. For example, you can add the following key-value pair:
key:
autoReconnect
value:
true
You can configure the following logging properties:
Name
Communication Method
Description
1catalina_org_apache_juli_FileHandler_level
Secure Agent Channel
The level of logging in the file:
< Secure Agent installation directory>\apps\process-engine\logs\catalina.log
.
Default:
FINE
2localhost_org_apache_juli_FileHandler_level
Secure Agent Channel
The level of logging in the file:
< Secure Agent installation directory>\apps\process-engine\logs\localhost.log
.
Default:
FINE
3manager_org_apache_juli_FileHandler_level
Secure Agent Channel
The level of logging in the file:
< Secure Agent installation directory>\apps\process-engine\logs\manager.log
.
Default:
FINE
4host_manager_org_apache_juli_FileHandler_level
Secure Agent Channel
The level of logging in the file:
< Secure Agent installation directory>\apps\process-engine\logs\host-manager.log
.
Default:
FINE
java_util_logging_ConsoleHandler_level
Secure Agent Channel
The level of logging in the
CMD
window that appears when you start Tomcat.
Default: FINE
org_apache_catalina_core_ContainerBase_Catalina_localhost_level
Secure Agent Channel
The level of logging in the
localhost.log
file when you host Tomcat on a virtual machine.
Default: INFO
org_apache_catalina_core_ContainerBase_Catalina_localhost_manager_level
Secure Agent Channel
The level of logging in the
manager.log
file when you host Tomcat on a virtual machine.
Default: INFO
org_apache_catalina_core_ContainerBase_Catalina_localhost_host-manager_level
Secure Agent Channel
The level of logging in the
host-manager.log
file when you host Tomcat on a virtual machine.
Default: INFO


Updated August 03, 2020