Skip to content

DataSplice Support Website

Sections
Personal tools
 

System Information - Options

Selecting the Options item in the left pane will display screens that allow various server options to be set. There are four tabs to choose from:

  1. Properties
  2. Connection Profiles
  3. System Attributes
  4. Licenses

Options Screenshot

Properties Tab

The Properties tab displays basic server settings, such as connection options. The following settings are available:

Properties Tab Screenshot

Server Port

Specifies which TCP port the DataSplice Server will use to listen for incoming connections. This will not normally need to be changed. To obtain this information, contact your system administrator.

Note: Changes to this option will not be applied until the DataSplice Server is restarted.
Max Worker Threads

This controls the maximum number of worker threads used by the DataSplice Server to handle remote connections.

Server Administrator

This is the name of the server administrator, such as John Smith. It is presented to remote users in case of certain problems so they can contact an administrator for assistance. This field is only a reference and is not used by DataSplice.
Client Timeout

This setting determines the amount of time, in minutes, before the DataSplice Server disconnects clients that have been idle. Setting this to zero disables the timeout feature.
DB Timeout

This setting specifies how long, in minutes, a database connection must be idle before being closed by the DataSplice Server. This can be helpful to minimize the total number of database connections kept open by the DataSplice Server. Setting this to zero disables the timeout feature.
Single Processor Affinity

By default, the DataSplice Server will run on all available processors on an SMP machine. Selecting this option will cause the server to only use a single processor on multi-processor machines. For certain hardware configurations, running on multiple processors can cause issues under heavy loads.
Server Logging

The DataSplice Server creates log files in the Logs directory of the main DataSplice installation path. By default, this would be C:\Program Files\DataSplice\Logs. The slider controls how much detail is included in the logs.

Verbose logging will log ALL incoming and outgoing messages. This is often useful when attempting to diagnose a problem. Quiet logging only writes out critical information and errors. The default setting, in the middle, is usually sufficient for logging all essential messages.

Connection Profiles Tab

The DataSplice Server uses connection profiles to define the settings used to connect to external data sources. Each view specifies a particular connection profile to use.

Connection profiles allow settings for multiple views to be quickly changed, since the details only need to be modified for the connection profile once. This is particularly useful for moving from a test to a production setup, for example.

Connection Profiles Tab Screenshot

To add a connection profile:

  1. Click the Add button. A new profile will be added at the bottom of the list.
  2. Change the Profile Name to something meaningful for the particular application.
  3. Double click the Data Source field and select the desired ODBC DSN from the list. Please refer to the ODBC reference page for more information about managing ODBC Data Sources.
  4. In the User Name field, enter the account name needed to connect to the database.
  5. In the Password field, enter the password associated with the account name.
  6. Check the User DB Connection field if the server should pass the user credentials supplied by the remote client to the database instead of using the User Name for this connection profile. This is useful in setups that use an external authentication domain and would like to enforce existing database permissions through DataSplice.

System Attributes Tab

This defines attributes that will be available system-wide. These attributes are useful to define default behavior that can then be overridden on a user or group basis as needed.

System Attributes Tab

To set a system attribute:

  1. Select one of the system attributes from the Name dropdown list, or type a name to create a custom attribute.
  2. Enter the value to associate with the attribute in the Value field.
  3. Click the Update button Update Button or change focus from the pane.
  4. A dialog box will appear to confirm changes.

Example:

To create a system level attribute that defines the default SMTP email server:

  1. In the Name column, enter the name for the email server attribute, e.g. MAIL_SERVER.
  2. In the Value column, enter the name of the SMTP email server, e.g. mail.datasplice.com.
  3. Click the Update button Update Button .
  4. The value ${MAIL_SERVER} can now be used in email actions to reference this attribute. See the section about Events for more information.

For more details about using attributes, see the section describing Attributes.

Licenses Tab

This tab enables the administrator to enter a license key for the DataSplice server, as well as define license pools to partition the available licenses.

License Usage

DataSplice uses a concurrent licensing scheme. This means that whenever remote clients are being used they will consume a single license. This occurs when a user is connected to the DataSplice Server or has obtained an offline session and is no longer connected.

Note: Shutting the DataSplice Server down and restarting it does not release licenses acquired through offline sessions. The administrator can revoke the offline license using the Status tab, but in doing so, will prevent the offline client from being able to reconnect with that session and commit their changes. The only reason for revoking offline sessions is if the session has been orphaned and the administrator needs to free up the offline license.

Licenses Tab Screenshot

Server License If the license key is missing or expired, the Administration Client will have limited functionality available.

In the Server License field, enter the license key provided to you by DataSplice. It is recommended that you copy and paste the key value, rather than attempting to enter it manually, because of the likelihood of mistyped characters. Once a new license key is entered, be sure to click the Update button Update Button . You will be prompted to reconnect for the changes to take effect. Once you have reconnected, the product's functionality will be unlocked.
Licensed Clients

This is the allowed number of concurrent users, which is controlled by the license key. To purchase additional licenses, please contact Datasplice at datasplice@datasplice.com.

Note: While you are connected to the DataSplice Server in the Administration Client, you are consuming a license. In addition, remember that shutting down the DataSplice Server and restarting it does not release licenses acquired through offline sessions. The administrator can revoke the offline license manually, but in doing so, will prevent the offline client from being able to reconnect with that session and commit their changes. The only reason for revoking offline licenses (sessions) is if the session has been orphaned and the administrator needs to free up the license. Please see the Status section for more information about manually revoking sessions.
Shared Pool

The Shared Pool indicates the number of remaining licenses that have not been reserved for use by a particular group. Before drawing from the shared pool, licenses will be obtained from the individual license pool to which the user belongs. If no licenses are available there, then the system will draw licenses from the shared pool. Initially, all licenses belong to the shared pool until they are reserved.
Expiration Date

This field shows the date, if any, on which the DataSplice license key will expire. Permanent license keys do not expire, and will say NEVER in this field. Demo license keys expire within 60 days of initial use, and will display a specific expiration date in this field.
License Pools

This section is used by the administrator to create license pools for the purpose of reserving fixed numbers of licenses for use by a specific group. See the following section for more information about setting up license pools.

Add/Change Pool Dialog Box

To set up a license pool:

  1. Click the Add button. This will open the Add/Change Pool dialog box.
  2. Select the domain from the Domain drop-down box.
  3. Select the desired group to associate with this license pool from the Available Groups list. The Selected Group box will display the current group selection. Enter the number of licenses to reserve for this pool in the Reserved box.
  4. Click the OK button. The new pool will be added to the list of existing license pools, and the Shared Pool will be updated to indicate the remaining number of non-reserved licenses available.

If you wish to reserve licenses for users in multiple groups, create a new group and add the individual users, that you want reserved licenses for, to this new group. Then you can create a license pool for the new group with the desired number of licenses.

Note: It is possible to reserve more licenses than are available. This is indicated by a shared license pool number that is 0 or negative. If the shared license pool is zero or less, then you can either purchase more licenses and get a new license key or you can modify the number of licenses that are reserved for the license pools.

The Features box displays the enabled features for the DataSplice license key that was entered. There are currently three features: DEMO, PERMANENT, and OFFLINE.

Features

DEMO
Demo license keys are for temporary evaluation purposes. As such, they have an expiration date, not to exceed 60 days from initial use.
PERMANENT
Permanent license keys are designed to provide full functionality of the DataSplice software for an unlimited duration of time.
OFFLINE
This license key feature enables DataSplice to operate in offline mode in addition to the regular online functionality. This feature can be used in conjunction with both demo and permanent license keys.

Contents
 

Created by root
Last modified 2005-02-25 03:24 PM
 
Powered by Plone

This site conforms to the following standards: