Rincon Plus 3.5.1 Multi-Server...

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


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


Register Rincon SQL Reporting Asembly in Database.............................................................................. 27

INSTALLATION OF MIGRATED BAPPTRACK DATA............................................................................................ 30


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


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.


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


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


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


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


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


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


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.


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.


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.


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.


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>


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.


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


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.


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.


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.


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


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


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


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


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


26 | 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

a

c


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.




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


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


29 | P a g e

EXTERNAL NAME [ReportingSqlGeneration].[Bst.Rincon.BL.ReportingInformation.SqlGeneration.StoredProcedures].[GetReportDataset]





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.


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.



32 | P a g e



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


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


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


35 | P a g e


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


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.




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


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


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


39 | P a g e





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


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


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.


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.


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


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.


45 | P a g e


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


Update the Initial Catalog (Rincon)on line 42



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.


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


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.



Update the data source (SQLServerInstanceName) and Initial Catalog (Rincon)on line 42



Behavioral Science Technology, Inc Software Support Department

417 Bryant Circle Ojai, California 93023

Phone: 805.646.4595 x414 Email: [email protected]

Rincon Plus 3.5.1 Multi-Server...

Documents

Transcript of Rincon Plus 3.5.1 Multi-Server...