Friday, April 29, 2011

Windows Web Admin - Application Settings

This is a quick settings guide to help you configure WWA to work with your environment.  Please refer to the IIS7 configuration instructions I posted yesterday first.  This guide is essentially a "part 2" for getting WWA up and running.

All of the application settings are found in the "_settings.asp" file in the main WWA folder.  Open it with Notepad or any text editor (not Microsoft Word!) and you can easily modify the settings and save it.  Changes are applied immediately upon saving the file.

Most of the settings are identified as standard variables but will have a "Const" statement in front of them, which indicate a non-changing value.  By that, I mean that once the variable is defined and assigned a value, it cannot be modified during the runtime of the application by any other pages within the site.  Ok, then.  On to the setting descriptions…

BASIC GLOBAL SETTINGS

siteActive = True / False

This puts the site into normal operational mode.  If you need to take the site offline or the SCCM database and don't want people using WWA for a period of time, set this to "False" and it will instead display a "come back later" page.  The default setting is True.

showGetStarted = True / False

This setting enables or disables the display of the 'Getting Started' links from the main home page.  To hide them, set this to False.  The default setting is True.

enableADtools = True / False

This setting enables or disables the Active Directory features of WWA.  If you set this to False, no Active Directory related links will be shown on the sidebar.  That will also hide the AD Quick Search section of the main home page as well.  The default setting is True.

enableCMtools = True / False

This setting enables or disables the System Center Configuration Manager 2007 features of WWA.  If you set this to False no links for SCCM features will be displayed on the sidebar or the main home page.  The default setting is True.

CONFIGURATION MANAGER SITE SETTINGS

SWBEM_Security = "EXPLICIT" or "IMPLICIT"

This setting controls how SWBEM provider connections are established with the SCCM host when performing modification operations (adding or removing Collection members, for example).  When set to "EXPLICIT", it will submit a specific USERNAME and PASSWORD combination with the connection request.  In order for this to be useful, you must also configure the SWBEM_USER and SWBEM_PASS variables.  If set to "IMPLICIT", it will attempt to establish the provider connection using the credentials of the IIS application pool.  The default setting is "EXPLICIT".

SWBEM_User  = "username"

This setting is used when SWBEM_SECURITY is set to "EXPLICIT" and defines the user account name to be submitted for SWBEM provider connections to the SCCM site server.

SWBEM_Pass = "password"

This setting is used along with SWBEM_USER when SWBEM_SECURITY is set to "EXPLICIT" and defines the user account password to be submitted for SWBEM provider connections to the SCCM site server.

SMSSiteCode = "AAA"

This is the three-character SCCM site code label to identify the scope of interfacing with SCCM.

SMSServer = "servername"

This is the name of the SCCM site server.

SMSDomain = "domain"

This is the Active Directory domain name in which the SCCM site server exists.  This is typically the NetBIOS name, not the FQDN value.

SCCM_WebReports = "http://[siteserver]/SMSReporting_" & SMSSiteCode

This is the URL to your SCCM Reporting Point host where links to Web Reports will be referred for certain features in WWA.  Include the URL up to, but not including the site code label, or replace the entire value to include the full URL to the base location (including the site code) if you prefer.

DATABASE CONNECTION SETTINGS

dbServerName = "servername"

This is the NetBIOS name of the SQL Server host for the SCCM site.

dbDatabase = "SMS_ABC"

This is the name of the SCCM site database on the SQL Server host.  This will usually be "SMS_" combined with your three-character site code.

dbUsername = "username"

This is the SQL or Active Directory user account name which has appropriate permissions within the SQL Server SCCM site database.

dbPassword = "password"

This is the corresponding password for the dbUSERNAME account defined above.

Note: Do NOT modify the "dsn = " code segment that appears below this.  It is concatenated from the other settings to generate the appropriate SQL connection string at runtime.

ACTIVE DIRECTORY SETTINGS

ldapRoot = "LDAP://DC=contoso,DC=local"

This is the base LDAP distinguished name value for the root of the domain in which you wish to manage with WWA.

ldapSchema = "LDAP://CN=Schema,CN=Configuration,DC=contoso,DC=local"

This is the default schema partition LDAP reference for the same domain identified by the ldapRoot setting above.

AD_DNSname = "contoso.local"

This is the DNS domain name label for the same domain identified by the ldapRoot setting above.

AD_Username = "username"

This is the name of an AD account which has appropriate permissions to view and modify Active Directory user accounts, contacts, and security groups in the target domain.

AD_Password = "password"

This is the corresponding password for the AD user account define above.

maxUserPwdAge = 90

This is the default password expiration allowance (in days).  The default setting is 90.  This is used to calculate days until a user account password expires.

MESSAGING SETTINGS

Note: This feature is not yet enabled but will be enabled in a future release.

enableMessaging = True / False

This option turns SMTP message handling features on or off.  The default setting is True.

useGmail = True / False

This option sets the default SMTP relay host to use Google Mail (Gmail).  The default setting is False.

mailServer = "server.fqdn.name"

This is the FQDN identifier for the SMTP relay host to route outgoing e-mail messages from WWA.  If you wish to use an internal SMTP host, enter the appropriate FQDN name for the server.  If you wish to use Google Mail, enter "smtp.gmail.com".

cdoSendUsingPickup = "local-folder-path"

This is an optional path setting to support adding attachments to outgoing e-mail from within WWA.  I'm not sure I'm ever going to make use of this.  I could, but I'm not sure why I would.  The default setting is "c:\inetpub\mailroot\pickup".

mailUser = "username"

This setting specifies the user account to use for connecting to the SMTP server for sending messages.  For most internal SMTP relay requests, this is left blank ("").  For Gmail however, you must specify a valid Google account name.  The default setting is "".

mailPwd = "password"

This is the corresponding password for the mailUser account defined above.  For most internal SMTP relay requests, this is left blank ("").  For Gmail however, you must specify a valid Google account password.  The default setting is "".

MISCELLANEOUS SETTINGS

timeBias = nnn

This is the default time zone offset value for use when calculating Active Direct and SCCM date/time values which are time-zone related.  The default setting is 300.

No comments: