The SDMS Policy is used by the Scientific Data Management System module.

This policy has five groups for properties. They are:
  1. Automation Setings
  2. Collector Defaults - used when a new Collector is added to the system
  3. Error Handling - The option to pause a collector or instrument when errors are encountered
  4. External Collector Installer Defaults - for installing Collectors on a host other than the LIMS host
  5. Data Capture Links - Default URLs for viewing SDIs from a Data Capture

 


Property values are set through System Admin > Configuration > Policies... SDMSPolicy > Sapphire Custom

Automation Settings

General Collector Properties

Internal Collector Balancing

How quickly in seconds internal collectors balance themselves across a cluster as nodes get added or removed

Poll Data Capture Folders

How frequently in seconds to poll data-caputre folders for Indirect file transfers

Indirect Files/Folders Retention Time

Indirect data capture files will be deleted automatically after they have reached this age. Should be set to Indefinate if attaching by reference.

Collector Defaults

Most intervals are in seconds (s)

Server Ping Interval (s)

Frequency in seconds that a collector pings the server to update its status and make sure LIMS is alive.

Fast Server Ping Interval (s)

Same as “Server Ping”. This (shorter) frequency occurs when the collector is being viewed in the monitor dashboard and a user has enabled this faster ping.

Default Instrument Ping Interval (s)

Frequency (seconds) to poll the instruments (data sources) if no other values  are set

Wait Before Isolated Mode (s)

Length of time (seconds) before a direct collector type will switch to indirect mode if pings of the LIMS server are unsuccessful.

Hashing Max Size (GB)

Files larger than this size will not be hashed. This applies only to indirect collectors where hashing is enabled.

Diskspace Check Interval (s)

Recommended value is 3600 seconds. This would mean once an hour, the collector checks the disk space on its host and signals an alert if the availabe space falls below the threshold you have on your collector. Checking available disk space can put a demand on system resources. It is recommended to keep this at a minimum.

Missed Poll Interval Count

How many poll intervals must be missed to alert a collector might be hung. This may occur if your collector is busy capturing files when the next interval check is supposed to occur.

Memory-base Log - Max Age (hours)

Limits the amount of log information available to be viewed through the dashboard. Recommended max is 48 hours to reduce memory allocated to this feature.

Memory-base Log - Max Rows

Recommended max is 5000.

Error Handling

Pause or continue collecting after an error

On Collection Failure

Allows you to temporarily suspend all data captures when the instrument's collector type encounters an error. You will be required to manually resume collection of additional instrument data.

On Handler Execution Failure

Allows you to temporarily suspend all data captures when the instrument's Attachment Handler encounters an error. You will be required to manually resume collection of additional instrument data once resolved.

External Collector Installer Defaults

This section only applies to External Collectors. If you are not deploying external to the LIMS application server, these properties are not used.

External URL back to LIMS

External collectors will communicate with LIMS at this address

Install Image Folder

Defaults to:

[labvantagehome]/console/install/externalapps/sdmscollector/product

This is a path on the LabVantage application server. It is created when you install LIMS. When an external collector's installer is created, LabVantage will read the Windows or UNIX files in this path. The files will then be zipped and presented to the user for download through the browser. Specify the full path. This could use a variable such as is shown in the default.

Product Jar Folder

Defaults to:

[labvantagehome]/console/install/ear

When an external collector's installer is created, LabVantage will read the sapphire.jar and sdmscollector.jar files in this directory. This could use a variable such as is shown in the default.

Custom Jar Folder

Defaults to:

[labvantagehome]/console/install/externalapps/sdmscollector/custom

When an external collector's installer is created, LabVantage will read any custom JAR files you placed in this directory and include them in the download. This is necessary if you have created any custom Collector Types.

JRE Option

Choose Bundle, Local Path, or Local Java Home

Initial Heap Size

Java parameter for memory allocated to this process.

Max Heap Size

Java parameter for memory allocated to this process.

Additional JRE Options

For advanced users.

loglevel

Choose None, Fatal, Error, Warn, Status, Info, or Debug to control the level of detail in your log files.

Max Size( Mb )

If a log file grows to this size, the Collector spawn a new log file.

Max Files

After this number of log files are in the logs directory, the oldest log file will be deleted before creating a new log file.

Check Deadlock

Yes enables the detection of deadlocks. If detected, the system can send you an email. See below.

Log INFO level information

Yes will log detailed information at the INFO level each time an email is sent.

SMTP Host

The Wrapper will attempt to connect to this email host.

SMTP Port

The port number of your SMTP host when sending email.

Subject

Configures the subject of the email.

Sender

Specifies the from address of the email.

Recipient (s)

Specifies the recipient(s) of the emails. When more than one email is specified, they must be separated by a semicolon (;)

Email When Wrapper Starts

Yes or No

Email When Deadlock Is Detected

Assumes deadlock detection is enabled above.

Email When JVM Fails

Occurs whenever the JVM has exited in a state which results in a restart.

Email When JVM Fails Even After Trying Repeatedly

Occurs whenever the JVM has exited in a state which results in a restart and the total number of consecutive failed invocations is more than 5

Email When JVM Unexpectedly Exits

Occurs whenever the JVM process disappears for an unexpected reason.

Email When JVM Is Killed

Occurs whenever the JVM process is terminated.

JVM Restart Email body

Specifies the email body to be sent when JVM restart event occurs.

Data Capture Links

Allows a URL to be created within LIMS linking a Data Capture to items affected by an Attachment Handler.

SDC

Choose an SDC. For example "Sample". This provides a link to this SDC's primary table data from the Data Capture

Link

Specify which page to open. For example: SampleView

Target

Add a value here (such as _blank) if the link should open the page in a new window.