How To Override Default Vendor Configurations

No direct changes to the default Unified Assurance configuration files are supported since future package updates will overwrite them every time. Unified Assurance does allow overrides to be made by following the instructions in this guide. Some configuration changes may have adverse affects on the overall Unified Assurance product, so all changes are recommended to be tested in a development or staging environment prior to deployment in production.

Note:

In the below examples, the "*" can be replaced with any text that would be descriptive of the configuration file's purpose. As an example, a file name of base-phptimeout.conf could be used when updating the user session length.

Support Modifications

Apache

The default configuration can be customized by including any base*.conf or ssl*.conf files that are in the $A1BASEDIR/etc/apache/ directory:

$A1BASEDIR/etc/apache/*.conf

base*.conf files are included in the primary configuration section.
ssl*.conf files are included in the VirtualHost configuration section.

The Vendor Apache Configuration package distributes several example customizations that are located in the $A1BASEDIR/distrib/config/vendorApache/apache/ directory.

Sample Case 1

Enable debugging with non-minified Javascript libraries.

Copy $A1BASEDIR/distrib/config/vendorApache/apache/base-ui-debug.conf to $A1BASEDIR/etc/apache.
Use the following command to restart the web service.
```
service assure1-web restart
```

Sample Case 2

Additional configuration settings may be required when using externally signed certificates.

In the above directory, create the file ssl-chain.conf.

SSLCertificateChainFile $A1BASEDIR/etc/ssl/intermediate.crt

Use the following command to restart the web service.
```
service assure1-web restart
```

MySQL

The default configuration can be customized by including any *.cnf files that are in the $A1BASEDIR/etc/mysql/ directory.

$A1BASEDIR/etc/mysql/*.cnf

The Vendor MySQL Configuration package distributes several example customizations that are located in the $A1BASEDIR/distrib/config/vendorMySQL/mysql/ directory.

Sample Case 1

The default maximum number of connections is 100. This can be updated, if required.

In the above directory, create the file custom-max_connections.cnf.
```
[mysqld] 
max_connections = 200
```
Use the following command to restart the web service.
```
service assure1-db restart
```

Sample Case 2

The default INNODB Buffer Pool Size the database can use is 128 megabytes. This can be updated, if required.

In the above directory, create the file custom-innodb_buffer_pool_size.cnf.
```
[mysqld] 
innodb_buffer_pool_size = 256M
```
Use the following command to restart the web service.
```
service assure1-db restart
```

Neo4j

The default configuration can be customized by changing the neo4j.conf file that is in the $A1BASEDIR/etc/neo4j/ directory.

$A1BASEDIR/etc/neo4j/neo4j.conf

Use case example 1

The default amount of memory Neo4j will use is 1 gigabyte. This can be updated, if required.

In the above directory, edit the neo4j.conf file.

Find and comment the existing lines in the conf file:

dbms.memory.heap.initial_size=1g
dbms.memory.heap.max_size=1g

Copy and paste the below lines with a new value to change the amount of memory being used:
```
dbms.memory.heap.initial_size=2g
dbms.memory.heap.max_size=2g
```
Login to the UI and go to the broker control Services UI:

Configuration -> Broker Control -> Services
Find and select the "Neo4j" service, then click on the "Restart" button.

PHP

The default configuration can be customized by including any base-php*.conf files that are in the $A1BASEDIR/etc/apache/ directory.

$A1BASEDIR/etc/apache/base-php*.conf

Note:

PHP cannot include custom files, but Apache can. Apache can pass additional configuration options to PHP.
This does not include loading new PHP Modules.

Use case example 1

The default user session will timeout 8 hours after the last API call is made by the browser. This includes refresh calls made by interfaces that auto-refresh like Dashboards or the Event List. This can be extended for all users by updating the PHP variable in a custom Apache include file.

In the above directory, create the file base-php.conf.
Add the following in the conf file to set a session time out of 86400 seconds (one day):
```
php_value session.gc_maxlifetime 86400
```
Use the following command to restart the web service.
```
service assure1-web restart
```

Use case example 2

The default amount of memory a script can use is 128 megabytes. This can be updated, if required.

In the above directory, create the file base-php.conf if not already created.
Add the following in the conf file to set a higher maximum amount of memory that can be used.
```
php_value memory_limit 256M
```
Use the following command to restart the web service.
```
service assure1-web restart
```

Title and Copyright Information

Implementation Guide

F59716-01