Configuring SAS Federation Server Manager

Start the Configuration

SAS Federation Server Manager starts a configuration dialog box when you first login after installation. Use the following web address to start Federation Server Manager configuration again: http://host:port/fsmanager/web/config
For example: http://FedSvrManager:21077/fsmanager/web/config
CAUTION:
Before configuring SAS Federation Server Manager, the Federation Server service or daemon must be started.
  1. After launching the configuration URL, you are redirected to a login page. Log in to SAS Federation Server Manager using the administrator user and password that was set during installation.
    Tip
    If you do not remember what the admin credentials are, look in fsmanager.cfg located in the \etc directory of the installation path. The password is case-sensitive.
  2. After logging in, you are presented with an Initial Setup dialog box. Specify the Authentication Server host name and port number and click Save.
  3. At the third and final configuration dialog box, you can edit Authentication Server information, configure databases and edit the fetch size for data fetched between SAS Federation Server and the web application server.
  4. When you are finished with configuration, click Log Off in the upper right corner. You will be redirected to the main login page for SAS Federation Server Manager.

Update JVM

SAS Federation Server Manager uses Jetty, an opened source Java application web server. It is best practice to update the following JVM settings to suit your environment:
Note: When making changes to fsmanager.cfg it is best to work with a text editor that can handle the Unicode character set. Some plain text editors might convert characters which can corrupt the file.
-Xms (initial heap size)
-Xmx (max heap size)
-XX MaxPermSize
-Xss (stack size)
To update JVM settings for the Jetty Web Server:
  1. Open the fsmanager.cfg file located in SASHome\FSManager\version\etc.
  2. Use the java_args option to specify JVM settings. 
    # java_args = <arg1> [<arg2>...]
# Additional arguments for the Java executable used to run the web application.
#
# example: java_args = -Xss1024k -Xmx512m
  3. Save the fsmanager.cfg file.
  4. Run the Refresh Service Options script located in the FSManager directory of the installation root. The JVM settings that are specified in the fsmanager.cfg file will be applied to Jetty.

Federation Server Manager Service

Introduction

SAS Federation Server Manager runs as a Microsoft Windows service called Federation Server Manager. You can start and stop the service using the Microsoft Management Console (MMC) or through Administrative Tools in the Control Panel.
In UNIX, SAS Federation Server Manager runs as a daemon administered from a command line using fsmadmin to start and stop the daemon.

The Federation Server Manager Service in Windows

Start and stop the service using the MMC or the Control Panelthen selectAdministrative Tools.
  1. Click Startthen selectControl Panel.
  2. Double-click Administrative Toolsthen selectComputer Management.
  3. Expand the Services and Applications folder.
  4. Click Services.
  5. Click Federation Server Manager <instance>.
  6. Click either Stop the service or Restart the service.

Modifying the Windows Service Log On

When SAS Federation Server Manager is installed, the Federation Server Manager service is configured to start with the local system account. Because this account can have restrictions, such as accessing network drives, you should modify the service properties so the service log on uses an account with the necessary privileges to access the required network drives and files. For security reasons, you should assign administrative privileges only if necessary.
To modify the SAS Federation Server Manager log on:
  1. Select Control Panelthen selectAdministrative Tools.
  2. Double-click Services, and select the Federation Server Manager service.
  3. Click the Log On tab and select This account. Enter the account and password credentials for a user with administrative privileges.
  4. Restart the Federation Server Manager service.

The Federation Server Manager Daemon in UNIX

Start and stop the daemon using the fsmadmin application included in the installation. This application can be run using the command-line command:./bin/fsmadmincommand from the installation root directory, where command is one of the following options:
Command
Description
start
Starts the SAS Federation Server Manager daemon. For example: ./bin/fsmadmin start
stop
Stops the SAS Federation Server Manager daemon. For example: ./bin/fsmadmin stop
status
Checks the status of the SAS Federation Server Manager daemon.
help
Displays help information for the fsmadmin command.
version
Displays the version information for fsmadmin.
Copyright © SAS Institute Inc. All rights reserved.