Setting logging preferences

Top  Previous  Next

JSCAPE MFT Server logs all user activity to a log directory or JDBC accessible database.  To configure logging preferences go to the Logging node in JSCAPE MFT Server Manager for the desired domain.

 

File Log

Database Log

Syslog

Verbose Logging

Restoring a Database Log

 

File Log

 

Logs all server activity to a directory.

 

Figure 12

 

clip0012

 

 

Directory - The directory where to store log files.

 

File rotation - The frequency in which to rotate log files.

 

 

Database Log

 

Logs all server activity to a JDBC accessible database.  To use the Database log option you must first create the database and necessary tables on your database server and register the appropriate database driver with JSCAPE MFT Server.  Example database schema for MySQL, Microsoft SQL Server and Oracle are provided in the files etc/mysql-log.sql, etc/mssql-log.sql, etc/oracle-log.sql, and etc/postgresql-log.sql respectively. The etc directory is found inside the JSCAPE MFT Server installation directory.  Libraries for JDBC drivers must be placed in the libs/jdbc directory of your JSCAPE MFT Server installation, the JSCAPE MFT Server Service restarted and the JDBC driver class registered in Settings > JDBC Drivers in order for the database to be accessible to JSCAPE MFT Server.

 

Figure 63

 

clip0063

 

 

 

JDBC URL - The JDBC URL used to connect to the database.  The above example demonstrates connecting to a MySQL database.  Contact your database vendor for access to JDBC libraries and assistance on specifying the JDBC URL.

 

Username - The username to connect with when authenticating with database.

 

Password - The password to connect with when authenticating with database.

 

Pool - The maximum number of connections in database pool.

 

Pool timeout - The maximum amount of time in minutes that the database connection can live in the pool without activity.

 

Test Parameters - Tests database connection using the specified settings.

 

See also

 

JDBC settings
 

 
Syslog

 

Logs all activity to a syslog daemon in addition to your existing File Log or Database Log settings.  To use the Syslog option you must have an existing syslog daemon running.  This may be a local or remote syslog daemon.

 

Figure 116

 

clip0116

 

 

Host - The IP address of syslog daemon.

 

Port - The port of syslog daemon.

 

Facility - The syslog facility to use.

 

Process name - Process name tag to apply to all log messages sent to syslog daemon.

 

 

Verbose Logging

 

If you need to debug a connection related issue it is often helpful to enable verbose logging.  This can be enabled using the Settings tab and checking the Enable verbose log option.  This option is disabled by default and should only be used for temporary debugging purposes as verbose logging contains a lot of information that can significantly slow performance and increase the size of log files.

 

Figure 65

 

clip0065

 

 

 

Restoring a Database Log

 

In the event that the database server cannot be contacted logging data will be directed to a temporary file located in the backup directory of your JSCAPE MFT Server installation.  To move the contents of this temporary log file to your database use the js-backuplog command providing the domain that you wish to restore.  The js-backuplog executable may be found in your JSCAPE MFT Server installation directory.

 

Example

 

js-backuplog -domain localhost

 

The above command moves the contents of the temporary log file for domain localhost to the log database assigned to this domain.