Friday, August 24, 2007

K2 – Read the Troubleshooting instructions

After installing BlackPearl, when I opened the K2 Workspace, I was getting the following error;

Unable to generate a temporary class (result=1).
error CS2001: Source file 'C:\WINDOWS\TEMP\hq-r-kii.0.cs' could not be found
error CS2008: No inputs specified

Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code.

Exception Details: System.InvalidOperationException: Unable to generate a temporary class (result=1).
error CS2001: Source file 'C:\WINDOWS\TEMP\hq-r-kii.0.cs' could not be found
error CS2008: No inputs specified

After a little while, I found in the troubleshooting section of the installation guide, a note which said;

"To resolve this ensure that the following permissions are given to the users.

User Permissions

Give all "Authenticated Users" the following C:\Windows\Temp permissions: Read & Execute, List Folder Contents, Read, Write"

Once this was done, the workspace opened correctly.

Enabling the K2 Features from Central Administration

After installing BlackPearl when I clicked any of the 'Feature' links from the K2 Administration tab in Central Admin, I was getting the following error;

"The site http://<server>:<port>/ could not be found in the Web application SPWebApplication Name=SharePoint - <port> Parent=SPWebService."

I noticed that the reported site was my SSP Administration web application. Because I had this on a different port to MOSS, the only Site Collection is ssp/admin and there is no 'root' site collection. I tried deleting the SSP and web application, and the feature links then started working. I created a new SSP on a different port and it stopped working again. Then I tried adding a blank site collection at the root of the SSP Admin web application and they started working again.

I assume this means that there is an error when the BlackPearl link enumerates the site collections in all of the web applications and it expects there to be a site collection at the root of the web app.

So a work around is to create a blank site collection in the root of your SSP web application. (Or put your SSP in the same web application as your other sites)

K2Error.aspx missing from the admin folder

After installing and configuring BlackPearl RTM, I can get the server to start but when I go to MOSS Central Admin, if I click on any of the features, I get the following message;

Server Error in '/' Application.

--------------------------------------------------------------------------------

The resource cannot be found.

Description: HTTP 404. The resource you are looking for (or one of its dependencies) could have been removed, had its name changed, or is temporarily unavailable. Please review the following URL and make sure that it is spelled correctly.

Requested URL: /_admin/K2Error.aspx

After a while, I realised that this was because the K2Error.aspx file is not deployed to the 12 hive admin folder. I copied it from the template folder into the admin folder and then I could see the real error.

K2 BlackPearl is here

I'm happy to see the K2 BlackPearl has made it to RTM. I'm pretty excited about the new possibilities it introduces and I thought I would download it and install it in my virtual machine. I've come across a few gotchas during the install that you might want to consider if you are performing the installation. I will blog these as separate entries....