Advanced Options: SAS LASR Analytic Server

Introduction

This topic documents advanced options in the metadata definition for a SAS LASR Analytic Server. For information about the basic options, see Add a SAS LASR Analytic Server.
Note: For a non-distributed server, the only applicable advanced options are Server lifetime, Signature files location on server, and Enable logging.

Instructions

To view or set advanced options, use either of the following methods.

SAS Management Console

  1. In SAS Management Console, on the Plug-ins tab, expand Environment Managementthen selectServer Manager.
  2. Right-click a SAS LASR Analytic Server, and select Properties.
  3. In the Properties dialog box, select the Options tab.
  4. On the Options tab, click Advanced Options.

SAS Environment Manager

  1. In the SAS Environment Manager Administration window, click or tap the side menu icon, and select Servers from the side menu.
  2. Open a SAS LASR Analytic Server.
  3. From the server’s drop-down list of property pages, select the Options property page.
  4. Make changes as needed, and then click the Save icon.

Version Information

The options are for descriptive purposes only.

Memory Limits

The following options affect the circumstances in which a distributed SAS LASR Analytic Server rejects certain tasks:
Data loading (%)
specifies a percentage of used physical memory above which tables cannot be loaded to memory. If total memory use (by all processes on the cluster) exceeds the specified limit, operations that add tables or append rows fail. For example, if the value for this field is 80, and more than 80% of memory is already in use, tables cannot be loaded.
Note: Tables that are loaded from co-located HDFS or NFS-mounted MapR do not count toward this limit.
Tip
To limit available memory for tables on a particular server, see Limit Space for Tables.
External processes (%)
specifies a percentage of used physical memory above which external processes (such as SAS High-Performance Analytics procedures) cannot retrieve data. If total memory use (by all processes on the cluster) exceeds the specified limit, affected processes cannot retrieve data. For example, if the value for this field is80, and more than 80% of memory is already in use, affected processes cannot retrieve data.
Note: If you do not specify values, the default value (75) is used for both options.

Logging Options

The logging options are as follows:
Enable logging
Enables logging in a SAS LASR Analytic Server.
Path to log files
The path where the log file for a distributed server is placed.
Note: For a non-distributed server, log files are always written to the signature files directory.
Maximum file size (MB)
Specifies the size of the log file (in megabytes) before the log file is rolled over. The default is 100 MB.
Maximum rollover files
Specifies how many rotating log files can be used before older log files are overwritten. The default is 10.
Keep log files when the server terminates
Select Yes to leave log files in the file system when the server terminates. The default value is No, and the files are removed.
Additional logging parameters
This field is reserved for use in the future.

Additional Options

The Additional Options tab includes the following items:
Vendor
SAS
Associated Machine
Select the server’s host. If the host is not listed, click New to add it.
Force overwrite of server description file
This field is not used.
Signature files location on server
The host directory where signature files are written. The location is set during installation.
CAUTION:
It is important to protect the specified directory.
Note: Do not use a signature files path that contains double-byte character set (DBCS) characters.
Note: For a distributed server, the specified path must be located on the SAS High-Performance Analytics environment root node.
Server lifetime
By default, the server runs forever. This is appropriate in most environments.
To set a maximum run time, specify a value in seconds. For example, if you specify 3600, the server stops after it runs for 60 minutes.
For a distributed server, you can also set a time-out period so that the server stops after an interval of inactivity. The time-out is specified in parentheses after the first value. For example, if you specify the value as 3600(600), then after the server runs for 60 minutes, it starts tracking any inactivity. If no action requests are received within 10 minutes, the server stops.
Display detailed diagnostics
By default, detailed diagnostics are not displayed.
The connection object’s Advanced Options window includes this option:
Server description file
Leave this field blank. SAS Visual Analytics does not use this setting.
Last updated: December 18, 2018