Managing Profiles

About Profile Management

After the metadata servers that you need are defined, you must create and manage profiles to connect to the servers' definitions so that SAS Enterprise Guide can access them. Managing profiles includes these tasks:
  • creating new profiles
  • specifying the active SAS Workspace Server
  • modifying existing profiles
  • setting up automatic updating of profile information
To configure and manage repositories, select Filethen selectManage Profiles. The Connections dialog box opens.
Connections dialog box
The Connections dialog box contains a list of all the profiles that have been defined for SAS Enterprise Guide Explorer. The active profile is identified by the active profile icon ( active profile icon ).

Define a Profile

To connect to a metadata server, you must create a definition for the profile in the Connections dialog box. To define a profile, follow these steps:
  1. Select Profiles from the selection pane and click Add. The Create Profile dialog box opens.
    Create a Profile window
  2. Specify the name and description for the profile.
  3. Specify the machine and the port to which the profile connects. If the profile connects to a local machine, you only have to specify the port number. If you are using SAS Enterprise Guide in a Citrix environment, you must specify Remote and the ID of the Citrix server. You must specify Remote even if the server is on the same machine that you are currently using.
  4. Specify how users connect to the machine. If the machine is running Microsoft Windows, you can select the Use Integrated Windows Authentication check box to specify that the credentials that are used to log on to the Windows desktop are also used to connect to the machine. If you do not use Integrated Windows Authentication, you must specify a user ID and password under which connections are made. Select the Save login in profile check box to save the user ID and password and automatically use these values each time a connection is made.
    Note: If your administrator has set the SAS metadata password policy to disable saved credentials, then selecting the Save login in profile check box has no effect, and the selection is not saved in the profile.
    If you are configuring a Citrix environment, specify a valid ID and associated password for logging on to the Citrix server. This ID will be used only to establish an administrative connection with the server. Individual SAS Enterprise Guide users are prompted for their user IDs and passwords.
  5. If you selected the Use Integrated Windows Authenticationcheck box, you can specify options for authenticating connections to the server. Click Advanced to display the Advanced Settings dialog box, which contains these options:
    Security package
    specifies the security protocol that is used to authenticate logged-on users to the server. Here are possible values:
    Kerberos specifies that the server uses the Kerberos protocol to exchange authentication tokens with the client.
    NTLM specifies that the server uses the NTLM protocol to exchange authentication tokens with the client.
    Negotiate specifies that the server negotiates with the client to use one of the protocols that are listed in the Security Package field.
    Service principal name (SPN)
    specifies an SPN to be used in place of the generated SPN for the server. This field should normally be left blank, which specifies that the generated SPN is used. You can specify an SPN in cases such as these:
    • the server is not running as a local service
    • you are using a cluster of servers that need to be accessed using the same SPN
    Enter the SPN by using the format SAS/host:port. For example, SAS/d1234.mycorp.com:8561.
    Security package list
    specifies the security packages to use with the Negotiate protocol. The server tries to use the first package listed, and then uses the second package if the first is not supported.
  6. Leave the Authentication Domain field blank unless your organization has set up a specific authentication domain configuration. If the field is left blank, SAS Enterprise Guide automatically uses a value of DefaultAuth for the authentication domain. The authentication domain enables the machine to use resources without authentication prompts. When a user accesses a resource on the server, the authorization domain of the resource is compared to the value that is specified for the profile. If the authorization domains match, the user does not have to enter credentials to use the resource.
  7. Click Save to create the profile definition and return to the Connections dialog box.

Specify an Active Profile

You can specify one profile as the active profile. The active profile connects to the server that serves as the source for all resource definitions (such as servers and libraries).
To specify an active profile, select Profiles from the selection pane, select a profile from the list of defined profiles, and then click Set Active. The selected profile is identified by the active profile icon ( active profile icon ).

Modify a Profile

After a profile has been defined in the Connections dialog box, you can modify the properties of the profile. To modify a profile, follow these steps:
  1. Select Profiles from the selection pane, choose the profile that you want to change, and then click Modify. The Modify Profile dialog box opens.
    modify profile window
  2. Make any needed changes to the profile options, and then click Save to accept the changes and return to the Connections dialog box.

Delete a Profile

You can use the Connections dialog box to delete a profile. Select Profiles from the selection pane, choose the profile that you want to remove, and then click Delete.

Specify the Active Workspace Server

After you have specified the active profile, you must specify the default SAS Workspace Server that will be used to process SAS requests. You must use SAS Management Console to define SAS Workspace Servers on the machine to which the profile connects.
To specify the default server, follow these steps:
  1. Select Servers from the selection pane.
  2. Select Automatically add local SAS server to specify that a workspace server that runs on the local machine is added to the list of workspace servers on the remote machine.
  3. Use the menu to select a SAS Workspace Server from the list of servers that have been defined on the active profile's machine. Use SAS Management Console to define additional servers if needed.

Configure Profile Updates

Whenever you make changes to the profile configuration, such as changing the machine to which a profile connects or adding a new profile, you must provide the changed information to SAS Enterprise Guide users so that they can find the changed profiles. To avoid having to update SAS Enterprise Guide users manually, you can store the profile configuration information in a shared location and enable SAS Enterprise Guide to automatically apply configuration updates.
To set up automatic updating, follow these steps:
  1. In SAS Enterprise Guide Explorer, select Filethen selectManage Profiles.
  2. In the Connections dialog box, select Updates from the selection pane.
    updates section
  3. Select Update configuration automatically if you want SAS Enterprise Guide Explorer to receive updates to the configuration information. Usually, the information in SAS Enterprise Guide Explorer and the information in the configuration file are the same, but you might want to select this option for testing purposes.
    If you selected the Update configuration automatically check box, use the Location of update file field to specify a network location that all SAS Enterprise Guide users can access. When you activate automatic updating, SAS Enterprise Guide checks this location for automatic updates to the profile configuration information.
    Click Check for updates now to test whether SAS Enterprise Guide Explorer can locate the update information in the specified location.
  4. Click Close.
  5. Copy the SDSUpdate.xml file from the work directory that you specified when you first configured the profiles (see Create a Shared Profile Deployment ) to the network location that you specified in the Connections dialog box.
  6. Copy the SDSControl.xml file from the work directory to the network location that you specified in the Connections dialog box. If you change the location of the configuration update file, then you must copy the changed SDSControl file to all machines where SAS Enterprise Guide is installed.
  7. In SAS Enterprise Guide Explorer, select Toolsthen selectCustomize Enterprise Guide Options. This opens the Options window. Select the Administration options and click Modify in the Connections area. The Connections dialog box opens.
    options window
  8. Select Updates from the selection pane and specify the location of the configuration update file that you specified in the Connections dialog box from SAS Enterprise Guide Explorer. Select Update configuration automatically. Click OK to close the Connections dialog box.
  9. In the Options window, click Save to save the options to EGOptions.xml.
  10. Include the EGOptions.xml file in the SAS Enterprise Guide installation package to automatically apply the option to all machines where SAS Enterprise Guide is installed. If you already have SAS Enterprise Guide installed, you can distribute the EGOptions.xml file to the machines where SAS Enterprise Guide is installed in order to change the default SAS Enterprise Guide options.