Using Windows Authentication for remote database access
Prerequisites
Before you begin, you must have access to the following:
For details regarding minimum hardware and software requirements, see System Requirements.
Overview
To configure a WhatsUp Gold installation to use Windows Authentication for remote Microsoft SQL Server database access:
- Add the domain user to the Local Administrator group on the machine that will host WhatsUp Gold.
- Add the domain user to the Local Administrator group on the machine that is hosting Microsoft SQL Server.
- Add the domain user (e.g. user1) to the Microsoft SQL Server database using the Login dialog.
- Assign the same permissions that are assigned to the Microsoft SQL Server 'sa' user to the Domain User (user1) in the Microsoft SQL Server database.
- Install WhatsUp Gold with a local Microsoft SQL Server 2005 Express Edition database.
- Run the Database Configuration utility and configure the WhatsUp Gold database connection to connect to the remote database using WIndows Authentication.
- Configure the ODBC driver to connect to the remote database using Windows Authentication.
- Configure IIS to use the Domain User for the NMConsole application pool and change the anonymous access user account to the Domain User for the WhatsUp Gold web site.
- Configure the Ipswitch Services Control Manager to use the Domain User to run the WhatsUp Gold processes.
Creating and adding the domain user to the WhatsUp Gold and Microsoft SQL Server host machines
To add the domain user to the Local Administrators group on the machine that will host WhatsUp Gold:
- Log in to Windows as a local administrator on the machine that will host WhatsUp Gold.
- Create the domain user, or otherwise determine which domain user (e.g. user1) you want WhatsUp Gold to connect to the remote Microsoft SQL Server database.
Use the following steps to create a domain user:
- Open Microsoft Management Console by clicking the Start button , typing mmc into the Search box, and then pressing ENTER. If you are prompted for an administrator password or confirmation, type the password or provide confirmation.
- In the left pane of Microsoft Management Console, click .
- Click the folder.
- Click , and then click.
- Type the appropriate information in the dialog box, and then click .
- When you are finished creating user accounts, click .
- Add the selected domain user (e.g. user1) to the Local Administrator group.
- In the left pane of Microsoft Management Console, click .
- Double-click the folder.
- Right-click the Local Administrator group, and then click .
- Click , and then type the name of the user account.
- Click , and then click .
- Restart the computer (optional, but recommended).
To add the domain user to the Local Administrators group on the machine that is hosting the Microsoft SQL Server database:
- Log in to Windows as a local administrator on the machine that is hosting the Microsoft SQL Server database.
: The MSSQL server must be on the same domain as the WhatsUp Gold server.
- Add the selected domain user (e.g. user1) to the Local Administrator group.
- In the left pane of Microsoft Management Console, click .
- Double-click the folder.
- Right-click the Local Administrator group, and then click .
- Click , and then type the name of the user account.
- Click , and then click .
- Restart the computer (optional, but recommended).
Adding the domain user as a Microsoft SQL Server database user
To create a SQL Server login that uses Windows Authentication (SQL Server Management Studio)
- Launch the SQL Server Management Studio.
- Add the domain user:
- In SQL Server Management Studio, open Object Explorer and expand the folder of the server instance in which to create the new login.
- Right-click the Security folder, select , and then click .
- On the General page, enter the domain user name (e.g. user1) in .
- Select .
- Click .
- Provide the domain user (e.g. user1) with the same permissions as the Microsoft SQL Server system administrator (sa) user. The following is a guideline that provides the most common settings for the 'sa' user.
- On the page, select the
sysadmin
role. - On the User Mapping page - Select the
db_owner
role membership for each database. If you do not wish the domain user to have access to a specific database, do not provide db_owner (dbo) role membership for that database. - On the Status page in the Settings menu:
- Save your changes and exit SQL Server Management Studio.
Installing WhatsUp Gold and configuring the connection to the remote database
To configure WhatsUp Gold and connect to the remote database:
- Log in to the machine that you using the domain user (e.g. user1) on the WhatsUp Gold server.
- Install WhatsUp Gold. Use all of the default settings, allowing the Microsoft SQL Server 2005 Express Edition database to install locally.
: Because of service dependencies, you must allow the local database to install and run. It is possible remove this dependency later.
- After the WhatsUp Gold installation completes, run , using Windows authentication, and point it at the remote database server. ()
- Locate the
RemoteDBConfig.exe
file in the default location: C:\Program Files (x86)\Ipswitch\WhatsUp
, or in the custom location where you installed WhatsUp Gold. - Double-click the
RemoteDBConfig.exe
file. The Database Connection dialog appears. - Check to make sure the Server Name is correct for the location of your local SQL server for WhatsUp Gold.
- Browse for the remote SQL server you want to use.
- In the Authentication section, select .
: You must be logged in as the domain user (e.g. user1).
- Click .
- Click to update the databases.
- Click to exit.
: If you see BCP errors, delete the WhatsUp and NetFlow databases on the remote SQL server and try running RemoteDBConfig.exe
again.
Set up the ODBC connection on the machine hosting WhatsUp Gold
- Set up the ODBC connection to use Windows Authentication and the remote SQL database server.
- On 32-bit systems, click , then double-click the 32bit ODBC icon.
- or -
On 64-bit systems, locate the C:\Windows\SysWOW64 folder, and double-click the ODBCAD32.exe icon. - Select the tab.
- Select .
- Click .
- Select the remote SQL server from the list.
- Click .
- Select .
- Continue clicking Next, accepting the current settings. Save the changes and exit.
- Repeat steps b through g for all other sources.
Configure WhatsUp Gold to use Windows Authentication
- Run
NmConfig.exe
to configure WhatsUp Gold to use Windows authentication:- Click > > > > .
- Select .
- Click .
- Ensure is selected.
- Click .
Configure IIS on the machine hosting WhatsUp Gold
For operating systems that use IIS6, you must add the domain user account to the IIS_WPG group and change the identity for the NmConsole application pool to the domain user, and configure the account used for anonymous authentication to the domain user (e.g. user1). For operating systems using IIS7, you only need to change the identity for the NmConsole application pool, and configure the account used for anonymous authentication. The following procedures provide information on performing these tasks.
To add the domain user account (e.g. user1) to the IIS_WPG group on IIS6
- On the desktop, right-click , and then click .
- In the Computer Management screen, under , expand , and then click .
- Right-click the group, and then click .
- In the dialog box, click .
- In the dialog box, in the box, type the account name on which you want your worker process to run (e.g. <Web domain>\user1), and then click .
- In the IIS_WPG Properties dialog box, click .
- Close the Computer Management screen.
To change the identity for the NmConsole application pool on IIS6
- To change the account under which an application pool runs using IIS Manager
- In IIS Manager, expand the local computer, expand , right-click the NmConsole application pool, and then click .
- Click the tab, and click . Configurable refers to registered user names.
- In the and boxes, type the user name and password of the domain account (e.g. user1).
- Click .
To change the identity for the NmConsole application pool on IIS7
- Open IIS Manager. ()
- In the Connections pane, expand the server node and click . The Application Pools list populates.
- On the Application Pools page, select the application pool, and then click in the Actions pane. The Advanced Settings dialog appears.
- Select the Identity property under the Process Model heading, and then click the browse button. The Application Pool Identity dialog appears.
- Select and click . The Set Credentials dialog appears.
- Type the domain account name in the User name box (e.g. user1)
- Type and confirm the password for the domain account (e.g. user1) in the Password text box
- Click . The Set Credentials dialog closes.
- Click . The Application Pool Identity dialog closes.
- Click . The Advanced Settings dialog closes.
- Exit the IIS Manager application.
To configure the account used for Anonymous authentication on IIS 6.0:
- In IIS Manager, expand the local computer, right-click the website, and then click . THe WhatsUpGold Properties dialog appears.
- Click the tab.
- In the Authentication and access control section, click . The Authentication Methods dialog appears.
- Select the check box.
- Type the valid Windows user account you want to use for Anonymous access, or click to locate it.
- Click . The Authentication Methods dialog closes.
- Click . THe WhatsUpGold Properties dialog closes.
- Exit the IIS Manager application.
To configure the account used for Anonymous authentication on IIS 7.0:
- Open IIS Manager ().
- Click the tab, double-click . The Authentication page appears.
- On the Authentication page, select .
- In the Actions pane, click . The Edit Anonymous Authentication Credentials dialog appears.
- Select Specific user, then click . The Set Credentials dialog appears.
- Type a user name and password for the identity.
- Click . The Set Credentials dialog closes.
: If you use the Network Service account, you grant anonymous users all the internal network access associated with that account.
- Click to close the Edit Anonymous Authentication Credentials dialog box.
- Exit the IIS Manager application.
Configure the Ipswitch Service Control Manager service to run under the domain user
To configure services on the WhatsUp Gold server:
- Log in to the WhatsUp Gold server as user1.
- Click and type
services.msc
. Press . The Services dialog appears. - Locate in the Name column and right-click it.
- Select from the list. The Properties dialog for the service appears.
- Click the tab.
- Select .
- Type or browse for user1. Enter and confirm the password for the user1 account.
- Click .