Server Connection

To connect to a data source with the DataFlux Federation Server, you must first connect to the DataFlux Federation Server. To connect to the DataFlux Federation Server, you must specify server connection arguments in the LIBNAME statement.

The DataFlux Federation Server process can be running on the local computer or on a remote computer. The SAS program connects as a client of the Federation Server. The data source connection arguments identify the computer on which the server is running, the port number which is used to access the server, and user authentication credentials.

The following is an example of the code necessary to connect to a DataFlux Federation Server and access a SAS data set.

libname lib1 fedsvr server="d1234.us.company.com"
   port=2171 user="myid" password=mypwd
   dsn="BaseDSN";

proc print data=lib3.table1;
run;

In the example, FEDSVR is the name of the LIBNAME engine and SERVER=, PORT=, USER= and PASSWORD= are server connection arguments.

DSN= is a data source connection argument. For more information, see Data Source Connection.

Access to the DataFlux Federation Server and its data services is controlled by the DataFlux Authentication Server. The users and groups who can access the server and its data services are defined and maintained on the Authentication Server by the DataFlux Federation Server administrator. To obtain a valid login for the DataFlux Federation Server, contact the DataFlux Federation Server administrator.

If the FEDSVR engine is invoked in a metadata-aware environment, then an AUTHDOMAIN= option can be used to supply user credentials instead of the USER= and PASSWORD= arguments. A metadata-aware environment is a SAS session in which the METASERVER=, METAPORT=, METAUSER=, METAPASS= and METAREPOSITORY= system options have been set and have successfully established a connection to a SAS Metadata Server. The AUTHDOMAIN= argument specifies the name of an authentication domain metadata object that is defined in a SAS Metadata Repository.

Specifying an authentication domain is a convenient way to obtain the metadata-based user credentials rather than having to explicitly supply them during server sign on. Metadata server connection system options can be specified in a configuration file as well as in the OPTIONS statement.

The AUTHDOMAIN= option does not bypass authentication by the DataFlux Authentication Server; it also routes authentication through the SAS Metadata Server. For more information about authentication domains, see the SAS Intelligence Platform: Security Administration Guide. For an example of how AUTHDOMAIN= is used, see Authenticate with an Authentication Domain.