Share via

Customizing SAConfig

  • Article

Server Appliance Kit

The SAConfig utility (saconfig.exe) sets the server's Internet Protocol (IP) address and changes the machine name and administrator password using a prefix provided by a call to the GetUniqueSuffix() function in the dynamic-link library (DLL) oemconfigdll.dll. You can replace the default oemconfigdll.dll with your own implementation; for more information, see OEM-Provided DLL and Function.

The SAConfig utility can be customized in either of two ways:

  • Through a saconfig.inf file located on a floppy disk in the server's A drive
  • Through the registry keys described in this topic

A sample saconfig.inf file is located on the Server Appliance Kit 3.0 CD in the \OemTools\SAConfig\inf folder.

The registry values used to configure SAConfig are located in HKLM\SOFTWARE\Microsoft\ServerAppliance\SAConfig:

HostnamePrefix

This value is used as a prefix while generating the host name. The WMI parameter that the system reads is appended to this prefix to form the initial host name. The total length of the host name should not exceed 15 characters, including the prefix.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\HostnamePrefix="hpr"

DefaultHostname

This value should be set to the factory preset host name and is used to determine if the host name has been changed from the factory default.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\DefaultHostname="myhostname"

AdminPasswordPrefix

This value is used as a prefix while generating the administrator password. The WMI parameter that the system reads is appended to this prefix to form the initial administrator password. The total length of the administrator password should not exceed 14 characters, including prefix and suffix.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\AdminPasswordPrefix="apr"

DefaultAdminPassword

This value should be set to the factory preset administrator password. SAConfig will only change the administrator password if it is still set to the factory preset value.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\DefaultAdminPassword="myadminpasswd"

OEMDllName

This value holds the name of the DLL to be used by SAConfig Set this if you are using a custom DLL that is not named oemconfigdll.dll.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\OEMDllName="oemconfigdll.dll"

OEMFunctionName

This value holds the function name exported by the DLL. Set this if you are using a custom DLL that exports a function that is not name GetUniqueSuffix().

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\OEMFunctionName="GetUniqueSuffix"

RunOnce

This value is not currently being used.

WMIClassName

This value determines which WMI class will be used in the suffix. The WMI class is expected to be under the root\cimv2 directory.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\WMIClassName="Win32_BIOS"

WMIPropertyName

This value determines which property of the WMI object will be used in the suffix. The WMI object property type is expected to be of type CIM_STRING. You can use wbemdump to find the WMI object property.

Code Example

HKLM\Software\Microsoft\ServerAppliance\SAConfig\WMIPropertyName="__NAMESPACE"