Sharepoint Wakeup script

UPDATED RELEASE: 2.0 (Apr 11, 2008)

Wed, 16 Apr 2008 21:24:48 GMT

**As of version 2.0, I have migrated this project to http://www.codeplex.com/SPWakeUp/Wiki/View.aspx?title=Home Please check this new site for future versions. Also see my blog for future releases: http://akennel.blogspot.com **

This is a ground-up rewrite of the application, focused on making it easier to use while improving performance.
In this new version, the searchdepth.conf file is no longer needed. Additionally, the sites.conf file is now optional.

The app now recognizes 3 switches at run-time:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

-help Displays some help information about the application.

Examples:
spwakeup.exe
If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com
Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

UPDATED RELEASE: 2.0 (Apr 11, 2008)

Fri, 11 Apr 2008 18:11:49 GMT

This is a ground-up rewrite of the application, focused on making it easier to use while improving performance.
In this new version, the searchdepth.conf file is no longer needed. Additionally, the sites.conf file is now optional.

The app now recognizes 3 switches at run-time:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

-help Displays some help information about the application.

Examples:
spwakeup.exe
If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com
Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

UPDATED WIKI: Home

akennel — Fri, 11 Apr 2008 17:41:23 GMT

Resource Page Description
This is a simple application that touches each site and site collection on a Sharepoint server to rebuild the IIS cache.

Normally IIS discards its cache overnight, which means that each Sharepoint site must be rebuilt the first time it is accessed. This can be very slow. This script will seek out every site and site collection on a sharepoint server, going as deep as you like, and send them an HTTP request, so that the site remains in cache.

This project was inspired by the Warm Up script I found at: http://blogs.msdn.com/joelo/archive/2006/08/13/697044.aspx
For information about how the script was developed, please see my blog: http://akennel.blogspot.com/

The application consists of the program file, spwakeup.exe and an optional configuration file, sites.conf.
You must run this application on a machine that has WSS or MOSS installed. The script uses STSADM.exe, so you need to have it in your Path. STSADM.exe is usually found in: C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Bin.
If you want to wakeup a single site, you do not need sites.conf and it can be safely deleted. If you need to wake up mulitple sites, list them in sites.conf, each on their own line.

The app recognizes 3 option switches:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

Examples:
spwakeup.exe
If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com
Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

UPDATED RELEASE: 2.0 (Apr 11, 2008)

Fri, 11 Apr 2008 17:38:55 GMT

This is a ground-up rewrite of the application, focused on making it easier to use, while improving performance.
In this new version, the searchdepth.conf file is no longer needed. Additionally, the sites.conf file is now optional.

The app now recognizes 3 switches at run-time:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

Examples:
spwakeup.exe
If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com
Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

UPDATED WIKI: Home

akennel — Fri, 11 Apr 2008 17:38:23 GMT

Resource Page Description
This is a simple application that touches each sub-site and site collection on a Sharepoint server to rebuild the IIS cache.

Normally IIS discards its cache overnight, which means that each Sharepoint site must be rebuilt the first time it is accessed. This can be very slow. This script will seek out every site and site collection on a sharepoint server, going as deep as you like, and send them an HTTP request, so that the site remains in cache.

This project was inspired by the Warm Up script I found at: http://blogs.msdn.com/joelo/archive/2006/08/13/697044.aspx
For information about how the script was developed, please see my blog: http://akennel.blogspot.com/

The application consists of the program file, spwakeup.exe and an optional configuration file, sites.conf.
You must run this application on a machine that has WSS or Sharepoint Server installed. The script uses STSADM.exe, so you need to have it in your Path. STSADM.exe is usually found in: C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Bin.
If you want to wakeup a single site, you do not need sites.conf and it can be safely deleted. If you need to wake up mulitple sites, list them in sites.conf, each on their own line.

The app recognizes 3 option switches:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

Examples:
spwakeup.exe
If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com
Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

UPDATED WIKI: Home

akennel — Fri, 11 Apr 2008 17:36:27 GMT

Resource Page Description
This is a simple application that touches each sub-site and site collection on a Sharepoint server to rebuild the IIS cache.

Normally IIS discards its cache overnight, which means that each Sharepoint site must be rebuilt the first time it is accessed. This can be very slow. This script will seek out every site and site collection on a sharepoint server, going as deep as you like, and send them an HTTP request, so that the site remains in cache.

This project was inspired by the Warm Up script I found at: http://blogs.msdn.com/joelo/archive/2006/08/13/697044.aspx
For information about how the script was developed, please see my blog: http://akennel.blogspot.com/

The application consists of the program file, spwakeup.exe and an optional configuration file, sites.conf.
You must run this application on a machine that has WSS or Sharepoint Server installed. The script uses STSADM.exe, so you need to have it in your Path. STSADM.exe is usually found in: C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Bin.
If you want to wakeup a single site, you do not need sites.conf and it can be safely deleted. If you need to wake up mulitple sites, list them in sites.conf, each on their own line.

The app recognizes 3 switches at run-time:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

Examples:
spwakeup.exe If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

UPDATED WIKI: Home

akennel — Fri, 11 Apr 2008 17:30:37 GMT

Resource Page Description
This is a simple application that touches each sub-site and site collection on a Sharepoint server to rebuild the IIS cache.

Normally IIS discards its cache overnight, which means that each Sharepoint site must be rebuilt the first time it is accessed. This can be very slow. This script will seek out every site and site collection on a sharepoint server, going as deep as you like, and sends them an HTTP request, so that the site remains in cache.

This project was inspired by the Warm Up script I found at: http://blogs.msdn.com/joelo/archive/2006/08/13/697044.aspx
For information about how the script was developed, please see my blog: http://akennel.blogspot.com/

The application consists of the program file, spwakeup.exe and an optional configuration file, sites.conf.
If you want to wakeup a single site, you do not need sites.conf and it can be safely deleted. If you need to wake up mulitple sites, list them in sites.conf, each on their own line.

The app recognizes 3 switches at run-time:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

Examples:
spwakeup.exe If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

UPDATED WIKI: Home

akennel — Fri, 11 Apr 2008 17:21:52 GMT

UPDATED RELEASE: 2.0 (Apr 11, 2008)

Fri, 11 Apr 2008 17:20:08 GMT

This is a ground-up rewrite of the application, focused on making it easier to use, while improving performance.
In this new version, the searchdepth.conf file is no longer needed. Additionally, the sites.conf file is now optional.

The app now recognizes 3 switches at run-time:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

Examples:
spwakeup.exe If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

CREATED RELEASE: 2.0 (Apr 11, 2008)

Fri, 11 Apr 2008 17:19:31 GMT

This is a ground-up rewrite of the application, focused on making it easier to use, while improving performance.
In this new version, the searchdepth.conf file is no longer needed. Additionally, the sites.conf is now optional.

The app now recognizes 3 switches at run-time:
-depth:X --specifies how many levels deep to search for sites. If you do not set anything, the default value of 3 is used.
-site:XXX.XXX -- specifies the starting URL. If you do not set anything, the app looks for sites.conf, and uses the sites listed there. If sites.conf does not exist, the default URL http://localhost is used.
-log:Filename -- specifies a log file to record the results. If a file is not specified, the log will be displayed on the console.

Examples:
spwakeup.exe If the file sites.conf does not exist, runs against http://localhost. Uses search level of 3. Displays log results on console.

spwakeup.exe -depth:5 -log:c:\log.txt -site:http://portal.mycompany.com Runs against http://portal.mycompany.com. Uses a search level of 5. Stores results in c:\log.txt.

UPDATED RELEASE: 1.2 (Apr 08, 2008)

Wed, 09 Apr 2008 17:44:45 GMT

This release has a few improvements, most importantly, the script now checks for Site Collections in addition to Sub Sites.
I've also added some additional error handling in the case of missing configuration files.

Searching for Site Collections has added some overhead to the application; it now needs to check each URL twice, once for Sub Sites, then for Site Collections. As you can imagine this more or less doubles the run time. On my own server environment, this has gone from 6 minutes to about 13 minutes. That is with a search depth of 4.

Since the intention is for this script to run on a server at off-hours, this shouldn't be a problem, but I didn't want anyone to be surprised.

CREATED RELEASE: 1.2 (Apr 08, 2008)

Tue, 08 Apr 2008 18:35:22 GMT

This release has a few improvements, most importantly, the script now checks for Site Collections in addtion to Sub Sites.
I've also added some additional error handling in the case of missing configuration files.

Searching for Site Collections has added some overhead to the application; it now needs to check each URL twice, once for Sub Sites, then for Site Collections. As you can imagine this more or less doubles the run time. On my own server environment, this has gone from 6 minutes to about 13 minutes. That is with a search depth of 4.

Since the intention is for this script to run on a server at off-hours, this shouldn't be a problem, but I didn't want anyone to be surprised.

NEW POST: Wake up SSL Sites and provide a Username

akennel — Mon, 07 Apr 2008 21:50:33 GMT

Hi,
Thank you for trying out my script. Sorry to hear you are having trouble with it.
I've been unable to test with SSL sites because of company policy where I work. (They won't pay for signed certs, and policy forbids using self-signed certs) Ugh.
That said, I'm not sure why it would have a problem with an https address. Can you post the error messages you are seeing?

As for credentials, it uses the login information of the account it is running under. You should be able to set this via the Windows Schedule tool. I may add the ability to specify an account name and password to the next release, but no promises. I'm not a programmer, just an admin, so I only get to work on this project in my spare time.

CREATED RELEASE: 1.1.1 (Apr 07, 2008)

Mon, 07 Apr 2008 21:44:52 GMT

Very minor release. Added error catching when opening a site that is unreachable.

NEW POST: Wake up SSL Sites and provide a Username

juerg — Thu, 20 Mar 2008 19:04:18 GMT

Hi all

Is it possible to warm up https-sites and provide a username and password with spwakeup.exe?
I got some errors when i put my ssl sites in the sites.conf file.

regards,
juerg

UPDATED WIKI: Home

akennel — Mon, 10 Mar 2008 00:15:43 GMT

Resource Page Description
This is a simple application that touches each sub-site on a Sharepoint server to rebuild the IIS cache.

Normally IIS discards its cache overnight, which means that each Sharepoint site must be rebuilt the first time it is accessed. This can be very slow. This script will seek out every site on a sharepoint server, going as deep as you like, and sends them an HTTP request, so that the site remains in cache. This script only finds sub Sites, not Site Collections.

This project was inspired by the Warm Up script I found at: http://blogs.msdn.com/joelo/archive/2006/08/13/697044.aspx
For information about how the script was developed, please see my blog: http://akennel.blogspot.com/

Additional information from the Readme file:
File details:
You should have received 5 files in this Zip file:
SPWakeUp.exe -- The program file.
searchdepth.conf -- Configures how many levels deep spwakeup looks for sites.
sites.conf -- The top level sites you wish to wake up.
program.cs -- Source code for the application.
readme.txt -- The file you are reading now.

Requirements:
This application was written for MOSS 2007.
You need to have stsadm.exe in your system path.

Installation:
Just copy these files into a directory on your Sharepoint server. The 2 configuration files must be in the same folder as the program file. You can safely delete the readme.txt and program.cs files if they are not needed.
If you are running it as a scheduled task, be sure that the Start In property is set to the folder where you copied all three files.

Configuring:
Edit sites.conf with the name of your web site. You can add as many sites as you like. If the site runs on a port other than 80, please include that port in the URL. EG: http://sharepoint.mycompany.com:88

Edit searchdepth.conf to specify how many layers deep you want to search for sub sites. For example, in the following tree:
Home
|----Corporate----HR
|
|----Manufacturing----Widgets

Home would be level 1. Corporate and Manufacuting would be level 2. HR and Widgets would be level 3. So, if you wanted to wakeup Widgets, you'd need to set the searchdepth to 3. The more levels you search, the longer the wakeup script will take to run. By default, the level is set to 3.

UPDATED RELEASE: 1.1 (Mar 06, 2008)

Fri, 07 Mar 2008 21:20:23 GMT

Fixed a couple of major bugs in this release.
First and formost, the original version couldn't handle URLS with spaces. This is now fixed.
Also, the code I used to remove the XML tags from the end of the URL was faulty, and was mangling some addresses. I've fixed this as well.
The console now displays the contents of the web site as it is returned.

CREATED RELEASE: 1.1 (Mar 06, 2008)

Thu, 06 Mar 2008 19:54:52 GMT

UPDATED WIKI: Home

akennel — Wed, 05 Mar 2008 19:25:33 GMT

Resource Page Description
This is a simple application that touches each sub-site on a Sharepoint server to rebuild the IIS cache.

Normally IIS discards its cache overnight, which means that each Sharepoint site must be rebuilt the first time it is accessed. This can be very slow. This script will seek out every site on a sharepoint server, going as deep as you like, and sends them an HTTP request, so that the site remains in cache.

This project was inspired by the Warm Up script I found at: http://blogs.msdn.com/joelo/archive/2006/08/13/697044.aspx

Additional information from the Readme file:
File details:
You should have received 5 files in this Zip file:
SPWakeUp.exe -- The program file.
searchdepth.conf -- Configures how many levels deep spwakeup looks for sites.
sites.conf -- The top level sites you wish to wake up.
program.cs -- Source code for the application.
readme.txt -- The file you are reading now.

Requirements:
This application was written for MOSS 2007.
You need to have stsadm.exe in your system path.

Installation:
Just copy these files into a directory on your Sharepoint server. The 2 configuration files must be in the same folder as the program file. You can safely delete the readme.txt and program.cs files if they are not needed.
If you are running it as a scheduled task, be sure that the Start In property is set to the folder where you copied all three files.

Configuring:
Edit sites.conf with the name of your web site. You can add as many sites as you like. If the site runs on a port other than 80, please include that port in the URL. EG: http://sharepoint.mycompany.com:88

Edit searchdepth.conf to specify how many layers deep you want to search for sub sites. For example, in the following tree:
Home
|----Corporate----HR
|
|----Manufacturing----Widgets
|
|-Safety

Home would be level 1. Corporate and Manufacuting would be level 2. HR and Widgets would be level 3. Safety would be level 4.
So, if you wanted to wakeup Widgets, you'd need to set the searchdepth to 3. If you wanted to wakeup Safety, you'd need to set it to level 4.
The more levels you search, the longer the wakeup script will take to run. By default, the level is set to 3.

CREATED RELEASE: 1.0 (Mar 05, 2008)

Wed, 05 Mar 2008 19:07:20 GMT

This is the first release version.
I've tested this on my own servers. These are both MOSS Enterprise 2007 servers. One is a single server environment, the other is a 5 server farm.