System

Complete

The Administration - System screen provides an overview of current:

 

 

Application Caches

Complete

The Application Caches window displays current memory use and statistics for select caches in OpenVPMS.
This is launched by clicking Caches in Administration - System.

The table displays:

  • Name
 The cache name.
  • Elements
 The number of elements currently in the cache.
  • Max Elements
 The maxium number of elements the cache can hold, before old elements are discarded.
  • Use
 The cache use, expressed as a percentage.
  • Cache Hits
 The number of times an element was in the cache when it was requested.
  • Cache Misses
 The number of times an element was not in the cache when it was requested.
  • Size
 An approximate calculation of the cache size.

The buttons are:

  • Edit
 Change the selected cache.
  • Refresh
 Refreshes the statistics.
  • Reset Statistics
 Resets the Cache Hits and Cache Misses to zero. This can be used to help evaluate the effectiveness of a change to the Max Elements of a cache.
  • Clear Cache
 Releases memory allocated to a cache.
  • Close
 Close the window.

 

Changing a Cache

The Edit button displayed a Change Cache window for the selected cache.

This displays the current maximum elements for the cache, and provides options to select a suggested value for the cache size, or enter a new one.

The cache size should be changed if:

  • there are too many cache misses vs cache hits.
    This indicates that the cache is too small and that Max Elements should be increased.
  • memory consumption is too high
    Here Max Elements should be decreased.

 

Note that the suggested size does not take into account memory consumption.

 

 

Diagnostics

Complete

The Diagnostics window supports viewing:

This can aid quick diagnosis of problems where access to the server or database is limited.

The buttons are:

  • Refresh
 Refresh the current view.
  • Mail
 Emails a snapshot of the system information.
  • Re-load Log4j configuration
 Available on the Logs tab. Re-reads the log4j2.xml file in <TOMCAT-HOME>\webapps\openvpms\WEB-INF\classes and then apply the changes without having to restart Tomcat.
See also Troubleshooting.

Memory

This tab  displays:

  • Total Memory
 The maximum amount of memory that the Java virtual machine will attempt to use.
  • Free Memory
 The amount of unused memory.
  • Use
 The memory use, expressed as a percentage.
  • Allocated Now
 The amount of memory currently available to the Java Virtual Machine.
  • Free Now
 The amount of memory currently available to the Java Virtual Machine that is unused.

MySQL - InnoDB

This tab displays the result of the SQL statement:

SHOW ENGINE INNODB STATUS

If the message:

Access denied; you need (at least one of) the PROCESS privilege(s) for this operation

is displayed, it means that the MySQL user doesn't have permissions to execute the command.

This can be granted using the following SQL statement:

GRANT SELECT, PROCESS ON *.* TO 'openvpms'@'localhost';

Replace 'openvpms' and 'localhost' the actual database user name and host if they have been changed from their default values.

NOTE: this may not take effect until Tomcat has been restarted.

Document Locks

Complete

The Document Locks tab displays the users that have locks on documents to prevent other users from overwriting their changes. These locks are created by OpenOffice when External Edit is used to edit a document.

Each row in the table displays:

  • the user login name
  • the user name
  • the name of the locked document
  • the time when the lock expires - note that this time will normally be a couple of minutes in the future. When this time is reached the system checks that the document is still being edited, and if so renews the lock.

Locks can be filtered by login name, user name or host.

The Delete button can be used to delete a lock that needs to be cleared. Normally the lock will be removed when the document has finished being edited.

 

Plugins

Complete

The Plugins screen displays the status of the plugin support in OpenVPMS.

Plugin support is initially disabled. To enable it, click Configure and enter the path to the plugins directory. For a standard OpenVPMS installation, this is the plugins directory located in the OpenVPMS installation directory.

Each row in the table displays the plugin:

  • identifier
  • name
  • version
  • status

The buttons are as follows:

Start Start the selected plugin.
Stop Stop the selected plugin.
Install Plugin

Install a plugin.
This must be is a .jar file that follows OSGi packaging conventions.
NOTE: Only install plugins from sources that you trust, as they have full access to your OpenVPMS data.
Refresh Refresh the display.
Configure Configure plugin support.

 

Updating Plugins

There is currently no user interface support to directly update plugins.

To update a plugin:

  1. remove the existing version from the plugins/deploy/ directory
  2. restart Tomcat
  3. install the new version using Install Plugin

Failure to correctly remove the existing version of the plugin may result in multiple versions being installed, with unpredictable results.

Sessions

Complete

The Sessions tab displays current user sessions.

 

Each row in the table displays:

  • the user login name
  • the user name
  • the host they are logged in from

NOTE: this may be the address of a firewall or proxy, rather than the user's actual address.

  • when they logged in
  • when they last accessed the session

Sessions can be filtered by login name, user name or host.

The buttons are:

  • Smart Flow Sheet
 Displays the Smart Flow Sheet status and enables the interface to be restarted.
  • Caches
 Displays the Application Caches window.
  • Diagnostics
 Displays the Diagnostics window.