Using ITConfig to Create Metadata Configuration Files

To access definitions on a metadata server, you must first connect to the metadata server. For connections to the LDAP server, the Object Manager and SAS can use metadata configuration files that contain information about how to connect to the server.

To create the metadata configuration files

1. Select Create Metadata Config File from the main ITConfig window. The Create SAS Metadata Config File window appears.

2. Select LDAP Server and click Next. The Configure LDAP Server window appears.

3. For the configuration type, select Current user to create a user-specific configuration, or All users on this machine to create a configuration that is common to all users. Click Next. The LDAP Server Parameters window appears.

   

4. If metadata configuration files already exist on your machine, the information from those files will be included in this window. You can edit the existing configuration parameters.

   Enter the following system configuration information:

   LDAP Server Machine

   The fully-qualified name of the machine that the LDAP Server runs on.

   LDAP Server Port

   The port used by the LDAP Server machine for receiving requests. A typical value is 389.

   Base DN

   The distinguished name for the location in the LDAP hierarchy under which SAS directory entries are stored. The value for this field is the same as the value for the $SAS_CONTEXT$ parameter that was specified when the SAS containers were installed in the LDAP directory.

   Select Next. The LDAP User Parameters windows appears.

   

5. Enter the following information:

   LDAP User DN

   The distinguished name of a user who will be accessing the LDAP server. Because the parameter information is stored in the client machine's registry, specify the DN of the client machine's user.

   LDAP User Password

   The password required for the specified user to log onto the LDAP server.

6. If you selected All users of this machine for the configuration type, select one of the following:

   Use this login information for all users

   specifies that the server and login information are stored in a single system configuration file that is common to all users.
   Note: You must select this option if you plan to use your configuration file with the object spawner.

   Use this login information for the current user only

   specifies that the server information is stored in a system configuration file that is common to all users and that the login information is stored in a user configuration file that is specific to the current user.

   If you selected Current user for the configuration type, the server and login information are stored in a single system configuration file that is specific to the current user.

7. Select Next. ITConfig creates the configuration file(s) and the XML File Written dialog box appears.

8. To return to the main ITConfig screen, select OK.

Names and Locations for Configuration Files

Metadata configuration files are always stored with a default filename and path. The path is dependent on the version of Windows that you are using.

Default Paths for Windows NT:

Common system configuration file

\WINNT\Profiles\All Users\Application Data\SAS\
  MetadataServer\oms_serverinfo.xml

User-specific system configuration file

\WINNT\Profiles\username\Application Data\SAS\
  MetadataServer\oms_serverinfo.xml

User configuration file

\WINNT\Profiles\username\Application Data\SAS\
  MetadataServer\oms_userinfo.xml

Default Paths for Windows 2000, Windows XP, and Windows 2003 Server:

Common system configuration file

\Documents and Settings\All Users\Application Data\SAS\
  MetadataServer\oms_serverinfo.xml

User-specific system configuration file

\Documents and Settings\username\Application Data\SAS\
  MetadataServer\oms_serverinfo.xml

User configuration file

\Documents and Settings\username\Application Data\SAS\ MetadataServer\oms_userinfo.xml

Note: The location(s) and filename(s) are displayed in the Configure LDAP Server window and in the XML File Written dialog box.

Sample System Configuration File Format for an LDAP Server

Use a text editor to edit your metadata configuration files. The following XML code shows a sample system configuration file for a connection to an LDAP Server.

<?xml version="1.0" encoding="UTF-8" ?>
<Redirect>
   <LogicalServer Name="LDAP Server"
    ClassIdentifier="440196D4-90F0-11D0-9F41-00A024BB830C">
      <UsingComponents>
         <ServerComponent Name="LDAP Server" ProductName="LDAP">
            <SourceConnections>
               <TCPIPConnection Name="LDAP Server" Port="389"
                HostName="dtd.pc.sas.com" ApplicationProtocol="LDAP">
                  <Domain>
                     <AuthenticationDomain Name="domainName">
                        <Logins>
                           <Login Name="test" UserID="cn=Mister
                            LDAP,cn=Users,dc=dtd-dom,dc=sas,dc=com"
                            Password="{base64}cGFzc3dvcmQ=" />
                        </Logins>
                     </AuthenticationDomain>
                  </Domain>
               </TCPIPConnection>
            </SourceConnections>
            <Properties>
               <Property Name="basedn"
                DefaultValue="cn=SAS,cn=Applications,dc=dtd-dom,dc=sas,dc=com"
                PropertyName="BaseDN">
               </Property>
            </Properties>
         </ServerComponent>
      </UsingComponents>
   </LogicalServer>
</Redirect>

Sample User Configuration File Format for an LDAP server

Use a text editor to edit your metadata configuration files. The following XML code shows a sample user configuration file for a connection to an LDAP Server.

<?xml version="1.0" encoding="UTF-8" ?>
<AuthenticationDomain Name="domainName">
   <Logins>
     <Login Name="domainName\abc" UserID="domainName\abc1"
      Password="{base64}cGFzc3dvcmQ="/>
   </Logins>
</AuthenticationDomain>