Upload
others
View
8
Download
0
Embed Size (px)
Citation preview
Rincon® Plus 3.5.1 Multi‐Server Installation Behavioral Science Technology, Inc Software Support Department Phone: 805.646.4595 x414 Email: [email protected]
Revised 15.Oct.2010
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
2 | P a g e
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
3 | P a g e
Table of Contents DOMAIN SERVICE ACCOUNT CREATION AND CONFIGURATION ....................................................................... 5
Asp.Net Permissions Assignment................................................................................................................... 8
File System Permissions Assignment ............................................................................................................. 8
ENABLE CLR INTEGRATION ‐ SQL SERVER 2005 ............................................................................................... 10
ENABLE CLR INTEGRATION ‐ SQL SERVER 2008 ............................................................................................... 11
ENABLE TCP\IP ................................................................................................................................................. 12
RINCON VIRTUAL DIRECTORY INSTALLATION STEPS ....................................................................................... 13
Rincon Web.Config Update Utility ............................................................................................................... 15
Rincon Application Pool Configuration ........................................................................................................ 16
Additional Configuration IIS 7.0 ................................................................................................................... 17
RINCON DATABASE INSTALLATION AND CONFIGURATION............................................................................. 18
RINCON INSTALLATION WIZARD ‐ DATABASE ................................................................................................. 19
SQL Server Configuration for RinconService Account.............................................................................. 20
MANUAL INSTALLATION OF DEMO OR EMPTY DATABASE FILES .................................................................... 22
SQL Server Configuration for RinconService Account.............................................................................. 26
Register Rincon SQL Reporting Asembly in Database.............................................................................. 27
INSTALLATION OF MIGRATED BAPPTRACK DATA............................................................................................ 30
SQL Server Configuration for RinconService Account.............................................................................. 35
Register Rincon SQL Reporting Assembly in Database ............................................................................ 36
INSTALLATION OF MULTIPLE VIRTUAL DIRECTORIES ...................................................................................... 40
Create Virtual Directories IIS 6.0.............................................................................................................. 40
Activate the Virtual Directory ...................................................................................................................... 41
Create Virtual Directories IIS 7.0.............................................................................................................. 43
TROUBLESHOOTING......................................................................................................................................... 46
Rincon Web.config Update Utility ........................................................................................................... 47
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
4 | P a g e
WINDOWS DOMAIN INSTALLATION DISCLAIMER
The Multi‐server Rincon® installation, while recommended for optimal scalability, and reliability, requires advanced network administration knowledge, and should only be attempted by a qualified network IT administrator. The possible permutations of configuration and setup of a Windows domain network are too numerous to allow a comprehensive set of instructions, or provide a Setup application. It is very likely that some of the configuration choices of your network as specific to your business rules and requirements will require you to modify some of the steps in the attached guides. These set of instructions were prepared using a fresh clean base and patched install of Windows Servers with defaults selected during installation. You may need to modify certain steps, or perform extra steps in order to complete configuration on your network. One of the most common reported errors is permissions. Please make sure that your service accounts for SQL Server and IIS are properly configured for the required permissions / folder & file access. Please contact Microsoft for advice on your specific needs on your network if you are unsure on how to proceed with a particular instruction.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
5 | P a g e
DOMAIN SERVICE ACCOUNT CREATION AND CONFIGURATION
After logging on to the target domain’s Domain Controller as a Domain Administrator.
Active Directory (Start Control Panel Administrative Tools Active Directory Users and Computers)
Expand the Domain Node and right mouse click on the Users Node
Select New, then Select User
Create a new domain user named RinconService and click Next
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
6 | P a g e
Set the password according to your corporate policies, Uncheck the User must change password at next login, and check the Password never expires and click Next, then click Finish
Close out Active Directory Users and Computers
Open the Domain Security Policy (Start > Control Panel > Administrative Tools > Domain Security Policy)
Expand the Local Policies node
Select the User Rights Assignment node
In the right pane, right‐click on Log on as a service
Select Properties
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
7 | P a g e
If necessary, check the box to enable the policy and click the Add User or Group button
Type in DOMAINNAME\RinconService in the Add User or Group and click OK (substitute the correct name for DOMAINNAME)
Click OK in the Log on as a service Properties Dialog and close out Default Domain Security Settings
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
8 | P a g e
Asp.Net Permissions Assignment
After logging on to the IIS server as a Domain Administrator, open a command prompt (Start Run type CMD and click OK) type the following at the prompt:
CD %SystemRoot%\Microsoft.Net\Framework\v2.0.50727
At the new prompt, run the following command, substituting your domain name and the name of the RinconService account as applicable:
Aspnet_regiis –ga DOMAIN\RinconService
File System Permissions Assignment
File system permissions are required for two specific accounts. The first of these accounts is the IIS_WPG account installed with the native operating system; the second account is the RinconService account created on the Domain Controller. Appropriate permissions are required for the following directories:
%SystemRoot%\Help\iisHelp\Common %SystemRoot%\System32\inetsrv\ASP Compiled Templates %SystemRoot%\IIS Temporary Compressed %SystemRoot%\Temp The root folder for the Rincon website (default location C:\Program Files\BST\Rincon\Web)
For each of these folders, follow the following steps:
Right‐click on the folder and select Properties Select the Security tab Check for the existence of the IIS_WPG and RinconService accounts If the accounts are not present:
Click Add Click the Locations button and select the following locations for the accounts:
IIS_WPG = local machine name RinconService = domain name
Click Advanced Click Find Now Select the appropriate account (IIS_WPG or RinconService) Click OK
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
9 | P a g e
Select each account individually in the dialog box and set the following permissions: For the Help\iisHelp\Common folder Read and Execute, List Folder Contents, Read
For the System32\inetsrv\ASP Compiled Templates folder Full Control
For the IIS Temporary Compressed folder Full Control
For the IIS Temporary Compressed folder Full Control
For the Windows Temp root folder Read and Execute, List Folder Contents, Read
For the Rincon root folder Full Control
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
10 | P a g e
ENABLE CLR INTEGRATION ‐ SQL SERVER 2005
Start Programs Microsoft SQL Server 2005 Configuration Tools SQL Server Surface Area Configuration
Select Surface Area Configuration for Features
Select the Database Engine (MSSQLServer or SQLEXPRESS)
Expand the Database Engine node
Select CLR Integration
Verify the check box labeled Enable CLR integration is checked (check it if it’s not)
Click Apply
Click OK
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
11 | P a g e
ENABLE CLR INTEGRATION ‐ SQL SERVER 2008
Open SQL Server Management Studio to confirm CLR Integration has been activated.
Start Program Files Microsoft SQL Server 2008 R2 SQL Server Management Studio
Click Connect.
Right‐click the server instance and select Facets.
Under the Facet drop down box, select Server Configuration
Under Facet Properties set ClrIntegrationEnabled to True
Click Ok.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
12 | P a g e
ENABLE TCP\IP
(Note: if you need to use a protocol other then TCP please contact BST Technical support for guidance)
This step may require a restart of the SQL Server Services
SQL 2005/SQL 2008
Start Programs Microsoft SQL Server 2005/2008 Configuration Tools SQL Server Configuration Manager
Expand the node for SQL Server 2005/2008 Network Configuration
Click on Protocols for <instance name>… (MSSQLServer or SQLEXPRESS)
In the details pane, right‐click the TCP/IP protocol and then click Enable
In the console pane, click SQL Server 2005/2008 Services.
In the details pane, right‐click SQL Server (<instance name>), and then click Restart, to stop and restart the SQL Server service.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
13 | P a g e
RINCON VIRTUAL DIRECTORY INSTALLATION STEPS
The following steps will guide you through the installation of the first Rincon Virtual Directory on the IIS Server. This installation package can be run multiple times to install additional virtual directories, or users can follow the steps to manually create additional virtual directories in found on page 37 of this document. These steps assume that both IIS and .Net Framework 3.5 are already installed and configured. Contact BST Support for additional configuration guidance.
If the web sites are installed before the databases, you will need to edit the web.config file manually, or use the update web.config file after the database installation and configuration have been completed. Manual steps outlined on page 13.
Insert the Rincon Plus Installation Media to the server hosting IIS or download the installation package from BST Support.
Navigate to the License Agreement page of the Rincon Installation Suite and enter the Rincon Serial Number
Click Validate & Accept EULA, a green check mark will appear with a Valid Serial number, click Next to proceed
At the Destination Folder page, chose the folder you would like the Rincon Website to install. The default location is C:\Program Files\BST
Select the appropriate Setup Type: ‐ The steps outlined in this guide are for Web Site Only.
• Single Server Install: SQL Server and Rincon on the same server • Web Site Only: Install Web Component only, can be used for multiple web site install • New Database Only: use when IIS and SQL Server are installed on separate servers
Utilities Options: These utilities will install as part of the first installation setup
• Admin Utilities: Rincon Web.Config Utility • Upgrade Existing Rincon Sites: Rincon Upgrade
Select Web Site Only and click Next to proceed.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
14 | P a g e
Provide a name for the Rincon website on the Web Portal Name screen. This is the name you will use to access Rincon http://<severrname>/Rincon
Click Next.
On the Ready to Install the Program page click Install.
The installation wizard will install Microsoft Report Viewer Redistributable 2005. Select all of the defaults by clicking Next and Finish to proceed. This process may take a few minutes.
The installation wizard will install Microsoft ASP.NET 2.0 AJAX Extensions 1.0. Select all of the defaults by clicking Next and Finish to proceed. This process may take a few minutes.
The Rincon Installation Wizard will complete the installation.
Leave the box checked to Run web.config modify utility…. Or this utility can be launched at a later time by selecting Start Program Files BST Launch Update Web.Config
If prompted to install the Rincon Upgrade Utility, click Yes – This file will check for any updates if needed and will be available for future upgrades. This file can be accessed by contacting BST Support if you elect not to install it at this time. This application will not perform any automatic updates. All updates must be initiated by the user.
If installing multiple instances of Rincon, this installer can be run multiple times, or the additional virtual directories can be created manually. Please see page 37 for details.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
15 | P a g e
Rincon Web.Config Update Utility
This step must be completed after the databases have created on the SQL Sever to update properly.
The Rincon Setup Wizard will launch the Rincon Web.Config Update Utility. This utility will allow users to change some options within the Rincon Software. Only the first step is required in Rincon Basic.
On the SQL Connection tab, confirm the SQL Data Source and Database Name are correct.
In Rincon Plus Multi‐Sever installation the correct SQL DataSource is SQLServer\<instance> The SQL DataSource of (local) will return an error unless SQLServer is installed on the same server as IIS
Click Use Connection and Update.
Manually Update the Web.Config File
To manually update the web.config file, open the file from the root of the virtual directory with a
text editor or Visual Studio. Please see the Rincon Web.Config Specification guide for more
details on program options.
Update the data source (SQLServerInstanceName) and Initial Catalog (Rincon)on line 42
<add name="Rincon" providerName="System.Data.SqlClient" connectionString="data source=SQLServerInstanceName;Integrated Security=SSPI;Initial Catalog=Rincon;Persist Security Info=False;" /> </connectionStrings>
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
16 | P a g e
Rincon Application Pool Configuration
Open IIS Manager (Start Control Panel Administrative Tools Internet Information Services.)
If necessary, expand the top level IIS node,
To create the Rincon Application Pool, right click on the Application Pool node New Application Pool…
Right‐click the RinconAppPool and select Properties
Click the Identity tab, and then click the Configurable option.
Provide the RinconService account name using a NETBIOS format (e.g. Domain\RinconService,) and provide the appropriate password,
Click Apply
When prompted by the Confirm Password dialog box, type the password again and click OK. Click OK again to exit the dialog box.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
17 | P a g e
Additional Configuration IIS 7.0
Open the IIS Manager (Start Control Panel Administrative Tools)
In the IIS section double‐click the Handler Mappings icon
Click Add Managed Handler… under the Actions menu on the right enter the following:
Request path – Reserved.ReportViewerWebControl.axd
Type – Microsoft.Reporting.WebForms.HttpHandler
Name – ReportViewerWebControl‐axd
Click Ok
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
18 | P a g e
RINCON DATABASE INSTALLATION AND CONFIGURATION
The next three sections give you instructions on how to create a Rincon Database you can start using immediately with your Rincon Website.
Installation Options: • Rincon Installation Wizard program that will create a database using an automated
script – Page 17 • Add an empty or demo Rincon database manually – Page 20 • Directly restore migrated BAPPTrack® data provided to you by BST – Page 28
BST generally recommends testing the install with an empty or demo database prior to scheduling the Rincon migration. Please see the Rincon Migration Guide for guidance on scheduling your BAPPTrack to Rincon migration.
You may also decide to do some combination of these steps, please consult with BST personnel if you require assistance determining how to proceed.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
19 | P a g e
RINCON INSTALLATION WIZARD ‐ DATABASE
This section will detail how to use the Rincon Installation Wizard to create an empty Rincon database on your SQL Server. This installation will attach the Rincon database at a specified location and add the Rincon SQL Reporting .dll file to C:\Program Files\BST\RinconData
Launch the Rincon Installation Wizard and enter and validate serial number when prompted.
At the Setup Type window, select New Database Only. This will launch the database installation wizard.
At the Database Folder screen choose a location to attach the Rincon Database. The default location is C:\ProgramData\RinconData.
BST recommends changing the database path to the default location for SQL databases on your server (C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data) Installing the file at this location will ensure that the user account installing Rincon will have full access for installation and restoring of migrated data.
Database Server ‐ This step will install an empty Rincon database. From the dropdown box select (local) or the appropriate server name.
Select Windows Authentication…
At the Name of database catalog: provide the desired name of the Rincon database. The default file will be named Rincon.mdf and Rincon_log.ldf.
Click Next
A success message will appear when the installation is complete.
Use SQL Server Management Studio to create additional databases if required.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
20 | P a g e
SQL Server Configuration for RinconService Account
Open SQL Server Management Studio to confirm user accounts have been added. These steps should be completed by under the account that performed the installation.
Start Program Files Microsoft SQL Server 2008 R2 SQL Server Management Studio
When prompted click Connect.
Expand the Security and Logins nodes
Confirm the following accounts have been added:
IIS and SQL on separate Servers: Domain\RinconService
IIS and SQL on same server: NT Authority\Network Services
If the account does not exist, Right Click on Logins and select New Login …
At the Login Name text box click Search…
Type "RinconService" and click Check Names
Click Ok at both prompts and exit SQL Server Management Studio.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
21 | P a g e
Right click on the login and select Properties for the RinconService account The following Properties window will appear:
a. Click on ‘User Mapping’ in the top left column b. Check the checkbox next to the ‘Rincon’ database in the ‘Users mapped to this
login’ grid c. Check the checkbox next to ‘db_owner’ in the ‘Database role membership for:’
grid d. Click the ‘OK’ button to close the dialog box e. Repeat steps for all Rincon databases
CONNECTING TO RINCON
From the server where Rincon is installed: http://localhost/Rincon
From a remote workstation: http://ServerName/Rincon
a
C
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
22 | P a g e
MANUAL INSTALLATION OF DEMO OR EMPTY DATABASE FILES
While BST recommends for easiest setup you use the Rincon Database setup program, we recognize that this may not be allowed by your particular corporate policies; In that event you will need to complete the follow steps. For these instructions we are installing the Demo database (Demo.mdf and Demo.ldf). If you wish to install the Empty Database, follow the same steps and use the appropriate files (Empty.mdf and Empty.ldf).
Confirm the name of the Account that the SQL Server (MSSQLSERVER) service is running under in Services Start Control Panel Administrative Tools Services
Locate the Demo.mdf and Demo.ldf files in the \RinconSetup3.5.1\program files\BST\Utilities folder on the installation media. You will also want to copy ReportingSqlGeneration.dll file and the AttachReportingToDatabase.sql file – you will need both of these files to register the reporting services.
Copy the files Demo.mdf and Demo.ldf database files to …\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data on the local hard drive of the Machine that is hosting SQL Server.
Copy ReportingSqlGeneration.dll file and the AttachReportingToDatabase.sql file to a location on your hard drive – we suggest C:\Program Files\BST\Rincon
For each of the files, Demo.mdf and Demo.ldf, perform the following steps:
Right mouse click on the file, click on Properties
select the Security Tab.
Click the Add… button
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
23 | P a g e
In the Select Users or Groups dialog, set the location to the appropriate area, then type in the name of the service you created in section 1, click Check Names and OK
In the demo.mdf Properties Dialog, select the user you just added, and then click the Full Control – Allow checkbox and click OK
Start SQL management Studio Start All Programs Microsoft SQL Server 2005 SQL Server Management Studio.
Connect to the SQL Server
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
24 | P a g e
If necessary expand the root SQL Server Node
Expand the Databases Node
Right mouse click on the Databases Node and select Attach…
In the Attach Databases Dialog, click the Add… button
In the Locate Database Files dialog, select the Demo.mdf file and click OK
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
25 | P a g e
Change the Attach As value to an appropriate name, and confirm that the paths listed in the MDF File Location in the top grid and in the mdf and ldf locations in the bottom grid are correct, then click OK
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
26 | P a g e
SQL Server Configuration for RinconService Account
Right click on the login and select Properties for the RinconService account
The following Properties window will appear:
a. Click on ‘User Mapping’ in the top left column
b. Check the checkbox next to the ‘Rincon’ database in the ‘Users mapped to this login’ grid
c. Check the checkbox next to ‘db_owner’ in the ‘Database role membership for:’ grid
d. Click the ‘OK’ button to close the dialog box e. Repeat steps for all Rincon databases
a
c
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
27 | P a g e
Register Rincon SQL Reporting Asembly in Database
Locate the ReportingSqlGeneration.dll file in the \\...\program files\BST\Utilities\Database folder on the installation media. Also copy the AttachReportingToDatabase.sql script – this can be used to register the .dll file.
Copy the file to C:\Program Files\BST
Start SQL management Studio Start All Programs Microsoft SQL Server 2005/2008 SQL Server Management Studio.
Connect to the SQL Server
If necessary expand the root SQL Server Node
Expand the Databases Node
Click on the AttachReportingToDatabase.sql file that was copied in the previous step or right mouse click on the Rincon Database Node and select New Query
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
28 | P a g e
The following text will appear if you open the AttachReportingToDatabase.sql file or, this text can be copied below and pasted into the Query Analyzer window. Two edits will need to be made:
Use [Rincon] ‐ make sure the database name is correct The file location: 'C:\Program Files\BST\ReportingSqlGeneration.dll'
Click Execute to register the .dll file USE [Master] GO /***** Enable: CLR *****/ EXEC sp_configure 'clr enabled', 1 GO USE [Master] GO RECONFIGURE GO USE [Rincon] GO /****** Object: StoredProcedure [dbo].[GetReportDataset] Script Date: 03/07/2007 11:48:18 ******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetReportDataset]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[GetReportDataset] GO /****** Object: SqlAssembly [ReportingSqlGeneration] Script Date: 03/07/2007 11:49:00 ******/ IF EXISTS (SELECT * FROM sys.assemblies asms WHERE asms.name = N'ReportingSqlGeneration') DROP ASSEMBLY [ReportingSqlGeneration] GO CREATE ASSEMBLY ReportingSqlGeneration from 'C:\Program Files\BST\ReportingSqlGeneration.dll' WITH PERMISSION_SET = SAFE GO CREATE PROCEDURE [dbo].[GetReportDataset] @reportUid [uniqueidentifier], @startDate [datetime], @endDate [datetime] WITH EXECUTE AS CALLER AS
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
29 | P a g e
EXTERNAL NAME [ReportingSqlGeneration].[Bst.Rincon.BL.ReportingInformation.SqlGeneration.StoredProcedures].[GetReportDataset]
CONNECTING TO RINCON
From the server where Rincon is installed: http://localhost/Rincon
From a remote workstation: http://ServerName/Rincon
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
30 | P a g e
INSTALLATION OF MIGRATED BAPPTRACK DATA
BST will supply a backup of your BAPPTrack migrated data where applicable. In these instruction that file is referred to as “Rincon.bak”, and is installed as a Database called Rincon, please modify as appropriate for your file name.
Confirm the name of the Account that the SQL Server (MSSQLSERVER) service is running under in Services Start Control Panel Administrative Tools Services
Copy the Rincon.bak file to C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Backup on the local hard drive of the Machine that is hosting SQL Server.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
31 | P a g e
In the Select Users or Groups dialog, set the location to the appropriate area, then type in the name of the service you created in section 1, click Check Names and OK
In the demo.mdf Properties Dialog, select the user you just added, and then click the Full Control – Allow checkbox and click OK
Start SQL management Studio Start All Programs Microsoft SQL Server 2005 SQL Server Management Studio.
Connect to the SQL Server
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
32 | P a g e
If necessary expand the root SQL Server Node
Expand the Databases Node
Right mouse click on the Databases Node and select Restore Database…
In the Restore Database Dialog, in the To database: entry type in “Rincon", and select the From device: option and click the Ellipsis (…) button
Click Add in the Specify Backup dialog
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
33 | P a g e
In the Locate Backup File dialog, navigate to the file location in Step 1 where you copied the Rincon.bak and click OK
Then click OK in the Specify Backup Dialog
Check the checkbox in the Restore column in the Select the backup sets to restore list
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
34 | P a g e
Click the Options Node in the left hand column, and in the Restore As column, make sure that the Rincon.mdf and the Rincon_1.ldf are being created in a folder that the account you confirmed in Step 1 has read/write permissions to.
If you are using the default Network Service account, you may create the files in C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data
Click OK
Click OK in the Success dialog
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
35 | P a g e
SQL Server Configuration for RinconService Account
Right click on the login and select Properties for the RinconService account
The following Properties window will appear:
f. Click on ‘User Mapping’ in the top left column
g. Check the checkbox next to the ‘Rincon’ database in the ‘Users mapped to this login’ grid
h. Check the checkbox next to ‘db_owner’ in the ‘Database role membership for:’ grid
i. Click the ‘OK’ button to close the dialog box j. Repeat steps for all Rincon databases
a
c
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
36 | P a g e
Register Rincon SQL Reporting Assembly in Database
Locate the ReportingSqlGeneration.dll file in the \\...\RinconSetup\program files\BST\Utilities\Database folder on the installation media. Also copy the AttachReportingToDatabase.sql script – this can be used to register the .dll file.
Copy the file to C:\Program Files\BST or another location on the SQL Server
Start SQL management Studio Start All Programs Microsoft SQL Server 2005/2008 SQL Server Management Studio.
Connect to the SQL Server
If necessary expand the root SQL Server Node
Expand the Databases Node
Click on the AttachReportingToDatabase.sql file that was copied in the previous step or right mouse click on the Rincon Database Node and select New Query
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
37 | P a g e
The following text will appear if you open the AttachReportingToDatabase.sql file or, this text can be copied below and pasted into the Query Analyzer window. Click Execute to Two edits will need to be made:
Use [Rincon] ‐ make sure the database name is correct The file location: 'C:\Program Files\BST\ReportingSqlGeneration.dll'
Click Execute to register the .dll file
USE [Rincon] GO IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetReportDataset]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[GetReportDataset] GO IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[Sheets.SheetInfo.SheetList.Sheet.SelectCount.QueryDynamicSql]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[Sheets.SheetInfo.SheetList.Sheet.SelectCount.QueryDynamicSql] GO IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[Sheets.SheetInfo.SheetList.Sheet.SelectNextParameterizedEx]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[Sheets.SheetInfo.SheetList.Sheet.SelectNextParameterizedEx] GO IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[Sheets.SheetInfo.SheetList.Sheet.Select.QueryDynamicSqlEx]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[Sheets.SheetInfo.SheetList.Sheet.Select.QueryDynamicSqlEx] GO IF EXISTS (SELECT * FROM sys.assemblies asms WHERE asms.name = N'ReportingSqlGeneration') DROP ASSEMBLY [ReportingSqlGeneration] GO CREATE ASSEMBLY ReportingSqlGeneration from 'C:\Program Files\BST \ReportingSqlGeneration.dll' WITH PERMISSION_SET = SAFE GO CREATE PROCEDURE [dbo].[GetReportDataset] @reportUid [uniqueidentifier], @startDate [datetime], @endDate [datetime] WITH EXECUTE AS CALLER AS EXTERNAL NAME [ReportingSqlGeneration].[Bst.Rincon.BL.ReportingInformation.SqlGeneration.StoredProcedures].[GetReportDataset] GO CREATE PROCEDURE [dbo].[Sheets.SheetInfo.SheetList.Sheet.Select.QueryDynamicSqlEx] @queryUid [uniqueidentifier], @orderByClause [nvarchar](4000), @sheetType [int], @startRowIndex [int], @maximumRows [int], @createdBy [nvarchar](4000), @locationUid [uniqueidentifier], @observerUid [uniqueidentifier], @fromSheetId [int], @toSheetId [int], @fromDate [datetime], @toDate [datetime] WITH EXECUTE AS CALLER
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
38 | P a g e
AS EXTERNAL NAME [ReportingSqlGeneration].[Bst.Rincon.BL.ReportingInformation.SqlGeneration.StoredProcedures].[Sheets_SheetInfo_SheetList_Sheet_Select_QueryDynamicSqlEx] GO CREATE PROCEDURE [dbo].[Sheets.SheetInfo.SheetList.Sheet.SelectCount.QueryDynamicSql] @queryUid [uniqueidentifier], @sheetType [int], @createdBy [nvarchar](4000), @locationUid [uniqueidentifier], @observerUid [uniqueidentifier], @fromSheetId [int], @toSheetId [int], @fromDate [datetime], @toDate [datetime] WITH EXECUTE AS CALLER AS EXTERNAL NAME [ReportingSqlGeneration].[Bst.Rincon.BL.ReportingInformation.SqlGeneration.StoredProcedures].[Sheets_SheetInfo_SheetList_Sheet_SelectCount_QueryDynamicSql] GO CREATE PROCEDURE [dbo].[Sheets.SheetInfo.SheetList.Sheet.SelectNextParameterizedEx] @sheetType [int], @sheetUid [uniqueidentifier], @indexDelta [int], @createdBy [nvarchar](4000), @sortExpression [nvarchar](4000), @locationUid [uniqueidentifier], @observerUid [uniqueidentifier], @queryUid [uniqueidentifier], @fromSheetId [int], @toSheetId [int], @fromDate [datetime], @toDate [datetime] WITH EXECUTE AS CALLER AS EXTERNAL NAME [ReportingSqlGeneration].[Bst.Rincon.BL.ReportingInformation.SqlGeneration.StoredProcedures].[Sheets_SheetInfo_SheetList_Sheet_SelectNextParameterized]
GO
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
39 | P a g e
CONNECTING TO RINCON
From the server where Rincon is installed: http://localhost/Rincon
From a remote workstation: http://ServerName/Rincon
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
40 | P a g e
INSTALLATION OF MULTIPLE VIRTUAL DIRECTORIES
Hosting multiple virtual directories on a single instance is common practice. It is possible to use the Rincon Installation Wizard to install multiple virtual directories – but users will need to enter the serial number in each instance. The follow pages illustrate how to manually create additional virtual directories. There are different instructions for IIS 6.0 and IIS 7.0/
Create Virtual Directories IIS 6.0
The following diagram displays the file hierarchy of the default Rincon 3.x Installation.
Each Rincon website/database will require a unique Virtual Directory. We recommend a consistent naming contingency for the Rincon Web Virtual Directories and Rincon Databases
Create a new folder (Rincon_VirtualDirectory_2) at the same level as the existing Rincon Virtual Directory. The default location is C:\program files\BST
Make a Copy all the contents of the Rincon folder (C:\program files\BST\Rincon) and copy it to C:\program files\BST\Rincon_VirtualDirectory_2
Repeat the above steps for the remaining virtual directories
Open IIS Manager (Start Control Panel Administrative Tools Internet Information Services.)
Highlight Default Web Site
Right Click and select New Virtual Directory
Web Files
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
41 | P a g e
In the Virtual Directory Creation Wizard click Next
Type "Rincon_VirtualDirectory_2" in the Alias: box and click Next
Browse for the Directory C:\program files\BST\Rincon_VirtualDirectory_2
Click Next
Confirm the following permissions have been granted by placing a check mark to the left of them: Read
Click Next and then Finish to complete the wizard
Activate the Virtual Directory
Right‐click the virtual directory and select Properties
Under the Virtual Directory tab, click the Create button after Application Name
Change Execute Permissions to Scripts Only
Change Application Pool to RinconAppPool
Click Apply
Do not close the properties window
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
42 | P a g e
Click the Documents tab
Under Enable Default Document, click Add
Type default.aspx and OK
Delete all other documents by clicking Remove, so that only default.aspx remains
Click OK
Repeat the above steps for all additional virtual directories.
Manually Update the Web.Config File
The database name <nitial Catalog> will need to be updated on line 42, this can be done manually as outlined below or by using the Update Web.config Utility as outlined on page 44
To manually update the web.config file, open the file from the root of the virtual directory with a text editor or Visual Studio. Please see the Rincon Web.Config Specification guide for more details on program options.
Update the Initial Catalog (Rincon)on line 42
<add name="Rincon" providerName="System.Data.SqlClient" connectionString="data source=SQLServerInstanceName;Integrated Security=SSPI;Initial Catalog=Rincon;Persist Security Info=False;" />
</connectionStrings>
Test the New Virtual Directory
Open an internet browser from the machine hosting IIS
Type the following address http://localhost/Rincon_VirtualDirectory_2 ‐ where Rincon_VirtualDirectory_2 is the name of the new Rincon website
The Rincon login page or dashboard should appear.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
43 | P a g e
Create Virtual Directories IIS 7.0
The following diagram displays the file hierarchy of the default Rincon 3.x Installation.
Each Rincon website/database will require a unique Virtual Directory. We recommend a consistent naming contingency for the Rincon Web Virtual Directories and Rincon Databases
Create a new folder (Rincon_VirtualDirectory_2) at the same level as the existing Rincon Virtual Directory. The default location is C:\program files\BST
Make a Copy all the contents of the Rincon folder (C:\program files\BST\Rincon) and copy it to C:\program files\BST\Rincon_VirtualDirectory_2
Repeat the above steps for the remaining virtual directories
Open IIS Manager Open the IIS Manager (Start Administrative Tools Internet Information Systems (IIS) Manager)
Highlight Default Web Site
Right Click and select Add Virtual Directory
Web Files
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
44 | P a g e
In the Virtual Directory Creation Wizard click Next
Type "Rincon_VirtualDirectory_2" in the Alias: box and click Next
Browse for the Directory C:\program files\BST\Rincon_VirtualDirectory_2
Click OK
In the connections pane, the new virtual directory will appear with a folder icon
Right click on the folder icon and select Convert to Application
The Add Application window will appear. Click on Select to change Application Pool to RinconAppPool
Click OK
In the Features View pane, click the Default Document icon
Confirm that default.aspx is the only item in the document list. Add or Remove any pages as needed under the Actions menu.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
45 | P a g e
Manually Update the Web.Config File
The database name <nitial Catalog> will need to be updated on line 42, this can be done manually as outlined below or by using the Update Web.config Utility as outlined on page 44
To manually update the web.config file, open the file from the root of the virtual directory with a text editor or Visual Studio. Please see the Rincon Web.Config Specification guide for more details on program options.
Update the Initial Catalog (Rincon)on line 42
<add name="Rincon" providerName="System.Data.SqlClient" connectionString="data source=SQLServerInstanceName;Integrated Security=SSPI;Initial Catalog=Rincon;Persist Security Info=False;" />
</connectionStrings>
Test the Virtual Directory
Open an internet browser from the machine hosting IIS
Type the following address http://localhost/Rincon_VirtualDirectory_2 ‐ where Rincon_VirtualDirectory_2 is the name of the new Rincon website
Or from IIS Manager locate the Manage Application menu on the far right hand side and click Browse*:80 (http)
The Rincon login page or dashboard should appear.
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
46 | P a g e
TROUBLESHOOTING
ERROR: Named Pipes Provider, error: 40 ‐ Could not open a connection to SQL Server
The SQL DataSource is incorrect in the Rincon web.config file. Open the Rincon Web.Config Utility from Start Program Files BST Follow the steps in the RINCON WEB.CONFIG UPDATE UTILITY on the next page
ERROR: Login failed for User 'NT Authority\Network Service' Or ERROR: Login failed for User 'Domain\RinconService'
The restored Rincon database has not been assigned the proper user account in SQL Express. Refer to the steps on the following page outlined in section: SQL SERVER CONFIGURATION
Error When Previewing Reports
If data does not appear when previewing a report follow the steps on page 25 to Register Rincon SQL Reporting Assembly
RINCON® PLUS 3.5.1 MULTI‐SERVER INSTALLATION GUIDE
47 | P a g e
Rincon Web.config Update Utility
The Rincon Setup Wizard will launch the Rincon Web.Config Update Utility. This utility will allow users to change some options within the Rincon Software. Only the first step is required in Rincon Basic.
On the SQL Connection tab, confirm the SQL Data Source and Database Name are correct.
In Rincon Basic the correct SQL DataSource is (local)\SQLExpress. If SQLExpress is hosted on another workstation the correct SQL DataSource is computername\SQLExpress. The SQL DataSource of (local) will return an error.
Click Use Connection and Update.
Manually Update the Web.Config File
To manually update the web.config file, open the file from the root of the virtual directory with a text editor or Visual Studio. Please see the Rincon Web.Config Specification guide for more details on program options.
Update the data source (SQLServerInstanceName) and Initial Catalog (Rincon)on line 42
<add name="Rincon" providerName="System.Data.SqlClient" connectionString="data source=SQLServerInstanceName;Integrated Security=SSPI;Initial Catalog=Rincon;Persist Security Info=False;" />
</connectionStrings>
Behavioral Science Technology, Inc Software Support Department
417 Bryant Circle Ojai, California 93023
Phone: 805.646.4595 x414 Email: [email protected]