Use this page to set the options that affect the primary EPM server

Note:

If the media server type is MPP, you can also use this page to set the options that affect the optional auxiliary EPM server.

Use this page to view the options that affect both the primary EPM server as well as the optional auxiliary EPM server.

Note:

If the media serer type is MPP, you can also use this page to view the options that affect the optional auxiliary EPM server.

This page contains the:

General section

Field

Description

Experience Portal Name

The name of this Experience Portal system. Experience Portal displays this name on the Summary tab of the System Monitor page.

Number of Application Server Failover Logs

The number of backup logs to retain on the application server in case the application server cannot communicate with the Experience Portal database.

Each log file can be up to 100MB in size.

The number of failover logs determines how much data the server can send to the EPM when the connection is restored. If the number of failover logs is exceeded, the application server deletes the oldest log file and begins recording data in a new file. When that file is full, the application server deletes the oldest log file and opens a new file. This process is repeated until contact with the Experience Portal database is restored and the application server can write its logs to that database.

Commands to Retain in Configuration History

The number of media server configuration changes that Experience Portal should save in the database.

This value determines the number of entries on the <Media Server Name> Configuration History page.

Resource Alerting Thresholds (%) group

Field

Description

Disk

The low water threshold determines when the EPM generates an event, warning you, that disk usage is getting high. The high water threshold determines when the EPM generates an alarm, warning you, that disk usage is getting dangerously high.

  • High Water: Enter a whole number from 0 to 100. The default is 90.

  • Low Water: Enter a whole number from 0 to 100. The default is 80.

HTML Units

The HTML usage threshold determines when the system approaches the licensed usage limit.

The administrator can configure the HTML usage threshold that triggers an alarm when the system approaches the licensed usage limit.

The threshold is displayed in percentage.

Report Database group

Note:

If these fields are not displayed, click the group heading to expand the group.

Field or Button

Description

Location radio buttons

The options are:

  • Local: The database resides on the local EPM server machine.

  • External: The database resides on a different server. This option is generally used when you have several Experience Portal systems that share an external database.

Note:

If you select External, the rest of the fields in this section become available. Contact your database administrator if you do not know the information to complete these fields.

URL

The fully-qualified path to the external database.

A common URL format for Oracle connections is: jdbc:oracle:thin:@OracleServerName:1521:DBName

A format for PDB (portable db) connections is: jdbc:oracle:thin:@ServerName:1521/pdbName

A format for CDB (container db) connections is: jdbc:oracle:thin:@ServerName:1521/cdbName

A common URL format for Postgres is: jdbc:postgresql://PostgresServerName:5432/DBName

A common URL format for Microsoft SQL connections is: jdbc:sqlserver://SQLServerName:1433;databaseName=DBName

A common URL format for MySQL connections is: jdbc:mysql://ServerName:3306/DBName

A common URL format for MariaDB connections is: jdbc:mariadb://ServerName:3306/DBName

JDBC Driver

The name of the Java class that implements the JDBC API to the external database. Experience Portal makes JDBC calls through this class when communicating with the external database. Experience Portal installs drivers for Oracle, Postgres and Microsoft SQL Server.

For Oracle, the name is oracle.jdbc.driver.OracleDriver.

For Postgres, the name is org.postgresql.Driver.

For Microsoft SQL Server, the name is com.microsoft.sqlserver.jdbc.SQLServerDriver.

For both MySQL and MariaDB, the name is org.mariadb.jdbc.Driver.

User Name

The user name for the external database.

Note:

For Oracle, the user name must be assigned CREATE TABLE, CREATE SESSION and CREATE SEQUENCE privileges for the database.

For Microsoft SQL Server, the user name must be assigned SELECT, INSERT, UPDATE and DELETE privileges on all tables in the database.

For Postgres, the user name must be assigned CONNECT, TEMPORARY ON DATABASE, SELECT, INSERT, UPDATE and DELETE privileges on all tables in the database.

For both MySQL and MariaDB, the database user name for Experience Portal must be assigned SELECT, INSERT, UPDATE, DELETE privileges on all tables in the database. The CREATE TEMPORARY TABLE permission is also required. When creating the database, set a collation type of utf8_unicode_ci.

Password

The password for the external database.

Web Service Authentication group

Important:

If you change the user name or password, there will be a delay of two-minute before these changes propagate across the system. Any request for web services made with the new user name and password will fail until that propagation is complete.

Note:

If these fields are not displayed, click the group heading to expand the group.

Field

Description

Application Reporting section

User Name

The user name to send to the Application Logging web service for Digest Authentication.

Note:
  • The user name must not contain the : ! ( ) characters.

  • You cannot use the same user name for both the Application Logging web service and the Application Interface web service.

Password

The password associated with the specified user name.

Verify Password

The associated password again for verification purposes.

Outcall section

Note:

The Outcall section is available in EPM only if the media server is MPP.

User Name

The user name to send to the Application Interface web service.

Note:

You cannot use the same user name for both the Application Logging web service and the Application Interface web service.

Password

The password associated with the specified user name.

Verify Password

The associated password again for verification purposes.

Miscellaneous group

Field

Description

License Re-allocation Wait Time (minutes)

The number of minutes the system waits before reallocating the licenses from a media server that is out of service to other media servers in the system.

Enter a whole number from 0 to 1440. The default is 10.

Operational Grace Period (minutes)

The number of minutes Experience Portal waits for processing to complete before it terminates the remaining EP activities for any of the following Primary EPM, Auxiliary EPM, and MPP commands:

  • Stop

  • Reboot

  • Halt

Enter a whole number of minutes between 0 and 999 in this field.

Important:

Ensure that the grace period is long enough for the media server to complete any existing activity before it invokes one of the EP Media Server commands mentioned above.

Event Level Threshold to Send to EPM

Besides Fatal alarms, which are always sent, the lowest level of events and alarms to be included in the tracing log that is sent to the EPM.

The options are:

  • Error: Fatal alarms and Error alarms are sent.

  • Warning: Fatal alarms, Error alarms, and Warning events are sent.

  • Info: All events and alarms are sent.

    Note:

    Selecting the Info option can cause performance problem as all events and alarms are sent from the media server to EPM.

Multi-Media Server Numeric ID Range

Experience Portal assigns a numeric ID for each MPP server, Email processor, and SMS processor in the Experience Portal system from the number range given in this field. This numeric ID identifies the MPP in the Experience Portal database and becomes part of the Universal Call Identifier (UCID) associated with every call processed on that MPP server, Email processor, or SMS processor.

Tip:

The ID assigned to a specific MPP server is displayed in the Unique ID field on the <MPP name> Details page for that server.

Enter a range between 1 and 32,767. The default range is 10,000 to 19,999.

Important:

You should only change this value if other components in your call center create Universal Call Identifier (UCID) values that conflict with the default Experience Portal values.

If you do change the value, ensure that you specify a range that covers all MPP servers, Email processors, and SMS processors in your Experience Portal system.

Maximum Number of Conversations per Server

The maximum number of conversations that can be stored at any given time on either a Primary EPM or an Auxiliary EPM.

Enter a range between 0 and 1000000. The default value is 500000.