Modifying SAS Logical Grid Server Definitions

The initial configuration of the logical grid servers is performed by the SAS Deployment Wizard. However, a SAS grid administrator might need to modify the existing grid metadata or add new grid metadata definitions.
A SAS administrator performs these steps to specify or modify the required and optional properties as metadata for the SAS Grid Server:
  1. In SAS Management Console, open the metadata repository that contains the metadata for the Logical Grid Server.
  2. In the navigation tree, select Server Manager.
  3. Expand the folders under Server Manager until you see the metadata objects for the SAS application server, such as SASApp, and its Logical Grid Server component.
  4. Expand the Logical Grid Server component so that you see the metadata object for the Grid Server.
  5. Right-click the metadata object for the Grid Server, and select Properties.
  6. In the Grid Server Properties window, click the Options tab.
    Grid Server Properties
    grid server properties, options tab
  7. The fields on the Options tab are:
    Provider
    the grid middleware provider. The current default value is Platform. This value is used to communicate with the grid control server.
    Grid Command
    the script, application, or service that Platform Suite for SAS uses to start server sessions on the grid nodes. Any SAS options that are included in this command are passed to the grid jobs. You can specify any additional SAS options in the SAS Options field.
    This value is the path to the sasgrid.cmd file (Windows) or sasgrid script file (UNIX). Because this same command is used to start the servers on all grid nodes, the path to the directory on each grid node must be the same. For example: C:\SAS\Grid\Lev1\SASApp\GridServer\sasgrid.
    SAS Options
    specifies the SAS options that are applied by default to jobs that are sent to the grid. Separate multiple options with a space. Any SAS options that are specified for a specific application mapping override this value.
    Required Resources
    specifies the name of the resources that are applied by default to jobs that are sent to the grid. Any resources that are specified for a specific application mapping are added to this value. The application server name is displayed in this field by default, but it can be removed if needed.
    Grid Options
    specifies the grid command options that are applied by default to jobs that are sent to the grid. Examples include the job priority, the job queue, or the user group that is associated with the job. Any grid options that are specified by a grid options set and mapped to a specific application override this value. Job options are specified as name/value pairs in this format. Multiple pairs are separated by semicolons:
    option-1=value-1;option-2="value-2 with spaces";
    ... option-n='value-n with spaces';
    Here is an example of additional options that specify that all jobs that use this logical grid server go to the priority queue in the project “payroll”:
    queue=priority; project='payroll'
    For a complete list of job options, see Supported Job Options.
    Grid Options Set Mappings
    lists the grid server’s mappings of grid options sets to applications for a specified user or group. Each grid option set associates a set of SAS options, required resources, and grid options to a SAS application and user identities that use the grid. To change or remove an entry, click on the entry and select Edit or Delete from the pop-up menu. Click New to create a new application mapping. See Working with Grid Options Sets for more information about grid options sets.
    Advanced Options
    enables you to specify the workload and module name. The workload specifies the optional resources that can be processed on the node. The module name specifies the shared library name or Java class name of the grid middleware provider's support plug-in.
  8. After you complete the field entries, click OK to save the changes and close the Grid Server Properties window.
  9. In the display area (right-hand side) on SAS Management Console, right-click the Connection object for the Grid Server, and then select Properties.
  10. In the Properties window for the Grid Server Connection, click the Options tab. Here are the fields on this tab:
    Authentication Domain
    the authentication domain that is used for connections to the server. Set this value to <none> for Platform LSF.
    Grid Server Address
    the host name or network address of the grid control server.
    Grid Server Port
    the port that is used to connect to the grid control server. This value should always be set to 0 (zero) for Platform LSF.
Copyright © SAS Institute Inc. All rights reserved.