VSS Source Control Project box does not appear in FrontPage (160766)

SYMPTOMS

When you attempt to use Visual SourceSafe 5.0 and FrontPage Explorer together, you may receive unexpected results. Specifically, FrontPage Explorer will not display a Source Control Project box in the Web Settings dialog box.

There are six forms of this problem:

Case 1: You are using Microsoft Personal Web server for your Web Server.

Case 2: You see the following errors in the error log:

   Microsoft FrontPage Server Extensions:
      (OS Error #-2147166146 Message:)
   Microsoft FrontPage Server Extensions:
   Error #90017 Message: Source Control System failure: File
   "srcsafe.ini" not found

The specific file name in this error message will vary.

Case 3: You see the following error in the error log:

   Microsoft FrontPage Server Extensions:
   Error #90017 Message: Source Control System failure: User
   <your_user_account> not found

Case 4: You see the following errors in the error log:

   Microsoft FrontPage Server Extensions:
     (OS Error #-2147467259 Message: Unspecified error)

   Microsoft FrontPage Server Extensions:
   Error #90017 Message: Source Control System failure: Could not find
   VSS resource DLL
				

Although the error messages may vary, they will always begin with "Source Control System Failure" or "Visual SourceSafe Failure."

Case 5: No error message (FrontPage 97 or Visual SourceSafe 5.0 beta)

Case 6: You see the following errors in the error log:

   Microsoft FrontPage Server Extensions:
      (OS Error #-2147166135 Message: )

   Microsoft FrontPage Server Extensions:
      Error #90017 Message: Source Control System failure:
      Invalid handle.

NOTE: All errors logged by FrontPage regarding SourceSafe integration are logged at the server end of the transaction. On a Windows NT system, the errors are logged in the "Windows NT Event Viewer Application" log. On a computer running Windows 95, the errors are logged in the Frontpg.log file located in the root of the drive to which Windows is installed. The errors are not logged to the client machine.

CAUSE/WORKAROUND

Case 1: Microsoft Personal Web Server

Cause:

If you are using Microsoft Personal Web server for you Web Server, you cannot use FrontPage and Visual SourceSafe together. Currently, this configuration is unsupported.

Case 2: "Source Control System failure: File 'srcsafe.ini' not found"

Cause:

You did not enable SourceSafe Integration when you installed SourceSafe.

The FrontPage user account or the Internet Guest account (on IIS only) does not have an account within the SourceSafe Administrator.

If your Visual SourceSafe and your SourceSafe data are stored on an NTFS drive, you may have not granted appropriate NTFS file system rights to the FrontPage user account, to the Internet Guest account (for IIS), or to the user account under which the web server operates.

The SourceSafe integration DLLs are either unregistered or are different versions.

NOTE: The server's error log will not report errors in this case.

The SourceSafe database is located on a different computer than the one running IIS, and the Internet Guest account (typically IUSR_<machine name>) does not have access permissions to the SourceSafe database.

For more information, click the following article number to view the article in the Microsoft Knowledge Base: Workaround

To resolve this problem, use the following steps:

1. Start the SourceSafe installation program.
2. Select add/remove components, and make sure the "Enable SourceSafe Integration" check box is selected. (If it is not selected, click the check box to select it).
3. Complete the installation.

SourceSafe Integration should now be enabled.

Case 3: Source Control System failure: User <your_user_account> not found

Start the Visual SourceSafe Administrator and make sure that your user account has read/write permissions and, for an IIS server only, the IUSR_<machine_name> (the Internet Guest) account has read permission within Visual SourceSafe Administrator. Make sure the passwords for these accounts are left blank.

Case 4: "Source Control System Failure", "Visual SourceSafe Failure" Errors

In order to properly integrate FrontPage and Visual SourceSafe, assign CHANGE permissions to all SourceSafe logon accounts for all files under the Visual Source Safe installation directory (including the SourceSafe data directory if it is in a different location).

Although tighter file restrictions may be possible, full SourceSafe functionality may be jeopardized by tighter restriction. The installation and check installation processes of FrontPage will only set permissions on Ssapi.dll and the SourceSafe resource DLL (Ssus.dll on US English). The installation process will not set permissions in other sections of the SourceSafe directory hierarchy. These permissions must be set manually.

NOTE: It is assumed that the Administrators and System accounts will be granted full control to the entire VSS directory hierarchy.

Grant read permissions to all SourceSafe logon accounts for the following additional files:

   srcsafe.ini
   um.dat
   users.txt
				

Grant read/write permissions to all SourceSafe logon accounts for the following additional files or directories:

   vss\users\<logon account directory>\ 
   vss\data\ 
   vss\temp\ 
   rights.dat
   status.dat
				

If restricting permissions to this level restricts SourceSafe functionality, assign change permissions to all SourceSafe logon accounts for all files under the Visual Source Safe installation directory.

For more information about required levels of NTFS permissions for Visual SourceSafe, see the Microsoft Visual Source Safe technical support Web site at:

NOTE: Because the Microsoft Web site is regularly updated, the site address may change without notice. If this occurs, link to the Microsoft home page at the following address: FrontPage will log errors to the error log if the Internet Guest Account (of IIS) does not have read permission to the following files

   srcsafe.ini
   um.dat
   users.txt
   vss\users\<Internet Guest Account directory>\ 
				

and has read/write permissions to

   vss\data\loggedin\ 
				

These errors will not affect the functionality of the integration. You can ignore them or grant the rights to the Internet Guest account to stop the errors.

Case 5: You Are Using FrontPage 97 or Visual SourceSafe 5.0 Beta

Resolution

To resolve this problem, use the following troubleshooting techniques:

• Uninstall the beta versions and upgrade to the released versions.
• Verify the following about the Fp20vss.dll and Fp20wel.dll files:
  
  
  • There is only one of each of these files on your system.
  • The Fp20wel.dll file is in %windir%\system and Fp20vss.dll is in the bin directory (the bin directory is located in the directory in which you installed of FrontPage).
  • Fp20vss.dll and Fp20wel.dll have the same version number. (If the files do not have the same version number, uninstall FrontPage, rename any remaining Fp20*.dll files, and then reinstall the released version of FrontPage.)
  • To see the version number of a .dll file in Windows, select the file and press ALT+ENTER. The version number will be displayed on the Version tab of the "<File name> Properties" dialog box.
• Your Ssapi.dll should be version 05.00.2218 or later. If you have an earlier version of this file, contact SourceSafe support for information about how to obtain the updated file:

  http://msdn.microsoft.com/vstudio/previous/ssafe/

Case 6: Source Control System failure: Invalid Handle Error

Cause:

The SourceSafe database is located on a different computer than the one running IIS, and the Internet Guest account (typically IUSR_<machine name>) does not have access permissions to the SourceSafe database.

For more information, click the following article number to view the article in the Microsoft Knowledge Base: