Table of Contents
 
  1. Determining your Server Structure
  2. Basic components needed to install NetCommunity On Premise
  3. Installing the software
  4. After installation is complete
  5. Network Considerations
    • Network Configuration Guide (Includes diagrams with DMZ Configurations)
  6. Additional Resources
 
 
=============================================
 
I. Determining your Server Structure
 
There are various server configurations that can be used to setup NetCommunity.
You can use physical servers, virtual servers or a combination of the two.
 
Blackaud recommends you have a:
 
  • NetCommunity Server
  • REWS server
  • The Raiser's Edge Application Server
  • SQL database server
 
...but there is nothing to stop you from using your own configuration. It is possible to use 1, 2 or 3 servers in a physical or virtual set or some combination of the two.
 
We are unable to provide exact steps for how to tailor the installation to you specific configuration.
 
Support can assist with errors that may arise during or after install that are specific to the NetCommunity software.
Issues that extend to the configuration of your database, user permissions or network configuration are out of the scope of support.
We are able to provide documentation and suggestions for common errors that may arise during the install but it will be up to your IT Admistrator to make sure you server/network configurations are correct.
 
If they are unable to do so you may need to enlist the help of a Blackbaud consultant.
 
This document will serve as an outline/guide and not an exact representation of your specific installation.
 
 
As an example I will list some common installation configuration we have seen:
 
***2 server installation***
 
NetCommunity Server
Blackbaud NetCommunity Website
Blackbaud NetCommunity Core Components
Blackbaud NetCommunity Plug-in Service
The Raiser's Edge Client installed from the Deploy folder of the The Raiser's Edge Application Server
RE7 Web Service
RE Plug-in
 
The Raiser's Edge Application server
The Raiser's Edge Application
NetCommunity Database
The Raiser's Edge Database
 
 
***3 server installation***
 
NetCommunity Server
Blackbaud NetCommunity Website
Blackbaud NetCommunity Core Components
Blackbaud NetCommunity Plug-in Service
 
REWS Sever
The Raiser's Edge Client installed from the Deploy folder of the The Raiser's Edge Application Server
RE7 Web Service
RE Plug-in
 
The Raiser's Edge Application Server
The Raiser's Edge Application
NetCommunity Database
The Raiser's Edge Database
 
  - OR -
 
NetCommunity Server
Blackbaud NetCommunity Website
Blackbaud NetCommunity Core Components
Blackbaud NetCommunity Plug-in Service
The Raiser's Edge Client installed from the Deploy folder of the The Raiser's Edge Application Server
RE7 Web Service
RE Plug-in
 
The Raiser's Edge Application Server
The Raiser's Edge Application
 
SQL Server
NetCommunity Database
The Raiser's Edge Database
 
 
***4 server Installation***
 
NetCommunity Server
Blackbaud NetCommunity Website
Blackbaud NetCommunity Core Components
Blackbaud NetCommunity Plug-in Service
 
REWS server
The Raiser's Edge Client installed from the Deploy folder of the The Raiser's Edge Application Server
RE7 Web Service
RE Plug-in
 
The Raiser's Edge Application Server
The Raiser's Edge Application
 
SQL database server
NetCommunity Database
The Raiser's Edge Database
 
 
II. Basic components needed to install NetCommunity On Premise
 
1. The Blackbaud installer
Download the latest version from www.Blackbaud.com
 
2. Master Encryption Key
  • If you are migrating your NetCommunity database, you will need this or you will have to reset it. Reseting the Master Encryption Key will reset all passwords in NetCommunity. This    includes the passwords for The Raiser’s Edge Webservice password (NetCommunity uses this to connect to the REWs),  Blackbaud Payment Services, Blackbaud Services (Email) and all users listed in NetCommunity.
   
  • If this is a new database installation, you will be required to create a Master Encryption Key for the database
  • *IMPORTANT: Store this key in a safe place as you will need it if you ever intend to move the database in the future without having to reset all passwords in the database.
 
 
3. An installation of The Raiser's Edge client on the server that is designated to be the REWS (Raisers Edge Webservice Server)
 
 
4. The username and passwords for the services under Administration > Sites & Settings > Web services
 
  1. The Raiser's Edge settings (This may show as a different name after a fresh install until you enter the RE7service URL, username, password and save.
http://URL-to-the-REWS/RE7Service/MasterService.asmx
  1. BBNC Services (eMail)
  2. Blackbaud Payment Service
 
5. Web.config files
    - If migrating to new servers you should make backups of you webconfig files.
    - There are a total of 4 Web.config files
 
Three On the NetCommunity Webserver:
Drive:\Blackbaud\bbappfx\vroot\Web.config
Drive:\Blackbaud\NetCommunity\Web.config
Drive:\Blackbaud\PluginSevice\Web.config
 
One On the REWs:
            Drive:\Program Files\Blackbaud\Raisers Edge WebService\Web.config
 
6. An Fully qualified domain configured with an SSL certificate on the REWS server
 
7. Ports 443 and 80 are bound in IIS
 
 
III. Installing the software
 
  1. First make your server/network meets the system requirements for updating NetCommunity by reviewing the section labeled "Raiser's Edge web service server" in the following document:  https://www.blackbaud.com/files/support/guides/bbnc/bbncreqs.pdf   before updating the REWS server and the plugin on the users workstations
 
  1. Use the following KB to ensure all of the correct server Roles are installed on both the NetCommunity Webserver and the REWS server:
Which Windows Server roles and services are necessary for Blackbaud NetCommunity?
https://kb.blackbaud.com/articles/Article/73683
 
  1. If migrating NetCommunity (webserver) from an existing server reference KB:
How do we migrate Blackbaud NetCommunity to a new server?
https://kb.blackbaud.com/articles/Article/57903
 
  1. If migrating the REWS from and existing server reference KB:
How to migrate The Raisers Edge Web Service (REWS) server to a new server
https://kb.blackbaud.com/articles/Article/69238
 
  1. Also here are some steps to be aware of when migrating the NetCommunity database to a new SQL Server
https://kb.blackbaud.com/articles/Article/42024
 
NOTE: If running a completely new installation
  1. The 3 Web.Config files on the NetCommunity webserver will generate appropriately based on the Server and database names you enter during the installation process
 
  1. Unless you plan to enter a new username/password combination in the NetCommunity configuration setup referenced in the next section below, you will need the username/password from the Web.config you backed up from the REWS server.
 
  1. When installing NetCommunity on new servers and not migrating the server settings (Completely new Install) you will need to install the software in the following order as NetCommunity is dependent upon The Raiser’s Edge and SQL databases being installed prior to the NetCommunity  installation.
 
  1. Make sure that you have setup The Raiser’s Edge/SQL server and that it is up and running.
  2. Setup the REWs Server
    1. Install a Raiser’s Edge client, on the server you have designated as you REWS server, from the deploy folder on The Raiser’s Edge/SQL server box.
    2. Run the NetCommunity BlackbaudIntaller and select to install: The Raiser’s Edge Plug-in and The Raiser’s Edge Web Service
      • Note if you have Education Edge, you will also select The Education Edge Plug-in
    3. Follow though the remaining prompts and enter the information as it pertains to your network to complete the  setup – In most cases you should be able to use the defaults
  3. Setup the NetCommunity Server
    1. Run the NetCommunity Blackbaud Installer on the server that you have designated to be your NetCommunity webserver.
    2. Select to install the following components; Blackbaud Core Components, NetCommunity Website, NetCommunity Plug-in Service.
    3. Follow though the remaining prompts and enter the information as it pertains to your network to complete the  setup – In most cases you should be able to use the defaults
If only upgrading an existing REWS installation
 
Reference the following article for steps including screenshots: How to upgrade the Raiser's Edge Web Service (REWS)
 
 
NOTE: You will find a link to the full NetCommunity Installation guide below in the Additional Resources section.
 
IV. After installation is complete
 
1. Access the configuration page on the NetCommunity Webserver after install and make sure you have entered you username and passwords for the corresponding services
 
From the NetCommunity webserver, go to:  //localhost/configuration.aspx
 
-OR-
 
URL.toYourNetCommunityWebserver.XXX/configuration.aspx
 
2. Verify/Enter the information for the REWS URL, username and Password.
3. Also enter the usernames and passwords for:
- BBNC Services (eMail)
- Blackbaud Payment Service
 
4. Log into The Raiser's Edge on the REWS and make you are not getting any database connection errors
- If you are getting connection errors you will need to contact hosting support.
 
5. If you are not getting any database connection errors, make sure you can access the plugin:
- Click the NetCommunity Plug-in on the navigation menu (typically on the left below Configuration).
- In the Options menu, open the Connection Settings option.
- The URL is listed in the Enter the URL for the Blackbaud NetCommunity Web Service field.
 
6. If you are getting plugin errors make sure that you have entered the correct plugin URL:
See KB: What URL is used in the Blackbaud NetCommunity PluginService connection and how to find it? https://kb.blackbaud.com/articles/Article/41158
 
Plugin URL Example: http://URL.toYourNetCommunityWebserver.XXX/PluginService/MasterService.asmx     
 
7. From the REWS server, open a browser and navigate to http://localhost/testconfig.aspx  to check for errors. 
- If there are errors, then contact NetCommunity support.
 
NOTE: You will find a link to the full NetCommunity Troubleshooting Guide below in the Additional Resources section.
 
V. Network Considerations
 
Please review the Configuration Guide for recommended network setup: https://www.blackbaud.com/files/support/guides/bbnc/config.pdf
See Configuration Overview page 6, 8 and 9 for diagrams of suggested network configurations for On Premise clients
 
NOTE:
1. The Deploy folder, on The Raiser's Edge Application server, should be accessible to the REWS server over the network.
2. Ports 443 and 80 should be open to Inbound and outbound traffic in your firewall
3. If having connection errors after install see KB - ERROR: System.Net.WebException: The operation has timed out - On testconfig page at the RE7 WS Query level
https://kb.blackbaud.com/articles/Article/64796
 
VI. Additional Resources
 
NetCommunity Installation Guide
https://www.blackbaud.com/files/support/guides/bbnc/bbinstal.pdf
 
Blackbaud NetCommunity Troubleshooting Guide
https://www.blackbaud.com/files/support/guides/bbnc/tsre.pdf
 
What is the difference between Blackbaud Web Services and Raiser's Edge Web Service for NetCommunity?
https://kb.blackbaud.com/articles/Article/107489

How to manually run database revisions in Blackbaud NetCommunity​
https://kb.blackbaud.com/articles/Article/42748 
 
=============================================
Back to Top
=============================================