Using ITConfig to Create Metadata Configuration Files

To access definitions on a metadata server, you must first connect to the metadata server. For IOM Bridge connections to the metadata server, the object manager, spawner, and SAS can use metadata configuration files that contain information about how to access the metadata server.

To create a metadata configuration file:

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

2. Select SAS Metadata Server and click Next. The Configure Metadata Server window appears.

3. Select IOM Bridge for the connection type. 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 Configure SAS Metadata Server 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 information:

   Machine Name

   specifies the fully qualified name of the machine on which the SAS Metadata Server runs.
   
   

   Port or Service

   specifies the port or service to connect to on the server. If you are using a port to connect to your SAS Metadata Server, select Port and enter the TCP/IP port number. A typical port value is 8561.

   If you are using a service name to connect to your SAS Metadata Server, select Service and enter the service name.

   Username

   specifies the user who will be accessing the SAS Metadata Server.
   
   

   Password

   specifies the password required for the specified user to log on to the SAS Metadata Server.
   
   

   Authentication Domain

   specifies the authentication domain associated with the credentials for the SAS Metadata Server.
   
   

5. If you specified Current user for the configuration type, select one of the following:

   Use this login information each time you connect

   writes the server and login information to a user-specific system configuration file.
   Note: You must select this option if you plan to use your configuration file with the object spawner.
   
   

   Prompt for login information each time you connect

   writes the server information to a user-specific system configuration file.
   
   

   If you specified All users on this machine for the configuration type, select one of the following:

   Use this login information for all users

   writes the server and login information to a common system configuration file.
   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

   writes the server information to a common system configuration file and writes the login information to a user-specific user configuration file.
   
   

   Prompt each user for login information when they connect

   writes only the server information to a common system configuration file.
   
   

6. Click Next. The application connects directly to the SAS Metadata Server, retrieves the list of available repositories, and displays the SAS Metadata Server Repository Selection window. Select the repository that will be used for the metadata configuration and click Next.

   The ITConfig application writes the data to the metadata configuration files. The XML File Written dialog box appears.

7. To return to the main ITConfig window, click 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 Server 2003:

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 locations and filenames are displayed in the Configure SAS Metadata Server window and in the XML File Written dialog box.

Sample System Configuration File Format for an IOM Bridge Connection

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

<?xml version="1.0" encoding="UTF-8" ?>
<Redirect>
   <LogicalServer Name="SAS Metadata Server"
       ClassIdentifier="2887E7D7-4780-11D4-879F-00C04F38F0DB">
      <UsingComponents>
         <ServerComponent Name="SAS Metadata Server"
             ClassIdentifier="2887E7D7-4780-11D4-879F-00C04F38F0DB" >
            <SourceConnections>
               <TCPIPConnection Name="SAS Metadata Server"
                   Port="8561"
                   HostName="server.us.alphaliteair.com"
                   ApplicationProtocol="Bridge"
                   CommunicationProtocol="TCP">
                  <Properties>
                     <Property Name="Repository"
                         DefaultValue="intserv"
                         PropertyName="Repository">
                     </Property>
                     <Property Name="Required Encryption Level"
                         DefaultValue="none"
                         PropertyName="Required Encryption Level">
                     </Property>
                  </Properties>
                  <Domain>
                     <AuthenticationDomain Name="domainName">
                        <Logins>
                           <Login Name="domainName\testuser"
                               UserID="domainName\testuser"
                               Password="{base64}cGFzc3dvcmQ="/>
                        </Logins>
                     </AuthenticationDomain>
                  </Domain>
               </TCPIPConnection>
            </SourceConnections>
         </ServerComponent>
      </UsingComponents>
   </LogicalServer>
</Redirect>

Sample User Configuration File Format for an IOM Bridge Connection

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

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