(We hope to release an automated installation process at some point in the future. Please report any issues with these instructions in the Discussions area. Thanks !).
  • Download the latest binaries from the Downloads area
  • Unzip the contents of the release to a new folder on your front-end SharePoint server (WSS 3.0 or MOSS 2007). If you have multiple front-ends you may wish to load balance the NNTP service. The Windows service will need to be installed on each front-end server.
  • Open a command prompt,, navigate to the newly created folder and run the command:

%SystemRoot%\Microsoft.NET\Framework\v2.0.50727\InstallUtil /i QinetiQ.Enterprise.Services.Nntp.exe
  • Open the Computer Management console and navigate to the Services list. The identity of the QinetiQ.Enterprise.Services.Nntp service should be set to the same user as the application pool user of your SharePoint content site (i.e. the web application where the discussion boards reside).
  • Edit the QinetiQ.Enterprise.SharePoint.Nntp.exe.config file. Note - Ensure the Config package has been downloaded from the downloads section. The following settings should be changed as required:

Setting Purpose
Port The listening port for incoming connections
Provider Always set to 'SharePoint'
SiteUrl Change this to the site collection containing the configuration list (more on this below)
WebUrl Site relative URL of the web containing the configuration list. Set to an empty string if the web resides at the root f the site collection.
ListName Name of the custom list used for configuration
CheckCacheIntervalSeconds Discussion board content is cached for n seconds
Domain Set this value to the domain name used in your organisation (e.g. qinetiq.com)
UserDomain Set this value to the user domain (e.g. contoso)
ArticleBodyCacheSize Number of full articles to cache (higher value = more memory consumption)
PendingConnectionsLength Connection queue length
UserPermCacheValidMinutes Amount of time in minutes to cache the user permissions
ArticlesCheckIntervalSeconds Amount of time in minutes between checking the article cache for each newsgroup
ArticleBodyCacheValidMinutes Time in minutes to cache the full article text (body)
AuthorFromDisplayFormatUsername 'True' or 'False'. When 'True', the author name format is username <username@domain.com>. When 'False', the display name of the SharePoint user is used as the author.
MaxPostLengthBytes Maximum allowed length of article post in bytes.
DebugSavePostFolder Set to a valid path to save article posts for debugging purposes
MonitorNewsgroupList Set to 'True' to monitor the custom list containing the newsgroup definitions for changes. When 'False' the news server will need to be restarted to pick up changes.
AdjustDaylightSavingOE Set to 'True' to offset article posting dates by 1 hour.

  • You may also need to alter the logging path in the configuration file.
  • Create the configuration list. This is a regular SharePoint custom list used to store the discussion board to NNTP group mappings. The list should be created in the same web application as the site collections containing the discussion boards. The list may reside in any site collection. Ensure the name of the list matches the value in the configuration file. Add the following columns:

Column Name Data Type Purpose
GroupName Single line of text Name of the group as it appears in the news client, e.g. qinetiq.communities.mathematics
SiteURL Single line of text Site collection URL were the discussion board resides, e.g. http://qinetiq
WebURL Single line of text Site relative URL of web site where discussion board resides, e.g. /communities/maths
ListName Single line of text Name of the discussion board, e.g. Discussion Board
RetentionPeriodDays Number Amount of time to present threads via the news server, e.g. 180
PostingAllowed Number Flag indicating whether posting is allowed or not (0 = False, -1 = True)
AuthorColumnName Single line of text The internal static name of the list column containing the author name, e.g. Author
ReadersCanPost Number Flag indicating whether a user with read-only SharePoint permissions can still post articles (0 = False, -1 = True)

  • Add one or more entries to the custom list & restart the QinetiQ.Enterprise.Services.Nntp Windows service.
  • Connect to the news server and attempt to post a new message. The message should appear in the SharePoint discussion board. If you reply to the message in the discussion board, it should appear in your news client shortly thereafter.

Last edited Sep 15, 2010 at 6:01 PM by ahayes, version 9

Comments

No comments yet.