Microsoft KB Archive/932128

From BetaArchive Wiki

Article ID: 932128

Article Last Modified on 8/15/2007



APPLIES TO

  • Microsoft SoftGrid for Terminal Services
  • Microsoft SoftGrid for Windows Desktops



Important This article contains information about how to modify the registry. Make sure that you back up the registry before you modify it. Make sure that you know how to restore the registry if a problem occurs. For more information about how to back up, restore, and modify the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows registry


SUMMARY

This article describes how to migrate a SoftGrid Server database from Microsoft SQL Server Desktop Engine (MSDE) to Microsoft SQL Server 2000.

MORE INFORMATION

The default database for the SoftGrid Server installation is MSDE. You can back up and restore the MSDE database to a computer that is running SQL Server 2000. To do this, follow these steps.

Note These steps assume that a computer that is running SQL Server is currently available.

Back up the MSDE database

  1. Start SQL Server Enterprise Manager.
  2. Connect to the MSDE database server. Use sa as the login name and use the password that was specified during the original installation of the SoftGrid server.
  3. Expand sql_server_name, and then expand Databases.
  4. Perform a complete backup of the SOFTRICITY database.

Document the SOFTRICITY database users and roles

  1. Start SQL Server Enterprise Manager.
  2. Connect to the MSDE database server. Use sa as the login name and use the password that was specified during the original installation of the SoftGrid server.
  3. Expand sql_server_name, expand Databases, expand SOFTRICITY, and then click Users.
  4. Document each user's name, login name, and database role memberships.

The following table includes some examples of user names, login names, and database role memberships.

Name Login Name Database Role Memberships
dbo sa public
db_owner domain_name\SoftGrid administrators groupdomain_name\SoftGrid administrators group public

SFTadmin

softricity softricity public

SFTadmin
SFTuser

A typical installation will have three users. To determine the database role membership, view the properties for each user.

Restore the MSDE database to the computer that is running SQL Server

  1. Start SQL Server Enterprise Manager.
  2. Connect to the computer that is running SQL Server.
  3. Expand sql_server_name, and then expand Databases.
  4. Create a new database that is named SOFTRICITY.
  5. Restore the previously backed up SOFTRICITY database to the newly created SOFTRICITY database.

Register Softricity database messages

  1. Log on to the computer that is running SQL Server.
  2. Click Start, click Run, type cmd.exe, and then click OK.
  3. At a command prompt, type osql.exe –S [server] –d [user database name] –U [login id] –P [password]. For example, type osql.exe –S SGSQL –d SOFTRICITY –U sa –P password.
  4. Type UPDATE db_messages, and then press ENTER.
  5. Type SET severity = severity, and then press ENTER.
  6. Type GO, and then press ENTER.
  7. Type quit, and then press ENTER.

Re-create the SQL Server users and assign the database role memberships

  1. Start SQL Server Enterprise Manager.
  2. Connect to the computer that is running SQL Server.
  3. Expand sql_server_name, expand Databases, expand SOFTRICITY, and then click Users.
  4. Delete the domain_name\SoftGrid administrators group user.
  5. Delete the softricity user.
  6. Add a new database user:
    1. Right-click Users, and then click New Database User.
    2. In the Login name box, click <new>.
    3. In the Name box, click Browse.
    4. Locate domain_name, click the user and the groups that were documented in step 4 of the "Document the SOFTRICITY database users and roles" section, click Add, and then click OK.
    5. In the Database box, click SOFTRICITY, and then click OK.
    6. In the The login 'domain_name\SoftGrid administrators group' has not been granted access to their default database: 'SOFTRICITY' and therefore will not be able to gain access to the default database. Continue message box, click Yes.
    7. In the Login name box, click login domain_name\SoftGrid administrators group.
    8. In the Database role membership box, click to select the Public check box and the SFTadmin check box, and then click OK.
  7. Add a new database user:
    1. Right-click Users, and then click New Database User.
    2. In the Login name box, click<new>.
    3. In the Name box, type Softricity.
    4. Under Authentication, click SQL Server Authentication.
    5. In the Password box, type the password that was specified during the original installation of the SoftGrid server.
    6. In the Database box, click SOFTRICITY, and then click OK.
    7. In the Confirm new password box, type the password that was specified during the original installation of the SoftGrid server, and then click OK.
    8. In the The login 'domain_name\SoftGrid administrators group' has not been granted access to their default database: 'SOFTRICITY' and therefore will not be able to gain access to the default database. Continue message box, click Yes.
    9. In the Login name box, click softricity.
    10. In the Database role membership box, click to select the following check boxes, and then click OK:
      • Public
      • SFTadmin
      • SFTuser
    11. In the Database role membership box, click to select each role that was documented in step 4 of the "Document the SOFTRICITY database users and roles" section, and then click OK.

Re-create the Softricity SQL Server Agent alerts and jobs

  1. Start SQL Server Enterprise Manager.
  2. Connect to the computer that is running SQL Server.
  3. Expand sql_server_name, expand Management, expand SQL Server Agent, and then click Jobs.
  4. Create a new job:
    1. Right-click Jobs, and then click New Job.
    2. In the Name box, type Softricity Database (SOFTRICITY): Check Usage History.
    3. In the Category box, click Database Maintenance.
    4. In the Owner box, click sa.
    5. In the Description box, type This job calls a stored procedure in the associated SoftGrid database to cleanup usage data on a monthly basis.
    6. Click the Steps tab.
    7. Click New.
    8. In the Step name box, type Check Usage History.
    9. In the Type box, click Transact-SQL Script (TSQL).
    10. In the Database box, click SOFTRICITY.
    11. In the Command box, type EXEC sp_SFTcheckusagehistory.
    12. Click the Advanced tab.
    13. In the On success action box, click Quit the job reporting success.
    14. In the Retry attempts box, type 4.
    15. In the Retry interval (minutes) box, type 1440.
    16. In the Run as user box, click dbo, and then click OK.
    17. Click the Schedules tab.
    18. Click New Schedule.
    19. In the Name box, type Monthly Schedule.
    20. In the Schedule Type box, click Recurring.
    21. Click Change.
    22. Under Occurs, click Monthly.
    23. Under Monthly, click Day.
    24. In the Day box, type 1.
    25. In the of every month(s) box, type 1.
    26. Under Daily frequency, click Occurs once at.
    27. In the Occurs once at box, type 2:00:00 AM.
    28. In the Start date box, click today's date.
    29. In the End date box, click No end date, and then click OK.
    30. Click OK two times.
  5. Create a new job:
    1. Right-click Jobs, and then click New Job.
    2. In the Name box, type Softricity Database (SOFTRICITY): Enforce Size Limit.
    3. In the Category box, click Database Maintenance.
    4. In the Owner box, click sa.
    5. In the Description box, type This job calls a stored procedure in the associated SoftGrid database to cleanup usage data. An alert triggered by an increase in the database data file(s) size calls this job.
    6. Click the Steps tab, and then click New.
    7. In the Step name box, type Enforce Size Limit.
    8. In the Type box, click Transact-SQL Script (TSQL).
    9. In the Database box, click SOFTRICITY.
    10. In the Command box, type EXEC sp_SFTenforcesizelimit.
    11. Click the Advanced tab.
    12. In the On success action box, click Quit the job reporting success.
    13. In the Run as user box, click dbo, and then click OK.
    14. Click the Schedules tab, and then click New Alert.
    15. In the Name box, type Softricity Database (SOFTRICITY): Size Limit Reached.
    16. In the Type box, click SQL Server performance condition alert.
    17. In the Object box, click SQLServer:Databases.
    18. In the Counter box, click Data File(s) Size (KB).
    19. In the Instance box, click SOFTRICITY.
    20. In the Alert if counter box, click rises above.
    21. In the Value box, type 849254.
    22. Click the Response tab.
    23. Click to clear the E-mail check box, click to clear the Net send check box, and then click OK.
    24. Click the Notifications tab.
    25. In the Write to Windows application event log box, click Whenever the job completes, and then click OK.
  6. Create a new job:
    1. Right-click Jobs, and then click New Job.
    2. In the Name box, type Softricity Database (SOFTRICITY): Monitor Alert/Job Status.
    3. In the Category box, click Database Maintenance.
    4. In the Owner box, click sa.
    5. In the Description box, type This job refreshes the alerts and other jobs associated with the SoftGrid database based on configuration data stored in the database. The job is run on a daily basis.
    6. Click the Steps tab, and then click New.
    7. In the Step name box, type Refresh Database Jobs.
    8. In the Type box, click Transact-SQL Script (TSQL).
    9. In the Database box, click SOFTRICITY.
    10. In the Command box, type EXEC sp_SFTrefreshjobs N'REFRESH', and then click OK.
    11. Click New.
    12. In the Step name box, type Refresh Database Alerts.
    13. In the Type box, click Transact-SQL Script (TSQL).
    14. In the Database box, click SOFTRICITY.
    15. In the Command box, type EXEC sp_SFTrefreshalerts N'REFRESH'.
    16. Click the Advanced tab.
    17. In the On success action box, click Quit the job reporting success, and then click OK.
    18. Click the Schedules tab, and then click New Schedule.
    19. In the Name box, type Daily Schedule.
    20. Under Schedule Type, click Recurring.
    21. Click Change.
    22. Under Occurs, click Daily.
    23. In the Every Day(s) box, type 1.
    24. Under Daily frequency, click Occurs once at.
    25. In the Occurs once at box, type 1:00:00 AM.
    26. In the Start date box, click today's date.
    27. In the Duration end date box, click No end date, and then click OK.
    28. Click OK two times.

Enable the SQL Server Agent service

  1. On the computer that is running SQL Server, click Administrative Tools, and then click Services.
  2. Right-click SQLSERVERAGENT, and then click Properties.
  3. In the Startup type box, click Automatic.
  4. Click Start, and then click OK.

Reconfigure the SoftGrid communication configuration files

Follow these steps on the SoftGrid Virtual Application Server component:

  1. On the SoftGrid Virtual Application Server component, locate the C:\Program Files\Softricity\SoftGrid Server\conf folder.
  2. Open the Server.conf file by using a text editor.
  3. Change the host name that is between the <location> tag and the </location> tag to the SQL Server host name.
  4. Save the change, and then exit the text editor.

Follow these steps on the SoftGrid Management Server component if it is installed:

  1. On the SoftGrid Management Server component, locate the C:\Program Files\Softricity\SoftGrid Server\conf folder.
  2. Open the Manager.conf file by using a text editor.
  3. Change the host name that is between the <location> tag and the </location> tag to the SQL Server host name.
  4. Save the change, and then exit the text editor.

Follow these steps on the SoftGrid Management Web Service component:

  1. On the SoftGrid Management Web Service component, locate the C:\Program Files\Softricity\SoftGrid Management Service folder.
  2. Right-click the SftMgmt.udl file, and then click Properties.
  3. Click the Connection tab.
  4. In the Select or enter a server name box, type the name of the computer that is running SQL Server, and then click OK.
  5. On the SoftGrid Management Web Service component, click Administrative Tools, and then click Data Sources (ODBC).
  6. Click the System DSN tab.
  7. Click SoftGridReporting System Data Source, and then click Configure.
  8. In the Server box, type the SQL Server host name.
  9. Click Finish.
  10. In the A new ODBC data source will be created with the following configuration box, click OK.
  11. Click OK.

Remove the MSSQLSERVER service dependency from the SoftGrid Virtual Application Server service

Warning Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require that you reinstall the operating system. Microsoft cannot guarantee that these problems can be solved. Modify the registry at your own risk.

  1. On the SoftGrid Virtual Application Server, click Start, click Run, type regedit, and then click OK.
  2. Expand HKEY_LOCAL_MACHINE, expand SYSTEM, expand CurrentControlSet, expand Services, and then click SoftGridServer.
  3. Right-click DependOnService, and then click Modify.
  4. Clear the line that contains MSSQLSERVER, and then click OK.
  5. Exit Registry Editor

Reset the SoftGrid Management Web Service

  1. On the SoftGrid Management Web Service server, click Administrative Tools, and then click Services.
  2. Stop and then start the World Wide Web Publishing Service.

Reconfigure database logging

  1. Start the SoftGrid Management Console, and then connect to the SoftGrid Management Web Service.
  2. Expand SoftGrid Systems, expand server_name, and then expand Server Groups.
  3. Click Default Server Group, and then click Properties.
  4. Click the Logging tab.
  5. Edit the existing SQL Database Type.
  6. Change the DNS Host Name to the SQL Server host name.
  7. Click OK two times.
  8. In the You must restart the SoftGrid Virtual Application Server services in this group for them to reflect the changes made box, click OK.
  9. Exit the SoftGrid Management Console.
  10. On the SoftGrid Virtual Application Server, click Administrative Tools, and then click Services.
  11. Stop and then start the SoftGrid Virtual Application Server service.

Repeat these steps for each database logging that is currently configured to log on to the MSDE database server and the SoftGrid server.

Reconfigure and reset the SoftGrid services

If the SQLSERVERAGENT service and the MSSQLSERVER service on the SoftGrid Virtual Application Server are being used for SoftGrid only, follow these steps:

  1. On the SoftGrid Virtual Application Server, click Administrative Tools, and then click Services.
  2. Right-click the SQLSERVERAGENT service, and then click Properties.
  3. In the Startup type box, click Manual.
  4. Click Stop, and then click OK.
  5. Right-click the MSSQLSERVER service, and then click Properties.
  6. In the Startup type box, click Manual.
  7. Click Stop, and then click OK.

Reboot the SoftGrid Virtual Application Server. On the SoftGrid Management Server, follow these steps.

Note If the SoftGrid Management Server is the same server as the SoftGrid Virtual Application Server that was previously rebooted, you can skip this step.

  1. On the SoftGrid Management Server, click Administrative Tools, and then click Services.
  2. Stop and then start the following services:
    • SNMP Brass Management Multiplexer Agent
    • SNMP EMANATE Master Agent
    • SoftGrid Management Server
    • SoftGrid SNMP Monitor


Keywords: kbexpertiseinter kbhowto KB932128