Professional Documents
Culture Documents
Page 1 of 142
Previous
Next
Installation Instructions
This section contains installation instructions for individual Dimensions products. Dimensions Development Library 4.5 mrPaper 4.5 mrTranslate 4.5 mrInterview 4.5 Author 4.5 mrTables 4.5 Reporter 4.5 mrStudio 4.5 Dimensions Component Pack 4.5 Data Model 4.5 Dimensions Interview Player 4.5 Related Topics
The Installation Log and the Windows Build Number User Guides Next
1/15/2008
Installation Instructions
Page 2 of 142
Optional. An additional 150MB of disk space for the browser-based version of the DDL documentation. A graphics adapter with 1024 x 768 resolution or higher. Minimum 16-bit color quality setting. Samples and Tools The Dimensions Development Library includes a number of samples and tools. All of these require Dimensions Data Model 4.5 or later to be installed, and some have additional requirements: Three C# wizards that can be used with Visual Studio .NET to simplify the creation of a DimensionNet activity. The wizards require mrInterview 4.5 or mrTables 4.5 to be installed. A Visual C++ wizard that simplifies the creation of a case data source component (CDSC). This requires Visual C++ 6.0 with Service Pack 4 or later to be installed. The Visual C++ source code for the XML CDSC. To compile this source code, you require Microsoft Visual C++ 6.0 with Service Pack 4 or later, Microsoft Data Access Components (MDAC) 2.8 or later, and Microsoft Windows Template Library from the Microsoft Platform SDK. The Visual Basic source code for the following tools and applications: a skeleton Visual Basic CDSC project, an example Visual Basic CDSC, a CDSC test tool, DM Query, DSC Explorer, MDM Explorer, and a tool for creating aliases in an MDM document. These require Visual Basic 6.0. Executable files are provided for DM Query and MDM Explorer so that you can use them even if do not have Visual Basic. The source code and executable files for three Visual Basic .NET applications: DM Query.NET, WinDMSRun, and DPM Explorer.NET. To run the WinDMSRun executable file, you need mrStudio 4.5, and to run DPM Explorer.NET, you need mrInterview 4.5 or mrTables 4.5. To compile the source code, you need these products and Visual Basic .NET. Numerous sample DataManagementScript (DMS) files. To run these files, you need mrStudio 4.5 to be installed. Numerous sample mrScriptBasic files. To run these files, you need Data Model 4.5 to be installed. Some of these samples have additional requirements, such as a later version of the Data Model, Microsoft Office, mrStudio 4.5, or mrStudio Tables Option 4.5. A number of sample mrScriptMetadata files. To use these files, you need Data Model 4.5 or later to be installed. The Short Drinks sample comes in the form of an SQL Server backup of a relational MR (RDB) database. You need SQL Server 2000 Client Tools to restore and use this database. Related Topics
Required Software Checklist Previous Next
1/15/2008
Installation Instructions
Page 3 of 142
If you do not have Visual C++ 6.0 installed, the installation program will not install the Visual C++ CDSC wizard. However, this will not affect the rest of your installation. If you subsequently install Visual C++ 6.0, you can install the Visual C++ CDSC wizard by following the instructions in Modifying Your Installation. Dimensions Development Library 4.5 is available as a separate installation on the installation CDs of the following SPSS Dimensions products: mrTables 4.5; mrInterview 4.5; mrStudio 4.5; Dimensions Component Pack 4.5; Data Model 4.5. It is also available as a free download from http://www.spss.com/DDL. Follow the appropriate instructions below for installing Dimensions Development Library 4.5 from either a CD or a download. Installing from a Dimensions Product Installation CD The Windows AutoPlay feature should detect and start the installation program when you insert the Dimensions product installation CD into the CD-ROM drive. If this does not happen, follow these steps to start the installation program manually: Insert the Dimensions product installation CD into the CD-ROM drive. From the Windows Start menu, choose Run. In the Run dialog box, type d:\autoplay where d:\ is the CD-ROM drive. This opens the Dimensions product Installer window. To Install from a Dimensions Product Installation CD From the Dimensions product Installer window, choose Browse the CD-ROM. Browse to the DDL folder and double-click the file Setup.exe This starts the SPSS Dimensions Development Library 4.5 Setup wizard. Now follow the steps in the section below called Continuing the Installation. To Install from a Download Using a program for extracting files from a ZIP archive, open the archive file that you downloaded, which is called DDL4.5.zip. Extract all the files in the archive to the folder of your choice. When the extraction is complete, go to the folder the files were extracted to and double-click the file Setup.exe This starts the SPSS Dimensions Development Library 4.5 Setup wizard. Now follow the steps below. Continuing the Installation On the Welcome page, click Next. On the License Agreement page, read the license agreement. If you accept the agreement, click I accept the terms in the license agreement and click Next. In the Customer Information page, enter your user name and your organization's name and click Next. In the Setup Type page, choose one of the following: Typical. Choose this option if you want to install the documentation in compiled-help format and all of the tools and samples into the default location. Complete. Choose this option if you want to install the documentation in both compiled-help and browser-based formats and all of the tools and samples into the default location. You should choose this option if you want to be able to use context-sensitive help in mrStudio or if you want to be able to search the DDL using a desktop search engine. Custom. Choose this option if you want to specify exactly what to install and where it is to be installed. Click Next. If you chose the Custom installation, select the options that you want to install in the Custom Setup page. You can also specify where the files will be installed by clicking the Change button in the lower part of the window. Then click Next. The SPSS Dimensions Development Library 4.5 Setup wizard is now ready to start the installation. Click Install. Related Topics
Modifying Your Installation Previous Next
1/15/2008
Installation Instructions
Page 4 of 142
On the Welcome page, click Next. In the Program Maintenance page, choose Modify, and then click Next. To add options, select any new options that you want to include in the Custom Setup page. Make sure that every option you want to include is selected, including any previously installed options. To remove an option, clear the selection of that item in the Custom Setup page. Make sure that every option you want to include is selected, including any previously installed options. Note that this is not an effective way to remove Dimensions Development Library 4.5 completely. Click Next. The SPSS Dimensions Development Library 4.5 Setup wizard is now ready to modify the installation. Click Install.
Previous Next
Troubleshooting
Related Topics
Running a Logged Installation Previous
1/15/2008
Installation Instructions
Page 5 of 142
1/15/2008
Installation Instructions
Page 6 of 142
mrPaper 4.5. ReadSoft Eyes & Hands Forms (EHF) 5.2 Service Pack 13 Hotfix 4. Hardware A hard disk with at least 1MB of free disk space for each questionnaire page that will be transferred to the scanning software in one session. This space is only required during the transfer and is released when the transfer is complete. License Code Your license code, which is supplied with your mrPaper 4.5/mrScan 4.5 installation CD. This enables you to install the system that you have purchased. Note that from version 3.0 onwards, mrPaper and mrScan have separate license codes. If you are installing mrScan you must enter both the code for mrPaper and the code for mrScan. Note: It is not possible to add mrScan to an existing mrPaper installation. You must remove mrPaper and then install both mrPaper and mrScan. See Removing mrPaper 4.5/mrScan 4.5 for more information. During the installation, make sure that you enter the license codes for both products. Related Topics
What You Need to Run mrPaper 4.5 Installing Microsoft .NET Framework 2.0 Installing Internet Explorer 6.0 Microsoft Data Access Components 2.8 Previous Next
1/15/2008
Installation Instructions
Page 7 of 142
1/15/2008
Installation Instructions
Page 8 of 142
To Install the mrScan Virtual Printer From the Windows Start menu choose: Settings Printers and Faxes Click Add a Printer. This opens the Add Printer wizard. Click Next until you are at the Local or Network Printer page of the wizard and select Local Printer attached to this computer. Clear the Automatically detect and install my Plug & Play printer check box. Click Next. From the list of available ports, select File, and then click Next. In the page containing the list of printers, click Have Disk. This opens the Install From Disk dialog box. Click Browse, select the oemsetup.inf file from the \Printer Driver folder on the CD-ROM, and then select Open. Click OK. Click Next. The printer name is shown as MRSCAN. Do not change the name of the printer; it must be named MRSCAN. Select No to Do you want to use this printer as the default printer? Click Next. Select Do not share this printer or Not shared, and then click Next. Select No to Would you like to print a test page? If necessary, click Next until you reach the final page of the wizard. Click Finish. Windows will now install the mrScan printer driver. Note: Windows gives a warning during the installation with the message This software has not been tested on Windows and may not work correctly. You can safely ignore this warning. When the installation is complete the MRSCAN printer will be listed in the Printers window. Setting up the mrScan Printer After you have installed the mrScan virtual printer, you must ensure that: The paper size set for the virtual printer is the same as the paper size you are using for the questionnaires you are going to scan. The resolution set for the virtual printer is the same as the resolution set for the scanner that will be used to scan the questionnaires. For information on changing the paper size and resolution for the mrScan virtual printer, see the mrScan Help file.
Previous Next
1/15/2008
Installation Instructions
Page 9 of 142
Open Control Panel and choose Add/Remove Programs. Choose SPSS mrPaper 4.5/mrScan 4.5 Click Add/Remove or Remove. This starts the SPSS mrPaper 4.5/mrScan 4.5 Setup wizard. On the Welcome page, choose Remove and then click Next. Confirm your request when prompted to do so. On the Maintenance Complete page, click Finish. Restart your computer when prompted to do so. If you do not restart you will not be able to re-install mrPaper 4.5/mrScan 4.5. To Remove Backup Directories When you remove mrPaper or mrScan 4.5, the installation program saves the installed document templates in a backup folder within the A4 and US Letter folders, which are located within the Microsoft Templates folder. If you do not want to keep the backed up files, delete the backup folders manually. The first time you remove mrPaper or mrScan, the backup folders are named BakA4000 and BakLetter000. If you uninstall again and the backup folders have not been removed, the installation program creates new backup folders named BakA4001 and BakLetter001, the next time they are named BakA4002 and BakLetter002, etc. Similarly, the installation program saves the conditional substitution file (condstyl.mdd) and the installed Looks in backup folders within the Looks folder. The default Looks folder varies with the operating system. Under Windows 2000, it is located within the C:\Documents and Settings\user\Local Settings\Application Data\SPSS Dimensions\mrPaper 4.5 folder, where user is your user name. (The Looks folder is a hidden folder and you can see it in Windows Explorer only if you have selected the option to view hidden files.) If you do not want to keep the backed up files, delete the backup folders manually. The backup folders are named using the same naming conventions as the template backup folders.
Previous Next
Troubleshooting
Related Topics
Running a Logged Installation Tips for Using Word with mrPaper Turkish Language Version of Office 2000 Previous Next
1/15/2008
Installation Instructions
Page 10 of 142
Settings\user\Application Data\Microsoft\Word\ baslangic (where user is your user name) to the Word startup folder, which is typically C:\Documents and Settings\user\Application Data\Microsoft\Word\ BALANGI After you have done this, the mrPaper menu (and if relevant the mrScan menu) will be visible the next time you open Word and you will be able to use mrPaper (and mrScan) in the normal way.
Next
1/15/2008
Installation Instructions
Page 11 of 142
The following software is required and can be installed manually from the mrTranslate 4.5 installation CD. Microsoft .NET Framework 2.0 Related Topics
Microsoft Data Access Components 2.8 Installing Microsoft .NET Framework 2.0 Installing mrTranslate 4.5 Previous Next
1/15/2008
Installation Instructions
Page 12 of 142
In the Setup Type page, choose one of the following: Complete. Choose this option if you want to install mrTranslate 4.5 into the default location. Custom. Choose this option if you want to specify where mrTranslate 4.5 is to be installed. Click Next. If you chose the Custom installation, on the Custom Setup page you can specify where the files will be installed by clicking the Change button in the lower part of the window. Then click Next. The SPSS mrTranslate 4.5 Setup wizard is now ready to start the installation. Click Install. Related Topics
Installing Microsoft .NET Framework 2.0 Previous Next
Troubleshooting
Related Topics
Running a Logged Installation Previous
1/15/2008
Installation Instructions
Page 13 of 142
Open a command prompt. For example, in Windows 2000, click the Start button and choose Programs, then choose Accessories and then choose Command Prompt. At the command prompt, type the following: D:\setup.exe /V"/l*v <name and location of log file>" For example, typing the following would create a file called mylog.txt in the C:\temp folder: D:\setup.exe /V"/l*v C:\temp\mylog.txt" Follow the instructions for installing mrTranslate 4.5, but skip the first step. See Installing mrTranslate 4.5 for more information.
Next
1/15/2008
Installation Instructions
Page 14 of 142
1/15/2008
Installation Instructions
Page 15 of 142
Either Internet Explorer 6.0 or 7.0 or Firefox Web Browser Version 1.0 Note: Modem dialing is not supported on Wyse Winterms: a PC running Microsoft Windows, as previously specified, is required. Related Topics
Required Software Checklist Previous Next
1/15/2008
Installation Instructions
Page 16 of 142
Microsoft .NET Framework 2.0 (supplied) Telephone Interviewing Supervisor Stations A 32-bit version of either Microsoft Windows 2000 Professional with Service Pack 4 or Microsoft Windows XP Professional with Service Pack 2 (64-bit versions are not supported) 486-type processor operating at 66MHz or faster; Intel Pentium III or later recommended 32MB of random-access memory (RAM); 128MB recommended A hard disk with at least 100MB of available disk space A 1024768 or higher resolution graphics adaptor that supports at least 16-bit color A CD-ROM drive Internet Explorer 6.0 or 7.0 Telephone Interviewing Interviewer Stations Either: A 32-bit version of either Microsoft Windows 2000 Professional with Service Pack 4 or Microsoft Windows XP Professional with Service Pack 2 (64-bit versions are not supported) Or: Wyse terminals running Linux V6 and Firefox Web Browser Version 1.0. 486-type processor operating at 66MHz or faster; Intel Pentium III or later recommended 32MB of random-access memory (RAM); 128MB recommended A hard disk with at least 100MB of available disk space A 1024768 or higher resolution graphics adaptor that supports at least 16-bit color A CD-ROM drive Either Internet Explorer 6.0 or 7.0 or Firefox Web Browser Version 1.0 Note: Modem dialing is not supported on Wyse Winterms: a PC running Microsoft Windows, as previously specified, is required. The disk space requirements shown for the different services are the total amounts of space that each individual service requires. There are 50MB of components that are shared between all services, and there are some other components that are shared between certain services but not others. The disk space totals include these shared components, so the total disk space required for installing two or more services on a machine is usually less than the sum of the disk space for those services. The 50MB of shared components are always installed onto a machine's Windows drive, even if you choose to install the mrInterview services onto other drives. In order to run the installation program, you need twice as much free space as the combined size of the .msi and the .cab files for the services you are installing. For example, if you are installing all services on a single machine, you will need twice as much space as the sum of the .msi file and the three .cab files on the CD-ROM. This requirement is only temporary, and allows the installation program to expand the .cab files and extract the files they contain. This space is released when the installation ends. Related Topics
Standard or Professional Installation? Required Software Checklist mrInterview System Configurations Previous Next
Software Microsoft .NET Framework 2.0 Microsoft Data Access Components 2.8 Dimensions Development Library
Scriptwriters' machines
Yes
Yes
Yes
No
Yes
Yes
Yes
Yes
No
Yes
No
No
No
No
Optional
Purchase and install separately The following required software must be purchased and installed separately before mrInterview can be installed.
Web Interviewing Accessories Database
1/15/2008
Installation Instructions
Page 17 of 142
Software Internet Information Services with the ASP.NET option SQL Server (mrInterview Professional only)
Servers
Servers
Servers
Servers
Scriptwriters' machines
Yes
Yes
Yes
No
No
No
No
No
Yes
No
Download and install separately The following required software must be downloaded (it is free) and installed separately.
Web Servers Yes Interviewing Servers Yes Accessories Servers Yes Database Servers No Yes
Software Internet Explorer 6.0 or above Microsoft Office Web Components 10.0 or above
Scriptwriters' machines
No
No
Yes
No
No
mrInterview with Quancept Support mrInterview with Quancept Support requires the following additional software in order to run. Download and install separately The following required software must be downloaded (it is free) and installed separately. Acrobat Reader (required if you want to be able to read the Quancept and mrInterview Scriptwriter's Manual) Back up existing version and reinstall GNU C++ compiler.
Previous Next
1/15/2008
Installation Instructions
Page 18 of 142
Related Topics
Required Software Checklist Previous Next
Installing Microsoft Office Web Components on Machines Running the Accessories Service
Microsoft Office Web Components (OWC) version 10 or later is required for the charting feature of the Phone Reports activity. Microsoft OWC is installed automatically with MS Office 2000, XP, and 2003, and you can download it from Microsoft for other versions of MS Office. Microsoft OWC version 9 is installed with Microsoft Office 2000, version 10 is installed with Office XP, and version 11 is installed with Office 2003. However, Microsoft has stated there are issues using Microsoft OWC in server configurations in version 9 and lower. It is therefore important to install version 10 or higher. You can install Microsoft OWC from the Microsoft Download Center. Microsoft OWC is not supplied with Microsoft Office 2007. For information on the options available for installing Microsoft OWC version 11 for use with Microsoft Office 2007, see http://technet2.microsoft.com/Office/en-us/library/0dee24b3-09af-485b-b5ed-d4b879dcc8f61033.mspx?mfr=true. For further information, see the Microsoft Office XP Web Components Licensing web site http://www.microsoft.com/office/previous/xp/developer/platform/owcfaq.asp. Note: The charting facility is normally disabled in Phone Reports. Before enabling it for a user, you must verify that the user is appropriately licensed for MS OWC. Check your MS OWC license agreement or EULA. Related Topics
Required Software Checklist
1/15/2008
Installation Instructions
Page 19 of 142
Previous
Next
1/15/2008
Installation Instructions
Page 20 of 142
Change the default user permissions set for certain DimensionNet activities Change the administrator password for MSDE Install the CATI Components If your site uses telephone interviewing, change the web service and .NET Framework configuration settings to avoid requests beings queued due to blocked thread pools. If Phone Reports users will need to create charts, enable the charting facility. Enable pop-ups and file downloads for mrInterview If you will be using the Firefox browser, set up automatic NT login for DimensionNet. If you will be running DimensionNet using the Firefox browser on a Wyse 5150SE terminal, increase the default font size in Firefox. Install the mrInterview Load Tool Install Dimensions Development Library Terminal Services You can install mrInterview Standard onto a machine that you access via Terminal Services such as Remote Desktop. The session must have the Local Administration option set and you must be logged on as user with administrative privileges. You cannot install mrInterview using remote administration packages such as Citrix. Disk Imaging mrInterview Standard is not supported with disk imaging. Installing mrInterview Standard on one machine and then making an image on another machine and running mrInterview on that machine is not supported. Domain Controllers Due to the different user security set-up on a domain controller it is not possible to install mrInterview successfully on a domain controller. Domain controllers have only domain level users and groups; they do not have local ones. mrInterview Standard uses only local ones. If you need to install mrInterview on a domain controller please install mrInterview Professional. Related Topics
What You Need to Run mrInterview 4.5 Standard Previous Next
1/15/2008
Installation Instructions
Page 21 of 142
The Quancept and mrInterview Scriptwriter's Manual that is installed as part of the mrInterview with Quancept Support option is delivered in Adobe Acrobat (.pdf) format. To read the document, you need Adobe Acrobat Reader 3 or later. To install Acrobat Reader: From the SPSS mrInterview Installer window, choose How to View PDF Files. Follow the instructions on the screen. Backing Up Your System It is recommended that you back up or make an image of your machine before you run the mrInterview installation program. This ensures that you will be able to go back to your current set-up should anything go wrong. Requirements for the Installation Program The installation program requires that Everyone has full permissions on the \InetPub\wwwroot folder, and will fail if incorrect permissions are set. If necessary, set the appropriate permissions before installing mrInterview and then change them back again once the installation is complete. Navigate to \InetPub, right-click wwwroot and select Properties. On the wwwroot Properties dialog box, select the Security tab. In "Group or user names" select Everyone and ensure that Full control is allowed in the Permissions frame. If Everyone does not appear in the list, add it and set the appropriate permission. Related Topics
Installing mrInterview Standard Replacing Machine Names in URLs with Fully Qualified Machine Names Changing the Default DimensionNet Passwords Adding the ASPNET Account to the Launch Permissions on LogBck02 Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Changing the Administrator Password for MSDE Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 22 of 142
complete this page, or you can choose to skip this page and enter the information later on if you need to use Email. If you want to use Email and you know the name of your Email SMTP server and the port number to use, enter these details in the boxes provided. If you either do not want to use Email or do not have the required information to hand, click I want to configure my email settings later. In either case, click Next to move to the next page. The Start Copying Files page lists the parameters that the Standard installation procedure will use. Click Install to start the installation. During the installation process you will see a number of DOS windows open and close. This is expected behavior and can be ignored. When the installation has finished, choose whether to restart your machine now or later and click Finish. If you want to run the post-installation steps straight away you must restart your machine now. Installing the Web Service on a Different Machine If you chose to install the Web Service onto a different machine to the other mrInterview services, do the following: Log on to the Web Service machine. Browse to the c:\mrInterviewSiteInstallation folder on the machine on which you originally ran the installation program (the Interview Service machine); that is, to \\IntServerName\c\mrInterviewSiteInstallation. Repeat the installation procedure you have just followed. When you do this, the installation procedure will connect your Web Service machine to your Interview Service machine. You will see many of the same pages again but this time they may have some of the fields completed. Do not change these fields. Reboot the computer when given the option to do so. Machines with Multiple IP Addresses If you have installed the whole of mrInterview, or just the Web Service, onto a machine that has multiple IP addresses and you have web sites configured for each IP address, do the following: On the main mrInterview machine (not the one running just the Web Service), browse to C:\Program Files\SPSS Dimensions\DDL\Code\Tools\VB.Net\DPMExplorer.Net and double-click DPMExplorer.exe. In the left-hand frame, click Clusters. In the upper right-hand frame, click DefaultCluster. The property's value is displayed in the lower right-hand frame. In the lower right-hand frame, replace the machine name that is assigned to WebServerList with the IP address of the machine on which you installed the Web service. Click Apply and close DPM Explorer. If your Web Site uses SSL If your Web site uses SSL, do the following: From Control Panel select: Administrative Tools Internet Information Services This opens the Internet Information Services window. In the left-hand frame, navigate to the Web site through which users will access mrInterview. Then right-click on the web site name and select Properties. This opens the Web Site Properties dialog box. Right-click mrIEngWS and select Properties. In the Secure communications frame, click Edit. This opens the Secure Communications dialog box. Cancel Require secure channel (SSL) and click OK. Close IIS. Either reboot the Interview Service machine now or, on the Interview Service machine, navigate to C:\Program Files\SPSS Dimensions\mrInterview\Server and run RegIntSvr.exe. Both actions register the Interviewing Service with the Web Service. When you have finished installing Run any post-installations steps that are necessary. mrInterview with Quancept Support mrInterview with Quancept Support has its own installation procedure that is very similar to the main mrInterview installation procedure. To install mrInterview with Quancept Support, proceed as follows: On the installation CD, navigate to the mrInterview4.5Q folder and double click setup.exe. Repeat all the steps you have just carried out for the main mrInterview installation, including those related to installing the Web Service on a different machine and for using SSL if appropriate. Restarting the Interviewing Engine If your Web site uses SSL, do the following: On the Interview Service machine, open Control Panel and choose:
1/15/2008
Installation Instructions
Page 23 of 142
Administrative Tools Services This opens the Services window. In the right-hand frame, select mrEngine and click the Stop Service button. When the service confirms that it has stopped, click the Start Service button. If you do not do not this, interviews for mrInterview with Quancept Support will not run on the Web Service machine. Reinstall the GNU C++ Compiler Locate the back up of the Gcc folder that you made before uninstalling the previous version of mrInterview, and copy it into C:\Program Files\SPSS Dimensions\mrInterview. Make sure the folder is called Gcc. When you have finished installing Run any post-installations steps that are necessary. Related Topics
Pre-Installation Tasks for the Standard Installation Procedure Replacing Machine Names in URLs with Fully Qualified Machine Names Changing the Default DimensionNet Passwords Adding the ASPNET Account to the Launch Permissions on LogBck02 Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Changing the Administrator Password for MSDE Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 24 of 142
In the DefaultCluster property, replace the value of WEBSERVERLIST with a fully qualified domain name, for example: DBSERVER&=&MyDbServer&;&DBDRIVER&=&SQL Server&;&IVSERVERLIST&=&MyIntServer&;&WEBSERVERLIST&=&ServerName.DomainName.com&;&CONNECTIONSDATABASE&=&Provider=SQLOLEDB;Integrated Security=SSPI;Initial Catalog=mrInterviewData;Data Source=MyServerName; Close DPM Explorer. Related Topics
Pre-Installation Tasks for the Standard Installation Procedure Installing mrInterview Standard Changing the Default DimensionNet Passwords Adding the ASPNET Account to the Launch Permissions on LogBck02 Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Changing the Administrator Password for MSDE Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 25 of 142
This opens the LogBckO2 Properties dialog box. Select the Security tab. In the Launch and Activation Permissions frame click Edit. This opens the Launch Permissions dialog box. Click Add. This opens the Select Users or Groups dialog box. Click Locations, and change the location to be your local machine. Then click OK. Add ASPNET, and click OK. In the Launch Permissions window, check that Local Launch and Local Activation are allowed for the ASPNET user and set them if not. Close dcomcnfg. Related Topics
Pre-Installation Tasks for the Standard Installation Procedure Installing mrInterview Standard Replacing Machine Names in URLs with Fully Qualified Machine Names Changing the Default DimensionNet Passwords Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Changing the Administrator Password for MSDE Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 26 of 142
Adding the ASPNET Account to the Launch Permissions on LogBck02 Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Changing the Administrator Password for MSDE Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 27 of 142
Previous
Next
Related Topics
Pre-Installation Tasks for the Standard Installation Procedure Installing mrInterview Standard Replacing Machine Names in URLs with Fully Qualified Machine Names Changing the Default DimensionNet Passwords Adding the ASPNET Account to the Launch Permissions on LogBck02 Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Administrator Password for MSDE Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 28 of 142
Adding the ASPNET Account to the Launch Permissions on LogBck02 Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
Changing Thread Configuration Settings for the Interviewing Engine and the .NET Framework
This topic applies only to sites that run telephone interviews. When a telephone interviewer requests a number to call, the Phone activity requests one from the sample management system. If the system does not have enough resources allocated for dealing with these requests, the requests will be queued and interviewers will have to wait longer than necessary to receive numbers. You can reduce the likelihood that this will happen by increasing the resources available for processing requests.
1/15/2008
Installation Instructions
Page 29 of 142
Make the following changes on each machine running the Interviewing Service. From the Windows Start menu, choose Run. In the Run dialog box, type regedit and click OK. Step down through the hierarchy to HKEY_LOCAL_MACHINE\SOFTWARE\SPSS\mrInterview\3\Interviewing. Right-click in the right-hand frame, select New, DWORD value, and enter DefaultThreadPoolSize as the value name. Right-click this new entry and select Modify. In the Edit DWORD Value dialog box, type 100 as the value and choose Decimal as the base. Click OK to save your changes. Close Registry Editor. Navigate to c:\Windows\Microsoft.Net\Framework\v2.0.50727\CONFIG and open machine.config. In the <system.web> section, add the following settings or edit your existing settings so that they contain the designated properties and values. <system.web> <httpRuntime minFreeThreads="88" minLocalRequestFreeThreads="76" /> <processModel autoConfig="false" maxWorkerThreads="100" maxIoThreads="100" /> </system.web> In the <system.net> section, add the following settings or edit your existing settings so that they contain the designated properties and values. <system.net> <connectionManagement> <add address="*" maxconnection="100"/> </connectionManagement> </system.net> Save your changes and close the file. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 30 of 142
Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Changing the Administrator Password for MSDE Installing CATI Components Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 31 of 142
Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
In Firefox, select Edit Preferences Fonts & Colors Make whatever font changes you think are necessary to produce readable text. Related Topics
Pre-Installation Tasks for the Standard Installation Procedure Installing mrInterview Standard Replacing Machine Names in URLs with Fully Qualified Machine Names Changing the Default DimensionNet Passwords Adding the ASPNET Account to the Launch Permissions on LogBck02 Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Changing the Administrator Password for MSDE Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Installing Dimensions Development Library Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 32 of 142
DimensionNet and mrTables load balancing. Wizards and the DimensionNet Application Framework for building your own DimensionNet applications. Distributed Property Management (DPM) and DPM Explorer. File management. Files that control how DimensionNet works. Object models. The mrInterview section includes the following topics. The function of and interaction between mrInterview components. Procedures for starting and stopping interviews, time-outs, and activation. Database tables. Log files. Sample Management. The Project Cache. The Image Cache. Interview Engine load balancing. Object models. The DDL is included on the mrInterview installation CD. Take the following steps to install it. From the mrInterview Installer window, choose Browse the CD-ROM. Browse to the DDL folder. Double-click DDL_Installation_Guide.chm, which provides step-by-step instructions. Double-click Autoplay.exe to start the installation. Related Topics
Pre-Installation Tasks for the Standard Installation Procedure Installing mrInterview Standard Replacing Machine Names in URLs with Fully Qualified Machine Names Changing the Default DimensionNet Passwords Adding the ASPNET Account to the Launch Permissions on LogBck02 Adding mrStudio Users to the Dimensions Group Moving Project Folders for Activated Projects Deleting the Signal Call Outcome Code from DPM Changing the Default User Permissions Changing the Administrator Password for MSDE Installing CATI Components Enabling Charts in the Phone Reports Activity Enabling Pop-ups and File Downloads Enabling Automatic NT Login to DimensionNet for Firefox Changing Font Settings for Firefox on Wyse 5150SE Terminals Moving Project Folders for Activated Projects Previous Next
1/15/2008
Installation Instructions
Page 33 of 142
topic is a simple task list designed for printing, and does not provide links to the topics in this document. Related Topics
What You Need to Run mrInterview 4.5 Professional Installations Using Disk Imaging or Terminal Services Installations onto a Domain Controller Installing mrInterview for Off-Line Use Previous Next
Install Required Software Microsoft Data Access Components 2.8 (Only on machines running the Interview, Accessories and/or Scriptwriter Services).
Acrobat Reader (Required only for the Quancept and mrInterview Scriptwriter's Manual which is part of the Quancept Support option). Internet Explorer 6.0 or 7.0 (On all machines except those running the Database Service only). Internet Information Services with the ASP.NET option (Only on machines running the Web, Interview, and/or Accessories Services).
SQL Server (Only on machines running the Database Service). Microsoft Office Web Components (Only on machines running the Accessories Service). Pre-Installation Tasks Internet Explorer 6.0 or 7.0 installed on all machines (except those running the Database Service only). Each machine in a cluster can communicate with all other machines in the cluster.
DCOM is enabled on all machines. SQL Server is running correctly on all machines that will host the Database Service. IIS is running correctly on all machines that will host the Web, Interview, and/or Accessories Services.
Create the Installing User on all machines (remember that this user requires 'Log on as a service' and 'Log on as a batch job' security settings). Create the Running User on all machines. Optional. Create the Anonymous Access User on all machines. Create the Dimensions User Group on all machines.
Make a back-up or image of all machines on which you will be installing mrInterview software. Installation Log in as the Installing User and install mrInterview. For cluster installations, install mrInterview on all machines named in the site preparation file. Install the Scriptwriter Service on any scriptwriter machines that do not have browser access to DimensionNet. Post-Installation On all machines running the Web Service, if the image cache is installed on a machine with only the Web Service installed and that machine is outside the firewall, configure the image cache as remote. Set up users and roles in DimensionNet and assign roles to DimensionNet applications. On all machines running the Accessories Service, if a machine is running Windows XP Service Pack 2, add the ASPNET account to the Launch permissions on LogBck02. If you have installed onto a machine on which mrStudio is installed, add mrStudio users to the Dimensions group on that machine so that they have access to the log file folder. On all machines running the Web Service, if that machine has multiple IP addresses and web sites configured for each IP address, replace the Web Service machine names with IP addresses in DPM and reregister the Interview Service machines. If machines running the Web Service will be accessed through the internet, replace the machine names in the DimensionsInterviewURL and FileManagerWebserviceURL properties with fully qualified machine names. On all machines running the Interviewing Service, if your site uses SSL, cancel the requirement for mrIEngWS to use a secure channel. On all machines running the Interviewing Service, start mrUserAdminServer and mrDPMServer3 if they are not already running. Check that access control permissions have been set correctly for FMRoot and all its subfolders. Post-Installation on Local Machines If scriptwriters will be using Scriptwriter Station and logging in as anyone other than the Installing User, add DCOM permissions for the machine's Users group to LogBckO2 on those users' machines. If you want interviewers to be able to dial phone numbers automatically using a modem, install the CATI components on those users' machines.
Enable pop-ups and file downloads. Set up automatic NT login for DimensionNet users who use the Firefox browser. For users who will run DimensionNet using the Firefox browser on the WYSE 5150SE, increase the default font size in Firefox.
1/15/2008
Installation Instructions
Page 34 of 142
Optional Post-Installation If you are upgrading from an earlier version of mrInterview, delete the Signal call outcome code from DPM. On machines running the Database Service, add indexes to any existing sample tables to improve performance
If your site uses telephone interviewing (CATI), increase the size of the appRequestQueueLimit setting for the .NET Framework on all machines running the Web Service. If your site uses telephone interviewing, change the configuration settings for the interviewing engine and the .NET Framework on all machines running the Interview Service to avoid requests being queued due to blocked thread pools. Install the Load Tool on a machine of your choice, preferably one outside the mrInterview cluster.
Configure the DimensionNet Email activity if not already done during installation.
On machines running the Interviewing or Accessories Services, increase the number and/or size of the log files. If necessary, create a hosts file linking machine names to IP addresses (may be needed for some firewalls). Set up your Web site to use SSL.
On machines running the Accessories Service, set up DimensionNet load balancing to specify the machines on which mrInterview and its applications will run.
Configure DimensionNet load balancing to use an SSL accelerator. On all machines running the Interviewing Service, change the Interview Engine load balancing algorithm used to distribute interviews to those machines.
Modify the TCP/IP registry settings on all machines running the Interview and Web Services.
If you are using SQL Server 2000 or SQL Server 2005 and a named instance, edit SampleMgtGUI.Config.xml to control the servers available to the Participants and Activate activities. Install the Dimensions Development Library on machines of your choice, but probably on your own computer. Post-Installation for Quancept Support On all machines running the Web Service, if the machine will be accessed through the internet, replace the machine name in the InterviewURL property with the fully qualified machine name. On all machines running the Accessories Service and nothing else, if the Phone Participants activity will be run from that machine, specify the machine on which the Interview Engine is running. On all machines running the Interviewing Service, start or restart mrEngine.
On all machines running the Interviewing Service, make the mrEngine performance counters visible to performance monitoring utilities. Upgrade version 1.2 projects to work with version 4.5. Optional.
Increase the compile and command time-outs for the Quancept Compiler. Optional. Configure DCOM to allow mrInterview to run through a firewall. Optional.
Set up your web site to use SSL. Optional. Improve the fault tolerance of the system. Optional.
Change the default error page and email address. Optional. Change the mrEngine load balancing algorithm used to distribute interviews to the Interview Service machines. Optional.
Related Topics
Installing mrInterview Using the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 35 of 142
several machines. If this is the type of installation that you require, you may prefer to use the Standard installation procedure. Larger sites may have a database machine running SQL Server, and a Web and interview machine running IIS, the Web Service, Interview Service, and Accessories Service. Very large sites will probably have separate machines for each service except the Accessories Service. This will be installed on the machine running the Interview Service. Generally, scriptwriters access the activities they require by connecting to DimensionNet via their browsers. If your site has scriptwriters who work off-line and do not always have access to DimensionNet, you can install the Scriptwriter Service on those machines, and the scriptwriters will be able to create, compile, and activate questionnaires using desktop activities. mrInterview is flexible with regard to how the various machines are set up. It allows all machines to be in the same domain or workgroup, or you can have the database server in one domain with the machines running the other services in another domain. Note: If you use more than one domain, the domains must trust one another. It is important that you consider carefully how your site will be configured before starting to install mrInterview, so that you install the correct services on each machine. Related Topics
Installing mrInterview Using the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 36 of 142
Previous
Next
1/15/2008
Installation Instructions
Page 37 of 142
Click Next. On the next two screens, just click Next. On the following screen, click Finish. This opens the ODBC Microsoft Server Setup dialog box. Click Test Data Source. The system checks that it can access the database using the DSN you have just created, and displays the results of the test. Normally the test will be successful, so click OK. If the test is not successful, you should make a note of any messages the system has displayed and then try to resolve the problem before trying to create a test DSN again. Return to the ODBC Data Source Administrator dialog box. Select the test DSN you have just created and click Remove. Confirm your request when prompted to do so. Related Topics
Pre-Installation Checklist for the Professional Installation Procedure Errors when attempting to ping machines in a cluster Previous Next
1/15/2008
Installation Instructions
Page 38 of 142
Close the Computer Management window. Open Control Panel and choose: Administrative Tools Local Security Policy This opens the Local Security Settings window. In the Tree frame, expand Local Policies and click User Rights Assignment. In the right-hand frame, double-click Log on as a service. This allows the user to run services. This opens the Log on as a service Properties dialog box. Click Add. In the list of names, choose the user name you created earlier and then click Add. Click OK to close the Select Users or Groups dialog box. Click OK again to return to the Local Security Settings window. In the right-hand frame, double-click Log on as a batch job. This allows the user to run a service that itself starts another application or service. This opens the Log on as a batch job Properties dialog box. Click Add. In the list of names, choose the user name you created earlier and then click Add. Click OK to close the Select Users or Groups dialog box. Click OK again to return to the Local Security Settings window. Close the Local Security Settings window. Open your SQL administration program and grant the user DB Creator permission. For example, if you have SQL Enterprise Manager, the steps will be as follows: From the Start menu choose: Programs Microsoft SQL Server Enterprise Manager Expand the tree in the left-hand frame until the contents of the Security node are visible for the mrInterview Database server, and select Server Roles. In the right-hand frame, double-click DB Creators. This opens the Server Role Properties dialog box. Click Add. In the list of names, choose the user name you created earlier and then click OK. Click OK to close the Server Role Properties dialog box and then close Enterprise Manager. Repeat these steps, except the one to add DB Creator rights in SQL, to create the Running User account. To Create the Installing and Running Users (domain installations) Create new domain accounts for the Installing and Running Users. Note: If the domain uses case sensitive SQL, you must create the Running User with the Full name and Logon name in the same case. Add the domain accounts for the Installing and Running Users to the local Administrator group on each machine that will be running the Web, Interviewing, or Accessories Services. This is not necessary on machines that will be running only the Database Service. Follow the procedure documented for single machine installations to set the local security policy for these users. Related Topics
Pre-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 39 of 142
To Create the Anonymous Access User For single machine and workgroup installations: Open Control Panel and choose: Administrative Tools Computer Management This opens the Computer Management window. Expand Local Users and Groups, right-click Users and choose New User. This opens the New User dialog box. Enter the user's details and click Create and then Close. For domain installations: Create a new domain account for the Anonymous User. Note: If the domain uses case sensitive SQL, you must create the Anonymous Access User with the Full name and Logon name in the same case. Related Topics
Pre-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 40 of 142
Service RPC. Note: There are specific requirements for RPC communications beyond what is listed in the table. For additional information about configuring RPC communication for a firewall, refer to the Microsoft article Configuring RPC Dynamic Port Allocation to Work With a Firewall. NetBIOS Name NetBIOS Netlogon and Browsing NetBIOS Session
42/TCP
WINS Replication
Related Topics
Preparing to Run mrInterview Through a Firewall Previous Next
1/15/2008
Installation Instructions
Page 41 of 142
It is recommended that you back up or make images of all machines on which you will be installing mrInterview software before you run the installation program. This ensures that you will be able to go back to your current set-up should anything go wrong. It also means that it will be easier to add extra machines into the cluster at a later date. Related Topics
Pre-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 42 of 142
Note: If you choose to install the Quancept Support option, you will pass through this procedure twice, once to install mrInterview 4.5and then again, after a reboot, to install the Quancept Support option. It is therefore important that you reboot your computer when asked at the end of the first installation otherwise the Quancept Support option will not be installed.
Previous Next
1/15/2008
Installation Instructions
Page 43 of 142
On the User Information page, enter the mrInterview Professional server license code and click Update. If you want to install the Web CATI option, enter the Web CATI license code and click Update again. Then click Next. Note: The mrInterview server license code covers the Web, Interview, Accessories and Scriptwriter Services. On the Machine Configuration page, choose Single Machine Install. On the Cluster Settings page, enter a name for your Dimensions site and click Next. The site name that you choose is displayed on the main DimensionNet page and can be any name of your choice. On the mrInterview User and Group page, enter information about the user and group that should be used for running the mrInterview services. For each account, click Domain if it is a domain account and enter the domain name in the box. If the account is a workgroup account, click Workgroup. In the Username, Password and Group boxes, enter the name and password of the Running User and the name of the Dimensions Group. Then click Next. Note: The names that you enter must be valid names for the domain or workgroup on which you will be installing. On the Anonymous User page, enter the name and password of the Anonymous Access User that you created. Click Domain if this is a domain user account or Workgroup if this is a workgroup user account. Then click Next. On the mrInterviewData Database Setup page, enter the name of the database server on which you want to create the mrInterviewData database and click Next. On the DPM User Admin Details page, enter a name and password for the DimensionNet Administrator. Note: This user name is simply for accessing the Distributed Property Management (DPM) database to perform administrative tasks such as setting up DimensionNet users and roles, and managing access to DimensionNet files and applications. It exists only in DPM. To avoid possible conflicts with other user names, the name that you choose should not match any of the NT user names known to your system. On the Email Settings page, enter the name of your Email SMTP server and the port number to use. Alternatively, if you do not want to use the Email activity or do not have the required information to hand, click I want to configure my email settings later. In either case, click Next to move to the next page. On the Internet Information Services (IIS) Configuration page, the installation program detects any web sites available on the installation machine and displays them in the drop-down list box. If you want to use a web site other than the default for your SPSS applications, select it from the drop-down list. The default file location for the web site you have selected is displayed. If the installation program detects a folder called SPSS MR within the web site folder structure, you are prompted to install the files in this folder instead. If you want to install the files to a different location, click Browse and choose the folder you want to use. If you are installing onto a machine running the Windows 2003 operating system, the Advanced button is available for advanced configuration of your chosen website. This allows you to place DimensionNet and/or mrInterview in their own application pools so that each process can be split across multiple application pools. (The operating system places a 2Gb restriction on processes in IIS. Put simply, splitting a process across application pools means that it is possible to run larger processes. Refer to your IIS documentation for general information about application pools.) If you want to use application pools, proceed as follows: Click Advanced. This opens the Advanced IIS Configuration page. To place DimensionNet in its own application pool, select Use "SPSSDimensionNetPool" application pool. If you want processes to recycle and/or shut down after so many minutes, select the appropriate option and enter the number of minutes elapse time required. Selecting this option means that if the DimensionNet process is recycled or shut down, anyone using DimensionNet activities at that time will have to restart their session in order to continue working. To place mrInterview in its own application pool, select Use "SPSSmrInterviewPool" application pool. If you want processes to recycle and/or shut down after so many minutes, select the appropriate option and enter the number of minutes elapse time required. Selecting this option means that if the mrInterview process is recycled or shut down, anyone using mrInterview activities at that time will have to restart their session in order to continue working. Click OK. On the Internet Information Services (IIS) Configuration page, click Next when you are ready to continue. Note: If the mrInterview with Quancept Support installation program detects a Scripts folder on a machine running the Web Service, the mrwebpl.dll file is automatically installed in that folder. If no Scripts folder is detected, the file is installed in the same web site as the other Web Service files. On the Setup Type page, choose Typical to install all services on your current machine, or Custom to specify the locations of the various directories that the installation procedure creates. Then click Next. Custom Installation Only On the Choose Destination Location page, choose the folder in which you want to install mrInterview. The default is C:\Program Files\SPSS Dimensions. Click Next. On the File Management Folder page, choose the location of the File Management root folder (FMRoot). This is the folder in which the master copies of project files created using DimensionNet or the Scriptwriter desktop activities will be stored, and it is from here that the interviewing machines will make local copies of these files. The File Management root folder must be shared so that it is accessible by other machines. If you choose a folder on your current machine, the installation procedure will create the share for you. If you choose a folder with a UNC pathname (that is, one that starts \\machine_name\...) this will be used as the shared folder. Click Next. Note: You can create the File Management root folder on any machine as long as its share is visible to all machines running the Interviewing and Scriptwriter Services. The ideal location is a separate machine that acts as a file server rather than a machine running the Interviewing or Accessories service. This is because the File Management root folder is an integral part of most DimensionNet and mrInterview functionality, and needs to be available all the time that DimensionNet is running. If you install it on a machine that is running the Interviewing or Accessories service and you need to restart that machine, DimensionNet becomes effectively unusable by anyone on any other machine until the service machine has restarted. On the Select Features page, choose the services to be installed, and then click Next. Possible choices are as follows: ScriptWriter. Installs the Scriptwriter Service. This is installed automatically if you install the Accessories Service. Interview Service. Installs the Interview Service.
1/15/2008
Installation Instructions
Page 44 of 142
Web Service. Installs the Web Service. Accessories. Installs the Accessories Service, including DimensionNet. WebCATI. Installs the WebCATI Service. In a single machine installation you will generally want to select all of the services, with the possible exception of WebCATI. If you want to install different services on different machines you should use the cluster installation procedure instead. The Choose Destination Location page allows you to specify the folder that you want to create for storing the project files that the Interview Services use for running interviews. (When a scriptwriter activates a project, the activation program copies the questionnaire file and the templates into the Projects folder so that they are available for interviewing.) The default is C:\Program Files\SPSS Dimensions\mrInterview\Projects. If you are installing mrInterview with Quancept Support you will also be able to create a folder in which source files for desktop applications can be stored. The default for this folder is c:\mrInterviewSource. Click Next to continue. Typical and Custom Installations The Start Copying Files page lists the services you have chosen to install and the name of the database server you have chosen to use. If these settings are correct, click Next. If not, click Back and step back through the pages to make the necessary changes. During the installation process you will see a number of DOS windows open and close. This is expected behavior and can be ignored. When the installation has finished, you will be asked whether you want to reboot your computer now or later. The recommended option is to reboot immediately. Make your selection and click Finish. To complete the installation, you now need to perform the post-installation tasks. mrInterview with Quancept Support mrInterview with Quancept Support has its own installation procedure that is very similar to the main mrInterview installation procedure. To install mrInterview with Quancept Support, proceed as follows: On the mrInterview with Quancept Support installation CD, navigate to the mrInterview4.5Q folder and double click setup.exe. Repeat all the steps you have just carried out for the main mrInterview installation. Locate the back up of the Gcc folder that you made before uninstalling the previous version of mrInterview, and copy it into C:\Program Files\SPSS Dimensions\mrInterview. Make sure the folder is called Gcc. Perform the additional post-installation tasks for mrInterview with Quancept Support. Related Topics
Types of Professional Installation Previous Next
Cluster Installation
When you install onto more than one machine you typically follow these steps: First, you log in on a server that will host the Accessories Service and create a site preparation file . This file names the machines on which the various services will be installed, and sets up a central site preparation folder that can be used by other machines in the cluster. The installation procedure installs not only the services you choose for the machine you have logged in to but also the project management components. This machine becomes the Primary DPM server. If you want to install mrInterview with Quancept Support you will need to follow the installation procedure twice, once for mrInterview and then again, after a reboot, for the Quancept Support option. Then, on each of the machines named in the site preparation file, you run the installation program from the site preparation folder. If a machine needs mrInterview with Quancept Support, you will need to follow the installation procedure twice on that machine, once for mrInterview and then again, after a reboot, for the Quancept Support option. Always install onto your Accessories servers first, followed by all Interviewing servers, and finally all Web servers. Finally, you use the site preparation file to install the Scriptwriter Service onto machines that will be used only for scriptwriting tasks. This step is always required for mrInterview with Quancept Support. If you are not installing Quancept Support because your site creates Dimensions projects only, and all scriptwriters use mrStudio with the Interview Scripting option for scriptwriting tasks, you omit this step. What's installed where?
Software Data Model DPM DimensionNet and activities Scriptwriter Station Activate client component Activate server component Quota Interviewing components Web components Image cache Web Servers No No No No No No No No Yes Yes Interviewing Servers Yes Yes No No No Yes Yes Yes No No Accessories Servers Yes Yes Yes No Yes Yes Yes No No Yes Database Servers No No No No No No No No No No Scriptwriters' machines Yes Yes (partial) No Yes Yes No Yes No No No
Related Topics
Types of Professional Installation Previous Next
1/15/2008
Installation Instructions
Page 45 of 142
1/15/2008
Installation Instructions
Page 46 of 142
On the Internet Information Services (IIS) Configuration page, the installation program detects any web sites available on the installation machine and displays them in the drop-down list box. If you want to use a web site other than the default for your SPSS applications, select it from the drop-down list. The default file location for the web site you have selected is displayed. If the installation program detects a folder called SPSS MR within the web site folder structure, you are prompted to install the files in this folder instead. If you want to install the files to a different location, click Browse and choose the folder you want to use. If you are installing onto a machine running the Windows 2003 operating system, the Advanced button is available for advanced configuration of your chosen website. This allows you to place DimensionNet and/or mrInterview in their own application pools so that each process can be split across multiple application pools. (The operating system places a 2Gb restriction on processes in IIS. Put simply, splitting a process across application pools means that it is possible to run larger processes. Refer to your IIS documentation for general information about application pools.) If you want to use application pools, proceed as follows: Click Advanced. This opens the Advanced IIS Configuration page. To place DimensionNet in its own application pool, select Use "SPSSDimensionNetPool" application pool. If you want processes to recycle and/or shut down after so many minutes, select the appropriate option and enter the number of minutes elapse time required. Selecting this option means that if the DimensionNet process is recycled or shut down, anyone using DimensionNet activities at that time will have to restart their session in order to continue working. To place mrInterview in its own application pool, select Use "SPSSmrInterviewPool" application pool. If you want processes to recycle and/or shut down after so many minutes, select the appropriate option and enter the number of minutes elapse time required. Selecting this option means that if the mrInterview process is recycled or shut down, anyone using mrInterview activities at that time will have to restart their session in order to continue working. Click OK. On the Internet Information Services (IIS) Configuration page, click Next when you are ready to continue. Note: If the mrInterview with Quancept Support installation program detects a Scripts folder on a machine running the Web Service, the mrwebpl.dll file is automatically installed in that folder. If no Scripts folder is detected, the file is installed in the same web site as the other Web Service files. On the Setup Type page, choose Typical to install all services on your current machine, or Custom to choose the services that you want to install, and the locations of the various directories that the installation procedure creates. Then click Next. If you chose a Typical installation, skip the steps labelled Custom Installation Only and continue from Typical and Customs Installations. Custom Installation Only On the Choose Destination Location page, choose the folder in which you want to install mrInterview. The default is C:\Program Files\SPSS Dimensions. Click Next. On the Select Features page, choose the services to be installed, and then click Next. Possible choices are as follows: ScriptWriter. Installs the Scriptwriter Service. This is installed automatically if you install the Accessories Service. Interview Service. Installs the Interview Service. Web Service. Installs the Web Service. Accessories. Installs the Accessories Service, including DimensionNet. WebCATI. Installs the WebCATI Service. The Choose Destination Location page allows you to specify the folder that you want to create for storing the project files that the Interview Services use for running interviews. (When a scriptwriter activates a project, the activation program copies the questionnaire file and the templates into the Projects folder so that they are available for interviewing.) The default is C:\Program Files\SPSS Dimensions\mrInterview\Projects. If you are installing mrInterview with Quancept Support you will also be able to create a folder in which source files for desktop applications can be stored. The default for this folder is c:\mrInterviewSource. Click Next to continue. Typical and Custom Installations The Start Copying Files page displays the name of the folder in which the site preparation file will be created. If this is correct, click Next. If not, click Back and step back through the pages to make the necessary changes. When the installation has finished, you need to share the mrInterviewSiteInstallation folder manually. To do this, proceed as follows. In Windows Explorer, browse to the mrInterviewSiteInstallation folder, right-click and choose Properties. On the Sharing tab, select Share this folder. Click Permissions and add the Installing User and the Dimensions Group. If the installation procedure prompted you to reboot and you chose not to do so at that point, reboot now. mrInterview with Quancept Support mrInterview with Quancept Support has its own installation procedure that is very similar to the main mrInterview installation procedure. To install mrInterview with Quancept Support, proceed as follows: On the installation CD, navigate to the mrInterview4.5Q folder and double click setup.exe. Repeat all the steps you have just carried out for the main mrInterview installation. Locate the back up of the Gcc folder that you made before uninstalling the previous version of mrInterview, and copy it into C:\Program Files\SPSS Dimensions\mrInterview. Make sure the folder is called Gcc. Related Topics
Installing the mrInterview Services on each Machine Named in the Site Preparation File Cluster Installation Previous Next
1/15/2008
Installation Instructions
Page 47 of 142
Installing the mrInterview Services on each Machine Named in the Site Preparation File
The first machine on which you install mrInterview must be one that runs the Accessories Service. We recommend that you install in the following order: all Accessories servers, all Interview servers, all Web servers. Log on as the Installing User. In Windows Explorer, browse to the network directory in which the site preparation file was created. Double-click the AutoPlay file (autoplay.exe). This opens the SPSS mrInterview Installer window. From the SPSS mrInterview Installer window, choose Install mrInterview 4.5. This starts the SPSS mrInterview Setup wizard. On the Welcome page, click Next. On the License Agreement page, read the license agreement. If you accept the agreement, click Yes. On the User Information page, enter the mrInterview Professional server license code and click Update. If you are installing onto a machine that will be running the Accessories Service and you want to use the Web CATI option you will also need to enter the Web CATI license code. Click Next. The Permissions Settings page opens showing the names of the Running User and the Dimensions Group specified in the site preparation file. Enter the password for the Running User and click Next. The Anonymous User page opens showing the name of the Anonymous User specified in the site preparation file. Enter the password for the Anonymous User and click Next. On the DPM User Admin Details page, enter the user name and password for the DimensionNet Administrator that you specified when creating the site preparation file. On the Internet Information Services (IIS) Configuration page, the installation program detects any web sites available on the installation machine and displays them in the drop-down list box. If you want to use a web site other than the default for your SPSS applications, select it from the drop-down list. The default file location for the web site you have selected is displayed. If the installation program detects a folder called SPSS MR within the web site folder structure, you are prompted to install the files in this folder instead. If you want to install the files to a different location, click Browse and choose the folder you want to use. If you are installing onto a machine running the Windows 2003 operating system, the Advanced button is available for advanced configuration of your chosen website. This allows you to place DimensionNet and/or mrInterview in their own application pools so that each process can be split across multiple application pools. (The operating system places a 2Gb restriction on processes in IIS. Put simply, splitting a process across application pools means that it is possible to run larger processes. Refer to your IIS documentation for general information about application pools.) If you want to use application pools, proceed as follows: Click Advanced. This opens the Advanced IIS Configuration page. To place DimensionNet in its own application pool, select Use "SPSSDimensionNetPool" application pool. If you want processes to recycle and/or shut down after so many minutes, select the appropriate option and enter the number of minutes elapse time required. Selecting this option means that if the DimensionNet process is recycled or shut down, anyone using DimensionNet activities at that time will have to restart their session in order to continue working. To place mrInterview in its own application pool, select Use "SPSSmrInterviewPool" application pool. If you want processes to recycle and/or shut down after so many minutes, select the appropriate option and enter the number of minutes elapse time required. Selecting this option means that if the mrInterview process is recycled or shut down, anyone using mrInterview activities at that time will have to restart their session in order to continue working. Click OK. On the Internet Information Services (IIS) Configuration page, click Next when you are ready to continue. Note: If the mrInterview with Quancept Support installation program detects a Scripts folder on a machine running the Web Service, the mrwebpl.dll file is automatically installed in that folder. If no Scripts folder is detected, the file is installed in the same web site as the other Web Service files. Note: The Internet Information Services Configuration page appears only if the machine you are installing on is an Accessories server. On the Setup Type page, choose Typical to install all services on your current machine, or Custom to choose the services that you want to install, and the locations of the various directories that the installation procedure creates. Then click Next. If you chose a Typical installation, skip the steps labelled Custom Installation Only and continue from Typical and Custom Installations. Custom Installation Only On the Choose Destination Location page, choose the folder in which you want to install mrInterview. The default is C:\Program Files\SPSS Dimensions. Click Next. On the Select Features page, choose the services to be installed, and then click Next. Possible choices are as follows: ScriptWriter. Installs the Scriptwriter Service. This is installed automatically if you install the Accessories Service. Interview Service. Installs the Interview Service. Web Service. Installs the Web Service. Accessories. Installs the Accessories Service, including DimensionNet.
1/15/2008
Installation Instructions
Page 48 of 142
WebCATI. Installs the WebCATI Service. The Choose Destination Location page allows you to specify the folder that you want to create for storing the project files that the Interview Services use for running interviews. (When a scriptwriter activates a project, the activation program copies the questionnaire file and the templates into the Projects folder so that they are available for interviewing.) The default is C:\Program Files\SPSS Dimensions\mrInterview\Projects. If you are installing mrInterview with Quancept Support you will also be able to create a folder in which source files for desktop applications can be stored. The default for this folder is c:\mrInterviewSource. Click Next to continue. Typical and Custom Installations The Start Copying Files page displays details about what will be installed and where. If this is correct, click Next. If not, click Back and step back through the pages to make the necessary changes. Reboot the computer if prompted to do so. Perform the post-installation tasks. mrInterview with Quancept Support mrInterview with Quancept Support has its own installation procedure that is very similar to the main mrInterview installation procedure. To install mrInterview with Quancept Support, proceed as follows: On the installation CD, navigate to the mrInterview4.5Q folder and double click setup.exe. Repeat all the steps you have just carried out for the main mrInterview installation. Locate the back up of the Gcc folder that you made before uninstalling the previous version of mrInterview, and copy it into C:\Program Files\SPSS Dimensions\mrInterview. Make sure the folder is called Gcc. To complete the installation, you now need to perform the additional post-installation tasks for mrInterview with Quancept Support. Related Topics
Installing the Scriptwriter Service Cluster Installation Previous Next
1/15/2008
Installation Instructions
Page 49 of 142
Set up users and roles in DimensionNet and assign roles to DimensionNet applications On Accessories servers running Windows XP Service Pack 2, add the ASPNET account to the Launch permissions on LogBck02 If you have installed onto a machine on which mrStudio is installed, add mrStudio users to the Dimensions group on that machine so that they have access to the log file folder If you have installed the Web Service on machines that have multiple IP addresses and web sites configured for each IP address, replace the Web Service machine names with IP addresses in DPM and reregister the Interview Service machines If you have Web servers that are accessed through the internet, replace the machine name in certain URLs with the fully qualified machine name If your site uses SSL, cancel the requirement for mrIEngWS to use a secure channel Things You Must Do If They Are Not Done Automatically Register the Interview Service machines with the Web Service machines Start mrUserAdminServer and mrDPMServer3 if they are not already running Check that access permissions are set correctly for FMRoot and all its subfolders Optional Tasks If you have projects that were activated using mrInterview 3.5 or earlier and you want to continue using those projects without reactivating, move the project folders from SPSS MR\mrInterview\Projects into SPSS Dimensions\mrInterview\Projects If you are upgrading from an earlier version of mrInterview, delete the Signal return code from DPM. Add indexes to any existing sample tables to improve performance If your site uses telephone interviewing, increase the size of the appRequestQueueLimit setting for the .NET Framework. If your site uses telephone interviewing, change the thread configuration settings for the interviewing engine and the .NET Framework to avoid requests beings queued due to blocked thread pools. Install the Load Tool Configure the DimensionNet Email activity Increase the number and/or size of the log files Create a hosts file that will allow mrInterview services to communicate across a firewall Set up your Web site to use SSL Set up DimensionNet load balancing to specify the machines on which mrInterview and its applications will run Change the Interview Engine load balancing algorithm used to distribute interviews to the Interview Service machines In cluster installations, modify the TCP/IP registry settings on machines running the Interview and Web Services If you are using SQL Server 2000 or 2005 and a named instance, edit SampleMgtGUI.Config.xml to control the servers available to the Participants and Activate activities Install the Dimensions Development Library Things You Must Do on Local Machines If scriptwriters will be using Scriptwriter Station and logging in as anyone other than the Installing User, add DCOM permissions for the machine's Users group to LogBckO2 on those users' machines If interviewers will want to use modems to dial numbers, install the CATI Components on those users' machines If Phone Reports users will need to create charts, enable the charting facility Enable pop-ups and file downloads for mrInterview Set up automatic NT login for DimensionNet users who use the Firefox browser For users who will run DimensionNet using the Firefox browser on the WYSE 5150SE, increase the default font size in Firefox Related Topics
Pre-Installation Checklist for the Professional Installation Procedure Types of Professional Installation Previous Next
1/15/2008
Installation Instructions
Page 50 of 142
If you have installed the Web Service on machines that have multiple IP addresses and web sites configured for each IP address, replace the Web Service machine names with IP addresses in DPM and reregister the Interview Service machines If you have Web servers that are accessed through the internet, replace the machine name in certain URLs with the fully qualified machine name If your site uses SSL, cancel the requirement for mrIEngWS to use a secure channel
Previous Next
Setting Up the Image Cache on Web Service Machines without Direct Access to FMRoot
When the Web server cannot access FMRoot you need to configure the Web server's image cache application to connect to the Accessories server's image cache application, which in turn goes to the FMRoot folder and selects images from the project folders. Perform the following steps on all machines running the Web Service: On each Web Service machine, open Windows Explorer and browse to \Inetpub\wwwroot\SPSSMR\ImageCache. Remove the Read-Only properties on the Web.config file and then open the file. In the <appSettings> section, locate the line that defines the BASE_LOCATION key and change the key's value so that it points to the Accessories server: <add key"BASE_LOCATION" value="http://AccServer/SPSSMR/ImageCache/ImageCache.aspx"> Locate the line <add key="IS_REMOTE" value="false"/> and change the value from false to true. Save and close the file. Depending on the way your system is configured, you may also need to change some settings in Web.config in c:\Program Files\SPSSMR\mrInterview\Server\mrIWeb. The file contains two settings to do with the Image Cache. ImageCacheURL. Defines the URL that the respondent's browser will use to reference the image cache on the Web tier. <appSettings> <add key="ImageCacheURL" value="http://WebServer/SPSSMR/ImageCache/ImageCache.aspx"/> </appSettings> This URL needs to be accessible from a machine outside the Web tier that is, on a machine other than the one on which respondents will take surveys. You can test this by opening a browser on a machine that represents your respondents' machines and accessing this URL. LocalImageCacheURL. Used only if the local machine cannot access the ImageCacheURL when run locally. <appSettings> <add key="LocalImageCacheURL" value="http://localhost/SPSSMR/ImageCache/ImageCache.aspx"/> </appSettings> The LocalImageCacheURL must be accessible from the local machine. You can test this by opening a browser on the Web server and accessing the URL. If the URL set by the installer cannot be accessed from the local machine you may need to replace the machine name with a fully qualified domain name or an IP address. Browse to C:\Program Files\SPSSMR\mrInterview\Server\mrIWeb. Remove the Read-Only properties on the Web.config file and then open the file. Make whatever changes are necessary to ImageCacheURL and LocalImageCacheURL. Save and close the file. Stop and restart IIS to implement the changes. If you are running Windows 2003, you can stop and restart the mrInterview application pool (usually SPSSmrInterviewPool) rather than restarting IIS if you prefer. This has the advantage of not affecting any other applications that may be using IIS. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 51 of 142
Adding Users Adding Roles Assigning Activities to Roles Post-Installation Checklist for the Professional Installation Procedure Previous Next
Adding Users
Choose Tools Manage Users The Manage Users activity starts. In the User Roles tree, click Users. A list of current user names appears on the right of the screen. On the right of the screen, click add new user. The UserInfo dialog box appears. Complete the fields in the dialog box and click OK to create the new account. Related Topics
Adding Roles Assigning Activities to Roles Setting Up DimensionNet Users, Roles, and Permissions Previous Next
Adding Roles
Choose Tools Manage Users The Manage Users activity starts. In the User Roles tree, click Roles. A list of current role names appears on the right of the screen. In this frame click add new role. This opens the SPSS Manage Users dialog box. Complete the fields in the dialog box and click OK. On the next dialog box, select the users who will be members of this role. Click OK to create the role with the selected users as members. Related Topics
Adding Users Assigning Activities to Roles Setting Up DimensionNet Users, Roles, and Permissions Previous Next
1/15/2008
Installation Instructions
Page 52 of 142
This opens the SPSS Manage Access dialog box. Choose the roles you want to assign to this activity and click OK. If the activity has features, a second dialog box is displayed. Select the features that should be accessible to the users you have just added. Click OK to assign the features to the role. Related Topics
Adding Users Adding Roles Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 53 of 142
This opens the group's Properties dialog box. Click Add. This opens the Users or Groups dialog box. In the list of names, choose the names of the users you want to add to the group and click Add. Click OK to close the Users or Groups dialog box. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 54 of 142
This displays the property's value in the lower right-hand frame. In the lower right-hand frame, replace the machine name with the fully qualified machine name and click Apply. This updates the entry in the upper right-hand frame. If the Web Service cannot communicate with the Interviewing Engine Service using a basic machine name, update the DefaultCluster property as follows: In the left-hand frame click the Clusters entry. In the DefaultCluster property, replace the value of WEBSERVERLIST with a fully qualified domain name, for example: DBSERVER&=&MyDbServer&;&DBDRIVER&=&SQL Server&;&IVSERVERLIST&=&MyIntServer&;&WEBSERVERLIST&=&ServerName.DomainName.com&;&CONNECTIONSDATABASE&=&Provider=SQLOLEDB;Integrated Security=SSPI;Initial Catalog=mrInterviewData;Data Source=MyServerName; Close DPM Explorer. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 55 of 142
To correct the ACL for this folder, click OK as directed. Select the entry for the Dimensions group and check that it has Full Control for the current folder. If not, set this permission and click OK. If you want further information about the Windows problem, refer to http://support.microsoft.com/?id=834721 and http://support.microsoft.com/default.aspx?scid=kb;en-us;322293 Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
Optional Tasks
If you have projects that were activated using mrInterview 3.5 or earlier and you want to continue using those projects without reactivating, move the project folders from SPSS MR\mrInterview\Projects into SPSS Dimensions\mrInterview\Projects If you are upgrading from an earlier version of mrInterview, delete the Signal return code from DPM. Add indexes to any existing sample tables to improve performance If your site uses telephone interviewing, increase the size of the appRequestQueueLimit setting for the .NET Framework. If your site uses telephone interviewing, change the thread configuration settings for the interviewing engine and the .NET Framework to avoid requests beings queued due to blocked thread pools. Install the Load Tool Configure the DimensionNet Email activity Increase the number and/or size of the log files Create a hosts file that will allow mrInterview services to communicate across a firewall Set up your Web site to use SSL
1/15/2008
Installation Instructions
Page 56 of 142
Set up DimensionNet load balancing to specify the machines on which mrInterview and its applications will run Change the Interview Engine load balancing algorithm used to distribute interviews to the Interview Service machines In cluster installations, modify the TCP/IP registry settings on machines running the Interview and Web Services If you are using SQL Server 2000 or 2005 and a named instance, edit SampleMgtGUI.Config.xml to control the servers available to the Participants and Activate activities Install the Dimensions Development Library
Previous Next
1/15/2008
Installation Instructions
Page 57 of 142
You can also use these instructions as guidelines if you want to index new fields that you add to sample tables. Start the SQL query analyzer as follows: If you are using SQL Server 2005, open SQL Server 2005 Management Studio and select the New Query feature. If you are using any other version of SQL Server, from the Start menu, choose: Programs Microsoft SQL Server Query Analyzer Connect to your mrInterview database server. In the drop-down list of databases, select the sample database whose table or tables you want to index. In the Query window, type the following commands. You will need to repeat the commands for each sample table you have created manually. For tables that are used for Web (inbound) and/or telephone interviewing (outbound) projects: CREATE NONCLUSTERED INDEX Name_idx_id_active CREATE NONCLUSTERED INDEX Name_idx_queue CREATE NONCLUSTERED INDEX Name_idx_active ON TableName (Id, Active) ON TableName (Queue) ON TableName (Active)
Tables that are used for telephone interviewing projects need the following additional indexes: CREATE CREATE CREATE CREATE CREATE NONCLUSTERED NONCLUSTERED NONCLUSTERED NONCLUSTERED NONCLUSTERED INDEX INDEX INDEX INDEX INDEX Name_idx_appttime Participants_idx_recalltime Participants_idx_trycount Participants_idx_appttrycount Participants_idx_sortid ON ON ON ON ON TableName (AppointmentTime) SampleTableName (RecallTime) SampleTableName (TryCount) SampleTableName (AppointmentTryCount) SampleTableName (SortId)
If you also wish to index the associated history tables, type the following for each history table in the database: CONSTRAINT Participants_ProjectName_HistoryTable_pk PRIMARY KEY CLUSTERED (Id) CREATE NONCLUSTERED INDEX Participants_ProjectName_HistoryTable_idx ON SampleTableName (SampleId) CREATE NONCLUSTERED INDEX Participants_ProjectName_HistoryTable_idx_starttime ON SampleTableName (StartTime) Press F5 or click Execute Query (the green triangle). If you have sample tables in more than one database, select the next database from the drop-down list and repeat these commands for the tables in that database. Save your changes and exit. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
Changing Thread Configuration Settings for the Interviewing Engine and the .NET Framework
This topic applies only to sites that run telephone interviews. When a telephone interviewer requests a number to call, the Phone activity requests one from the sample management system. If the system does not have enough resources allocated for dealing with these requests, the requests will be queued and interviewers will have to wait longer than necessary to receive numbers. You can reduce the likelihood that this will happen by increasing the resources available for processing requests. Make the following changes on each machine running the Interviewing Service. From the Windows Start menu, choose Run. In the Run dialog box, type regedit and click OK. Step down through the hierarchy to HKEY_LOCAL_MACHINE\SOFTWARE\SPSS\mrInterview\3\Interviewing.
1/15/2008
Installation Instructions
Page 58 of 142
Right-click in the right-hand frame, select New, DWORD value, and enter DefaultThreadPoolSize as the value name. Right-click this new entry and select Modify. In the Edit DWORD Value dialog box, type 100 as the value and choose Decimal as the base. Click OK to save your changes. Close Registry Editor. Navigate to c:\Windows\Microsoft.Net\Framework\v2.0.50727\CONFIG and open machine.config. In the <system.web> section, add the following settings or edit your existing settings so that they contain the designated properties and values. <system.web> <httpRuntime minFreeThreads="88" minLocalRequestFreeThreads="76" /> <processModel autoConfig="false" maxWorkerThreads="100" maxIoThreads="100" /> </system.web> In the <system.net> section, add the following settings or edit your existing settings so that they contain the designated properties and values. <system.net> <connectionManagement> <add address="*" maxconnection="100"/> </connectionManagement> </system.net> Save your changes and close the file. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 59 of 142
If the properties are not present, choose: Add Property and enter the property's name and value in the dialog box displayed. Close DPM Explorer. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 60 of 142
On the Directory Security tab, click Server Certificate. This starts the IIS Certificate Wizard. On the Welcome page, click Next. On the Server Certificate page, select Create a new certificate and click Next. On the Delayed or Immediate Request page, click Prepare the request now, but send it later and click Next. On the Name and Security Settings page, enter the name of your web site. (You can enter any name you like here, but it is a good idea to enter a name that can be recognized later.) Click Next. On the Organization Information page, enter SPSS or a name of your choice in both fields and then click Next. The Your Site's Common Name page should show the correct computer name for the chosen web site, so click Next to continue. On the Geographical Information page, complete the fields as appropriate. Click Next on all other pages until you reach the end of the wizard. Then click Finish to return to the Web Site Properties dialog box. In the Secure communications frame, click Edit. This opens the Secure Communications dialog box. Select Require secure channel (SSL) and click OK. Close IIS. The certificate used for SSL must be trusted on the local machine. To check this, proceed as follows: Open Internet Explorer and select: Tools Internet Options On the Content tab click Certificates. On the Certificates dialog box, select the Trusted Root Certification Authorities tab and check that the certificate for SSL appears in the list. If the certificate does not appear in the list, click Import to run the Certificate Import wizard which will add the certificate to the list. Close Internet Explorer. Follow the instructions in Cancelling the Requirement for mrIEngWS to use a Secure Channel If your SSL certificate is assigned to a fully qualified domain name, change the value of the LocalImageCacheURL setting in the Web Service's Web.config file so that it uses the fully qualified domain name. Perform the following steps on all machines running the Web Service. In Windows Explorer, navigate to C:\Program Files\SPSS Dimensions\mrInterview\Server\mrIWeb and open Web.config using Visual Studio or a text editor. Change the entry for LocalImageCache so that it reads something like: <add key="LocalImageCacheURL"value="https://www.FQDomainName.com/SPSSMR/ImageCache/ImageCache.aspx"/> Save the change and close the file. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 61 of 142
On the LoadMonitoring tag, optionally change the value of ReportExpireTime if you want to increase or decrease the amount of time that may elapse between reports from a server before that server is removed from the list of available servers. Save your changes and close the file. For each application that you are load balancing, browse to its source folder in \Inetpub\wwwroot\SPSSMR and do the following. Right-click Web.config and select Properties. Cancel the Read-only attribute and click OK. Edit Web.config using a text editor such as Notepad and add the following statements to the end of the file: <appSettings> <add key="SPSS_LoadBalance_Application" value="appname" /> <add key="SPSS_LoadBalanceXmlFile" value="drive:\Inetpub\wwwroot\SPSSMR\Shared\LoadBalancingConfiguration.xml" /> </appSettings> In this code segment, appname is the name of the application, and drive is the drive letter on which the load balancing configuration file is installed. Note: The Web.config files for DimensionNet and mrTables already have an appSettings segment naming the load balancing configuration file so for these applications you will just need to add the tag defining the application's name. For other applications you will need to add the whole segment. Repeat all of these steps for the configuration files and Web.config files on the other machines in the cluster, including any machines on which mrTables is installed. If the load balancing service is not running on a machine, start it as follows. Open Control Panel and choose: Administrative Tools Services On the Services dialog box, right-click mrLoadBalanceService and choose Start. Sites Using SSL Accelerators If your site uses SSL accelerators and you want to run DimensionNet load balancing, perform the following steps on all machines running the Accessories service, in addition to the previous steps. Navigate to C:\InetPub\wwwroot\SPSSMR\Shared and open LoadBalancingConfiguration.xml using a text editor such as Notepad. In each <Application> section inside the <LoadReporting> element, update the value of applicationpath so that it shows the server's public URL. For example: <LoadReporting> <Application name="dimensionnet" applicationpool="SPSSDimensionNetPool" ReportingInterval="1000" protocoltype="TCP" applicationpath="https://localhost/SPSSMR/DimensionNet/Default.aspx"> ... </Application> </LoadReporting> Stop and restart the Load Balancing service. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 62 of 142
In cluster installations, if the Interview or Web servers run out of available ports, interviews will fail. An indication that a server is failing because of insufficient available socket ports is the following message in the IVW logs: Error calling WS method 'Method'. URL 'URL', Error codes: Client 5, HTTP -1, SOAP 0, TCP 10048 You can prevent this from happening by changing either of the following settings for TCP/IP in the registry: Increase the port range that is used for anonymous ports to approximately 20000 ports (for example) by modifying the MaxUserPort registry key. Change the connection time-out set in TcpTimedWaitDelay from the default 240 seconds to anything from 30 to 300 seconds. To Increase the Port Range From the Start menu, select Run. In the Open box, type regedit and click OK. This opens the Registry Editor. In the left-hand frame, navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters. In the right-hand frame, right-click on MaxUserPort and choose Modify. In the Edit DWord Value dialog box, enter the new value, for example, 65534. Close the Registry Editor. To Change the Connection Time-out From the Start menu, select Run. In the Open box, type regedit and click OK. This opens the Registry Editor. In the left-hand frame, navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters. In the right-hand frame, right-click on TcpTimedWaitDelay and choose Modify. In the Edit DWord Value dialog box, enter the new value, for example, 300 (decimal). Close the Registry Editor. You must reboot your machine before the changes take effect. For further information, see Microsoft Knowledge Base Article 319502 at http://support.microsoft.com/kb/319502/en-us/. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 63 of 142
The DimensionNet section includes the following topics. Security. DimensionNet and mrTables load balancing. Wizards and the DimensionNet Application Framework for building your own DimensionNet applications. Distributed Property Management (DPM) and DPM Explorer. File management. Files that control how DimensionNet works. Object models. The mrInterview section includes the following topics. The function of and interaction between mrInterview components. Procedures for starting and stopping interviews, time-outs, and activation. Database tables. Log files. Sample Management. The Project Cache. The Image Cache. Interview Engine load balancing. Object models. The DDL is included on the mrInterview installation CD. Take the following steps to install it. From the mrInterview Installer window, choose Browse the CD-ROM. Browse to the DDL folder. Double-click DDL_Installation_Guide.chm, which provides step-by-step instructions. Double-click Autoplay.exe to start the installation. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 64 of 142
Select the Security tab. In the Access Permissions frame click Edit. This opens the Launch Permissions dialog box. Click Add. This opens the Select Users, Computers or Groups dialog box. In "Enter the object names to select", type MachineName\Users, where MachineName is the name of the scriptwriter's machine. Click OK to save the change and then close dcomcnfg. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 65 of 142
Enabling Access to Charting for Users and Roles After running the chart configuration program, you can enable access to charting for users in a particular role, so that only correctly licensed users are able to access it. You may find that you need to create a separate role for these users. See Adding Roles for more information. In DimensionNet, choose Tools Manage Access The Manage Access activity starts. In the tree frame, expand Activities. Expand the Phone activity, and expand Features. Select the Can display charts feature. A frame appears on the right of the page listing the roles currently assigned to this feature. Click assign role(s). This opens the SPSS Manage Access dialog box. Choose the roles you want to assign to the feature and click OK. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
1/15/2008
Installation Instructions
Page 66 of 142
The default font settings in the Firefox browser produce very small text in DimensionNet when used on Wyse 5150SE terminals. You will probably want to change these settings to make the DimensionNet text more readable. Suggested settings are as follows:
Proportional Serif Sans-serif Monospace Luxi Sans Serif, 15 pixels Luxi Sans Luxi Sans 13 pixels
In Firefox, select Edit Preferences Fonts & Colors Make whatever font changes you think are necessary to produce readable text. Related Topics
Post-Installation Checklist for the Professional Installation Procedure Previous Next
Replacing the Machine Name in the InterviewURL Property with the Fully Qualified Machine Name
If you have Web servers that are accessed through the internet, you will need to replace the machine name in the InterviewURL site property with the fully qualified machine name. For example, you might replace the server name olympus with olympus.spss.com. In Windows Explorer, navigate to C:\Program Files\SPSS Dimensions\DDL\Code\Tools\VB.NET\DPM Explorer.Net and double click DPMExplorer.exe. This opens the DPM Explorer window. In the left-hand frame expand the main site entry and click the Properties entry. A list of site properties is displayed in the upper right-hand frame. Click InterviewURL. This displays the property's value in the lower right-hand frame. In the lower right-hand frame, replace the machine name with the fully qualified machine name and click Apply. This updates the entry in the upper right-hand frame. Close DPM Explorer. Related Topics
Additional Post-Installation Tasks for Quancept Support in mrInterview 4.5
1/15/2008
Installation Instructions
Page 67 of 142
Previous
Next
Making the Interview Engine Performance Counters Visible to Performance Monitoring Utilities
This task is necessary only if your regional settings (Locale) do not match the native regional settings of the operating system. If you install mrInterview while your regional settings (Locale) do not match the native regional settings of the operating system, a problem with the Microsoft registration code for performance counters prevents the performance counters exposed by the Interview Engine from being visible in PerfMon and other performance monitoring utilities. Take the following steps to make the counters visible. Open a command prompt. Change directory to C:\Program Files\SPSS Dimensions\mrInterview\Server. Type: regsvr32 /u mrEnginePerf.dll Type: net stop mrengine In Control Panel, open Regional and Language Options. On the Regional Options tab, select the language of your operating system from the drop-down list of languages. For example, if your operating system language is English (United States) then you should set your regional settings to some variant of English; if your operating system language is French
1/15/2008
Installation Instructions
Page 68 of 142
(France) then you should set your regional settings to some variation of French. Log off and then log on again as the same user. There is no need to reboot between logging off and logging on. Open a command prompt. Change directory to C:\Program Files\SPSS Dimensions\mrInterview\Server. Type: regsvr32 mrEnginePerf.dll Type: net start mrengine Reopen Regional and Language Options and on the Regional Options tab reset your locale to its previous setting. Related Topics
Additional Post-Installation Tasks for Quancept Support in mrInterview 4.5 Previous Next
1/15/2008
Installation Instructions
Page 69 of 142
Additional Post-Installation Tasks for Quancept Support in mrInterview 4.5 Previous Next
1/15/2008
Installation Instructions
Page 70 of 142
Click OK. Repeat these steps for mrNodesManager. Note: Changing the Endpoints protocol can delete the user passwords for mrEngine and mrNodesManager. If you make these changes and then find that mrEngine and/or mrNodesManager do not start due to a logon failure, you may need to reenter the user password for these programs. To reinstate the password, do the following: From the Windows Start menu, choose Run. In the Run dialog box, type dcomcnfg On the Applications tab select mrEngine (or mrNodesManager) and click Properties. The Properties dialog box opens. Click the Identity tab. In Password, type the password of the user whose name is shown in the User box. In Confirm Password, retype the password. Click OK. Related Topics
Additional Post-Installation Tasks for Quancept Support in mrInterview 4.5 Previous Next
1/15/2008
Installation Instructions
Page 71 of 142
your local network, but not when your are using your laptop in standalone mode. The problems you will encounter are as follows: UNC pathnames are not resolved, so applications cannot access the FMRoot folder. Domain user accounts cannot be authenticated. The recommended procedure for installing mrInterview when you want to work attached to a network or off-line is to install mrInterview Standard, or to install a single machine workgroup version of mrInterview Professional and then carry out the following post-installation tasks: Navigate to C:\Program Files\SPSS Dimensions\DDL\Code\Tools\VB.Net\DPMExplorer.Net and double-click DPMExplorer.exe. In the left-hand frame, click Properties. In the upper right-hand frame, click FileMgt_RootFolderUNC. The property's value is displayed in the lower right-hand frame. In the lower right-hand frame, replace the pathname with C:\Program Files\SPSS Dimensions\mrInterview\FMRoot. Select InterviewCacheUNC and replace the pathname with C:\Program Files\SPSS Dimensions\mrInterview\FMRoot\Interview\Cache. Select Brad_Backup_UNC and replace the pathname with C:\Program Files\SPSS Dimensions\mrInterview\FMRoot\Shared\Backup. Click Apply and close DPM Explorer To be able to access images held in the image cache, edit the file \InetPub\wwwroot\SPSSMR\ImageCache\Web.Config and change the setting of the BASE_LOCATION key so that it points to the Master folder: <AppSettings> <add key="BASE_LOCATION" value="C:\Program Files\SPSS Dimensions\mrInterview\FMRoot\Master" /> </AppSettings> Log in to DimensionNet using the DPM Administrator account that you specified during installation. If you want to be able to log into DimensionNet using a user name other than that of the DPM administrator, start Manage Users and add this user. Make the user a member of the DPMAdmins role to ensure that the user has unrestricted access to all applications, application features, and files. Open the Services Manager and stop the Load Balancing service if it is running. The Load Balancing service is used for clustering the Accessories servers and is not necessary for a single machine. If you try to start DimensionNet and your URL changes to http://server1/... then you know that the Load Balancing service is running. Related Topics
Improving Stability when Running DimensionNet Off-line Previous Next
1/15/2008
Installation Instructions
Page 72 of 142
Maintenance Checklist
This section describes tasks that you may need to carry out periodically once you have been running mrInterview. It includes: Restarting all machines in a cluster. Adding a new interviewing server to an existing cluster Adding additional Interview Session Engines to an Interview Server Updating passwords for the mrInterview Running and Anonymous Access Users Deleting or truncating SQL log files Updating mrInterview settings after changing the web site port number Changing interviewing URLs and registration passwords if your site switches to using SSL Recycling application pools (applicable to IIS6 running on Windows 2003) mrInterview with Quancept Support Adding a new interviewing server to an existing Quancept Support cluster Cleaning the Connections table Changing the interviewing URL if your site switches to using SSL
Previous Next
1/15/2008
Installation Instructions
Page 73 of 142
This allows you to activate projects on the server while ensuring that the server does not start interviews. If you start the Interview Engine at this point, the Web server will try to send interviews to the new server, but because the .mdd file does not exist on that server, respondents will be redirected to another server in the cluster. Copy the folders for active jobs from the File Management folder (FMRoot\Master) into the new server's Projects folder. At a command prompt, type RegIntSvr /e to register and enable the interviewing server. Related Topics
Maintenance Checklist Previous Next
1/15/2008
Installation Instructions
Page 74 of 142
LocalEngineURLs='http://intserver1/mrIEngWS','http://intserver1/mrIEngWS2' Open a command prompt, change directory to C:\Program Files\SPSS Dimensions\mrInterview\Server, and run RegIntSvr.exe to register the new engine with the Web server. On the Web server, navigate to C:\Program Files\SPSS Dimensions\mrInterview\Server\mrIWeb and open RegisteredEngines.xml. This will show you a list of all registered, unregistered and failed engines. Properties for the new session engine are added to DPM and can be viewed in DPMExplorer by expanding the Cluster properties entry. When an interview starts, you will see one w3wp process in Task Manager for each session engine that is running. Making the Session Engines Available to the Phone Participants and Review Interviews Activities All Dimensions telephone interviewing and interview reviewing sessions have access to the default session engine (usually C:\Program Files\SPSS Dimensions\mrInterview\Server\mrIEngWS\mrIEngWS.dll) and to any other interview session engines named in the Phone Participants or Review Interviews Web.config files. To name alternate engines, do the following: Navigate to c:\InetPub\wwwroot\SPSSMR\CatiInt and open the Web.config file. Add the following definition to the < appSettings> section: <add key="ALTERNATE_INTERVIEW_ENGINES" value="engine_names"/> where engine_names is a comma-separated list of the URLs of interview engines. For example: <add key="ALTERNATE_INTERVIEW_ENGINES" value=" http://redserver/mriengws2, http://redserver/mriengws, http://blueserver/mriengws2"/> Save your changes and close the file. Repeat these steps for the Web.config file in c:\InetPub\wwwroot\SPSSMR\ReviewInterview.
Previous Next
1/15/2008
Installation Instructions
Page 75 of 142
1/15/2008
Installation Instructions
Page 76 of 142
Save your changes and close the file. Run regedit and navigate to HKEY_LOCAL_MACHINE\SOFTWARE\SPSS\mrInterview\3\Interviewing\. Change the value of the RegistrationPW setting so that it matches the password you have just defined in the Web.config file. Save your changes and close regedit. Related Topics
Maintenance Checklist Previous Next
Adding a New Interviewing Server to an Existing Cluster (mrInterview with Quancept Support)
To add a new Interviewing Server to an existing cluster with live respondents, without disrupting the service for respondents currently taking surveys, follow the steps listed below (this is a general overview, not a detailed set of instructions). Go through the pre-installation checklist for the new server. Make a back-up copy of mrInterviewSitePrep.ini from the original installation and also of key areas of your system such as FMRoot and mrInterview\Projects. Edit mrInterviewSitePrep.ini from the original installation to reflect the new servers you want to add, as follows: Increment the value of InterviewServer as appropriate. Add a new InterviewServern entry to the [InterviewServer] section giving the name, port, and protocol to be used for communicating with this server. Double check mrInterviewSitePrep.ini to verify its accuracy. Go to the mrInterviewSiteInstallation folder and run the installation program from there. Navigate to C:\Program Files\SPSS Dimensions\DDL\Code\Tools\VB.Net\DPMExplorer.Net and double-click DPMExplorer.exe. In the left-hand frame, click Clusters. In the upper right-hand frame, click DefaultCluster. The property's value is displayed in the lower right-hand frame. In the lower right-hand frame, add the name of the new interviewing server to the IVServerList variable (names must be separated with semicolons) and click Apply. Close DPM Explorer
1/15/2008
Installation Instructions
Page 77 of 142
On the original interviewing server, do the following: Navigate to C:\Program Files\Common Files\SPSS Dimensions\ProjectMgmt and edit pm.ini. Add the name of the new interviewing server to the IVServerList variable (names must be separated by semicolons). Open a command prompt and navigate to C:\Program Files\Common Files\SPSS Dimensions\ProjectMgmt. Type pmsetup. Disable mrEngine on the new server. This allows you to activate projects on the server while ensuring that the server does not start interviews. If you start mrEngine at this point, the Web server will try to send interviews to the new server, but because the .mdd file does not exist on that server, respondents will be redirected to another server in the cluster. Follow the post-installation checklist but ignore any instructions to start or enable mrEngine. Copy the folders for active jobs from the File Management folder (FMRoot\Master) into the new server's Projects folder. Start mrEngine on the new server. Related Topics
Maintenance Checklist Previous Next
Repairing an Installation
Log on with the user name that you created for installing mrInterview. In Windows Explorer, browse to the network directory in which the site preparation file was created and double-click autoplay.exe.
1/15/2008
Installation Instructions
Page 78 of 142
This opens the SPSS mrInterview Installer window. From the SPSS mrInterview Installer window, choose Install mrInterview 4.5. This starts the SPSS mrInterview Setup wizard. On the Welcome page, click Repair and then click Next. The Setup Status page reports the repair's progress. When the repair has finished, click Finish. Related Topics
Modifying, Repairing, or Removing Your Installation Previous Next
Removing mrInterview
To remove mrInterview, use the uninstall feature. If you simply delete the files and folders associated with the product, the application is not properly removed and you may have problems installing or removing later versions. After you installed mrInterview, you may have changed some of the files that control how DimensionNet or mrInterview works. To save you having to make the same changes when you reinstall mrInterview, the removal procedure backs up key files so that you can copy them back to their original locations after a reinstall. Files are backed up to \Program Files\SPSSMR\Backup\SPSS DimensionNet version_date_time; for example, SPSS DimensionNet 2.3_10.15.2004_13.59.20. Inside this folder are subfolders containing files from various locations within \Program Files and the IIS Web site folder. Files that are backed up typically include the following: Web.config files for DimensionNet activities Web.config files for mrInterview activities ProjectMgmt\pm.ini. SampleMgt.GUI.Config.xml The load balancing script files defaultreport.mrs and defaultload.mrs Note: If you have mrInterview with Quancept Support installed, you will need to uninstall the Quancept support option separately from the main mrInterview application. To Remove mrInterview Log on with the user that you created for installing mrInterview. Open Control Panel and choose Add/Remove Programs. Choose SPSS mrInterview 4.5. Click Add/Remove or Change/Remove. This starts the SPSS mrInterview Setup wizard. On the Welcome page, choose Remove and then click Next. Confirm your request when prompted to do so. On the Maintenance Complete page, click Finish. Reboot when prompted to do so. (If you do not reboot you will not be able to reinstall mrInterview.) Related Topics
Modifying, Repairing, or Removing Your Installation Previous Next
1/15/2008
Installation Instructions
Page 79 of 142
The folder in which I created the site preparation file is not visible from the machines named in the site preparation file.
Check that you have shared the folder and that you have assigned permissions for the Installing User and the Dimensions Group. See Creating the Site Preparation File and Folder for more information.
Previous Next
The installation program fails with the message 'Error 1608: Unable to create InstallDriver instance'
This is an InstallShield problem that can happen for the following reasons: The Client for Microsoft Networks networking protocol is not installed on the machine on which you are trying to install mrInterview. If this is part of your company's security policy, install the protocol temporarily so that you can install mrInterview and then uninstall it. The dcomcnfg default security settings do not include the Installing User under the Launch and/or Default Access permissions. To set the necessary permissions, do the following: Run dcomcnfg. On the Default Security tab, click Edit Default in the Default Launch Permissions section. Add the Installing User. If necessary, make the same change in the Default Access Permissions section. Click OK.
Previous Next
I've installed a new version of mrInterview and get errors when I try to select things from the menus in DimensionNet
When you run applications from your browser, the browser maintains a number of temporary files that help it to keep track of what you have done and to run the application as efficiently as possible. Sometimes, when you install and run a different version of an application, your browser attempts to reuse the information in the temporary files. If this no longer matches the way the application works, errors will occur. You can solve this problem easily by deleting the temporary files. Open your browser and select Tools Internet Options In Temporary Internet Files, click Delete Files. Confirm your request when prompted to do so.
Previous Next
1/15/2008
Installation Instructions
Page 80 of 142
I can log in to DimensionNet if I enter the URL as //localhost/... but not if I enter the server's name instead of localhost
If the server name contains any characters other than letters, numbers, hyphen, and dot, you will not be able to log in to DimensionNet by specifying the server name in the URL. This is due to a limitation in Internet Explorer which prevents servers whose names contain characters other than these from setting cookies. If you want to use this server with DimensionNet and mrInterview you will either have to change its name or refer to it using its IP address.
Previous Next
Machines in the cluster can ping one another successfully but cannot see FMRoot
The standard test for ensuring that all machines in a cluster can communicate with one another is to try pinging each machine from every other machine in the cluster. If your site has increased its security by switching off Client for Microsoft Networks, then even though machines will be able to ping one another they may not be able to access FMRoot on the primary DPM server. To resolve this problem, switch on Client for Microsoft Networks on the machines on which DimensionNet and mrInterview are installed.
Previous Next
I want to check that SQL Server is running on the Database server but I cannot see the server name in the list of servers
If there is a firewall or a DMZ boundary between the Interviewing server and the Database server, you may not see the name of the Database server in the list of SQL servers displayed in the Create a New Data Source to SQL Server dialog box. Just type the name of the Database server into the Server box and the connection request will generally be allowed.
Previous Next
The location of the Web Site folder containing SPSSMR has changed since mrInterview was installed. What changes do
1/15/2008
Installation Instructions
Page 81 of 142
My site uses Microsoft ISA. Are there any changes I need to make in order to run DimensionNet?
If you have Microsoft Internet and Security Acceleration (ISA) installed, you may encounter problems if your site has machines that have different names or IP addresses depending on whether they are being accessed via an intranet or via the internet. Typically, if a user runs DimensionNet from the internet and starts an activity, DimensionNet will fail when the user ends the activity. This is because it tries to return the user to DimensionNet using the server's intranet name or IP address rather than the internet name or IP address that the user originally used. To avoid this problem, make the following changes: Open ISA and select the Action tab. Select Send the original host header to the publishing server instead of the actual one. Click OK. For further information refer to http://support.microsoft.com/?kbid=838252
Previous Next
1/15/2008
Installation Instructions
Page 82 of 142
I'm installing onto Windows XP, and the installation fails when I click Next on the mrInterviewData Database Setup page
When you click Next on the mrInterviewData Database Setup page, the installation procedure runs a script to check that it can communicate with the database server named on this page. If you are installing mrInterview on a machine running Windows XP (this is supported for demonstration machines only), you may find that the installation procedure fails at this point with the message "The procedure entry point SetFileSecurityI could not be located in the dynamic link library MSDART.DLL", regardless of the server name you enter and whether you can communicate with the server in other ways. This is due to a problem with the operating system, which you should be able to resolve by copying the msdart.dll file to be msdart32.dll. You'll find the file in c:\Windows\system32. Once you have created a copy with the new name you should be able to install mrInterview with no problems.
Previous Next
The installer says it can't find SQL server running on the machine specified
If the installation procedure issues the message "Can't find SQL server running on the machine specified." when you click Next on the mrInterviewData Database Setup page, this may be for any of the following reasons: You mistyped the server's name. The machine running the SQL Server is unreachable. Microsoft Data Access Components (MDAC) are not correctly installed. The latest Windows updates are not installed. To resolve the problem, do the following: Check that your spelling is correct and, in the case of a named SQL server instance, that you have typed the instance name correctly. Check that you can ping the machine. See Checking that Machines in a Cluster can Communicate with Each Other for more information. If MDAC are not installed, proceed as follows: Cancel the mrInterview install and select Install Microsoft Data Access Components (MDAC) 2.8 from the autoplay menu. See Installing Microsoft Data Access Components 2.8 for more information. When the MDAC installation finishes, reboot the machine. Download and install the latest Windows updates from Microsoft.com. If you are using Windows XP and the error still persists and you now see the message "The procedure entry point SetFileSecurityI could not be located in the dynamic link library MSDART.DLL", follow the instructions in I'm installing onto Windows XP, and the installation fails when I click Next on the mrInterviewData Database Setup page.
Previous Next
1/15/2008
Installation Instructions
Page 83 of 142
1/15/2008
Installation Instructions
Page 84 of 142
Check which files are present in each location. Common Files should contain only two or three files. If there are more, double check that all products have been uninstalled and, if so, delete the files. Application files will contain folders for projects and log files. Delete these. Answer Yes when asked to confirm deletion of \SPSSMR_FMRoot. Web files will contain a few temporary and cache folders. You can delete these.
This folder contains shared .NET assemblies. Delete all the Dimensions files listed in the next table. If you see the message "Assembly Cache Viewer Uninstall failed Assembly 'AboutBox.resources' could not be uninstalled because it is required by other applications", check again that there are no Dimensions programs listed under Add/Remove Programs. If not, continue with the clean-up checklist. Be very careful when editing the registry as deleting the wrong keys may break the machine.
Registry Product keys: HKEY_LOCAL_MACHINE\SOFTWARE\SPSS HKEY_CURRENT_USER\Software\SPSS Shared DLL: HKEY_LOCAL_MACHINE\SOFTWARE\ Microsoft\Windows\CurrentVersion\SharedDlls .NET Global assembly: HKEY_CLASSES_ROOT\Installer\Assemblies \Global
Delete the product keys for SPSS. Under the Shared DDL key, delete any keys that match the folder locations you deleted in the previous step; that is C:\Program Files\Common Files\SPSS Dimensions, C:\Program Files\SPSS Dimensions, and \InetPub\wwwroot\SPSSMR. In the Global Assembly section, delete only the keys whose names match those in the following table. Once you have done this, delete any Dimensions files remaining in c:\WINDOWS\assembly (see previous step). Note: You will see other Dimensions entries in the registry but they will not cause a reinstallation to fail, so there is no need to delete them.
IIS From Control Panel, select Administrative Tools, Internet Information Services. Under Application Pools you will see: SPSSDimensionNetPool SPSSmrInterviewPool Under Web Sites, Your Website you will see: SPSSMR mrIWeb mrIEngWS Services mrDPMServer3 mrLoadBalanceService mrPerfMonitoring mrUserAdminServer Dcomcnfg From the Start menu, select Start Run and type dcomcfnfg This opens the Component Services dialog. In the left-hand frame expand Component Services to show the contents of Computers, My Computer. Click DCOM Config.
The files that may be references in IIS have been deleted already, so any virtual folders or application pools remaining in IIS will be tagged with an error icon. For each application pool and virtual folder mentioned in the first column, select the folder and delete it.
You should not see any mrInterview services listed in the Services menu. If a service does remain on the machine, perhaps because it was running when the program file was delete, reboot the machine and recheck the Services menu to ensure that it is no longer there.
If the right-hand frame shows any of the following, reboot the machine and repeat this step. These items should no longer appear. Logbcko2 mrPrepro mrScriptLP mrUserAdminServer OAgent2 You may see the following Dimensions processes listed: Logbcko2 OAgent2 mrUserAdminServer mrDPMServer3 Either select each process in turn and click End Process, or reboot the machine to make sure they are removed.
This folder may contain some export files from mrTables or the Phone Reports activity. Delete any "SPSS MR mrTables ExportType Export Class" files.
Once you have completed these tasks, reboot the machine before you install another product. .NET Files Added to the Global Assembly Cache
AboutBox Interfaces ActivateClient ActivateDocument ActivateEvents ActivateServer AppLogLib BackupAndRestoreDomLib BackupAndRestoreLib CDSCLib CLEANMDMFORIVSLib DataLinkDialog DimensionNet HTMLPlayerLib ICSharpCode.SharpZipLib MRALIASMAPLib mrCacheLib MRComponentsLib mrCsvDsc mrDPMInstall mrDPMNTS MRDSCReg MRENGINELib MROLEDBLib MRPREPROLib MRPROPERTIESLib mrQdiDrsDsc mrQtSpecDsc mrRegistrar MRSAMPLEMANAGEMENTLib MRSQLSTORAGELib mrUserAuth mrUserCrypto mrWebExplorer MRWEIGHTLib ProductInfo ProgressDialog QuotaObjectModelLib SPSSMR.Data.Scripting SPSSMR.Data.Transformations SPSSMR.DataCollection.SMProvider SPSSMR.Dimensions.Windows.UI.Controls SPSSMR.DPM.Agent SPSSMR.DPM.CommonClassses SPSSMR.DPM.Interfaces
1/15/2008
Installation Instructions
Page 85 of 142
IOMLib LoadBalanceLib LogFrontLib Login ManageUserProperties MDM2QuantumLib MDMLib MDMMGRLib MDMToolsLib MDSC MEOWMONILERLib mrEngineMemoryLib MREVALUATELib MRFILEMGTLib mrIHTMLTidyLib mrInstall.net MRINTERVIEWLib MRLIBVERLib
MRSCRIPTCORELib MRSCRIPTLib MRSCRIPTLPLib mrScriptMDSCLib MRSMINTERFACESLib QUOTAPROVIDERLib QuotaRuntimeLib RAP RegIntSvrLib RemoteUtilities Scripting SPSS.Dimensions.FileManager SPSS.Configuration.Dimensions SPSS.Constants SPSS.Data.Databaseagent SPSSMR.Data.Datasource iSPSSMR.Data.Interfaces SPSSMR.Data.Participants
SPSSMR.DPM.Scripting SPSSMR.DPM.NET SPSSMR.Management.Monitoring SPSSMR.Management.Monitoring.DimensionNet SPSS.UI.Utilities.ExpressionSplitter SPSSMR.Utilities.BackupAndRestore SPSSMR.Utilities.BackupAndRestore.Dom SPSSMR.Web TomLib Upgrade_3.0 UpgradeCati_3_0 UserProperties Utilities
Related Topics
I've uninstalled mrInterview but DimensionNet is still there Next
1/15/2008
Installation Instructions
Page 86 of 142
Minimum 16-bit color quality setting. License Code Your license code, which is supplied with your Desktop Author 4.5 installation CD. This enables you to install the system that you have purchased. Related Topics
Required Software Checklist Previous Next
1/15/2008
Installation Instructions
Page 87 of 142
1/15/2008
Installation Instructions
Page 88 of 142
Description Optional. Tells DOS to wait until the command is finished before returning. Although this is optional it is useful in a silent install, as otherwise the log needs to be continually examined to find out when the install has completed. Required. Tells setup.exe to be silent. Required. Tells setup.exe to pass the following parameters to the MSI installer. Required. Tells the MSI installer to run in Quiet mode, that is, not to provide any user interface. Optional. Tells the MSI installer to log in Verbose mode to the file mylogfile. Optional. Defines the folder where you want to install Desktop Author 4.5. Not necessary if you install into the default folder C:\Program Files\SPSS Dimensions. Required. The license code supplied with your Desktop Author 4.5 CD.
Examples The following example installs Desktop Author 4.5 into the default folder without logging the install: setup.exe /s /v"/qn LICENSECODE=\"11111 11111 11111 11111 11111 11111 11111 11111\"" The following example installs Desktop Author 4.5 into the default folder and logs the installation messages to a file called C:\log.txt: setup.exe /s /v"/qn /l*v C:\log.txt LICENSECODE=\"11111 11111 11111 11111 11111 11111 11111 11111\"" The following example installs Desktop Author 4.5 into the specified folder and logs the installation messages to a file called C:\log.txt: setup.exe /s /v"/qn /l*v C:\log.txt INSTALLDIR=\"C:\MyInstallFolder\" LICENSECODE=\"11111 11111 11111 11111 11111 11111 11111 11111\""
Previous Next
1/15/2008
Installation Instructions
Page 89 of 142
Click Add/Remove or Change/Remove. This starts the SPSS Desktop Author 4.5 Setup wizard. On the Welcome page, choose Remove and then click Next. Confirm your request when prompted to do so. On the Maintenance Complete page, click Finish. Restart your computer when prompted to do so. If you do not restart you will not be able to re-install Desktop Author.
Previous Next
Description
Troubleshooting
Related Topics
Running a Logged Installation Previous
1/15/2008
Installation Instructions
Page 90 of 142
In the Print Topics window, select Print the selected heading and all subtopics and then click OK. To Print these Installation Instructions Using the Keyboard Press Alt+C to select the Contents tab. Use the arrow keys to highlight the topic called "mrTables 4.5 Installation Instructions and Configuration Notes". Press Alt+O, P to select the Options button and the Print option. In the Print Topics window, select Print the selected heading and all subtopics and then press Enter. Caution: These installation instructions contain approximately 50 pages. You can restrict the number of topics to print by selecting a lower level folder in the Contents tab. In This Section
Required Software Checklist Creating the users and the user group
Related Topics
Installation Scenarios Previous Next
1/15/2008
Installation Instructions
Page 91 of 142
Operating Systems Microsoft 2000 Professional with Service Pack 4; or Windows XP Professional with Service Pack 2; 32-bit versions required64-bit versions are not currently supported. Hardware A graphics adapter with 1024 x 768 resolution or higher. Minimum 16-bit color quality setting. CD-ROM drive required for installation. Software Microsoft Internet Explorer 6.0 or 7.0. MS XML 4.0 add-in recommended. For exports to Microsoft Word, Excel or PowerPoint, or HTML, Microsoft Office 2000, XP, 2003, or 2007. For Microsoft Office 2000 or XP, Service Pack 3 or later is required; for Microsoft Office 2003, Service Pack 2 or later is required. For viewing mrTables charts, Microsoft Office Web Components (OWC) license (version 10 or later). License Code Your license code, which is supplied with your mrTables 4.5 installation CD. This enables you to install the system that you have purchased. In This Section
Before You Start Previous Next
1/15/2008
Installation Instructions
Page 92 of 142
Related Topics
Required Software Checklist Previous Next
1/15/2008
Installation Instructions
Page 93 of 142
For further information, see the Microsoft Office XP Web Components Licensing web site http://www.microsoft.com/office/previous/xp/developer/platform/owcfaq.asp.
Previous Next
1/15/2008
Installation Instructions
Page 94 of 142
Installation Scenarios Installations onto a Domain Controller Installing mrTables Professional Previous Next
1/15/2008
Installation Instructions
Page 95 of 142
Install required software Microsoft .NET Framework 2.0 Microsoft Data Access Components 2.8 Internet Explorer 6.0 or 7.0
Create users and groups Create installing user Create running user Create anonymous access user Create mrTables group
Open ports on firewall If running mrTables through a firewall, open ports on the firewall
Post-installation Enable access to charting Set up users and roles in DimensionNet Add ASP.NET account to launch permissions on Logbck02 Allow remote access on Windows XP Service Pack 2 Check Internet Explorer settings
If installing onto a machine with mrStudio installed, add mrStudio users to the Dimensions group. If using an SSL accelerator, set up mrTables to use SSL accelerators Set up DimensionNet load balancing
1/15/2008
Installation Instructions
Page 96 of 142
Set up shared variable cache folder for load balanced systems If using Windows 2003, enable mrTables and DimensionNet load balancing between multiple IIS worker processes
Start mruserAdminServer and DPMServer3 If using SSL, configure your browser to save encrypted pages to disk
Installation Scenarios
There are several distinct mrTables installation scenarios. The installation procedure varies for each of these scenarios. Installing mrTables with mrInterview. You can install mrTables with mrInterview on a single machine using either the Standard or Professional installation, or on a cluster using the Professional Installation. When you want to install mrTables with mrInterview, you should always install mrInterview first. When installing mrInterview on a cluster, install mrInterview on all of the machines in the cluster first. You can then install mrTables on one or more machines in the cluster or on one or more other machines that will become part of the cluster. The configurations that are supported are the same as described in the mrInterview System Configurations topic in the mrInterview Installation Instructions. When you install mrTables onto an mrInterview Accessories server, the installation detects the presence of the existing DPM Server and will automatically connect mrTables to it. When you install mrTables onto a server that does not have the mrInterview Accessories service installed, you should check the Connect to an Existing mrTables or mrInterview server box on the Cluster Settings page, and when subsequently prompted, enter the names of the machines on which the DPM Server and the SQL Server are installed. Note that you cannot install mrTables onto an mrInterview Interview Service machine unless it also has the mrInterview Accessories service installed. Single-machine installation of mrTables without mrInterview. You can install mrTables without mrInterview in a single-machine installation using either the Standard or the Professional installation procedure. The Standard installation procedure installs mrTables using default parameters and is ideal for non-technical users who want a quick and easy installation procedure. It installs Microsoft Server SQL Desktop Engine (MSDE), so SQL server is not required. The Professional installation is designed for more technical users who may wish to change some of the parameters that the installation procedure uses. In a single machine Professional installation, the SQL Server can either be located on the same machine or on a different machine in the same domain or workgroup. When installing mrTables Professional without mrInterview, run the installation in the normal way, making sure you uncheck the Connect to an Existing mrTables or mrInterview server option on the Cluster Settings page. You will be prompted for the name of the SQL Server machine. Clustered installation of mrTables (without mrInterview). You can install mrTables on two or more machines in a cluster. You must always use the Professional installation procedure to do this. When you do this, SQL Server is required on only one of the machines in the cluster (this machine can optionally be a separate machine from those on which mrTables is installed). When you are installing onto machines in different domains, the domains must trust one another (that is, be bi-directional). When you install mrTables on the first machine in the cluster, make sure that you uncheck the Connect to an Existing mrTables or mrInterview server option on the Cluster Settings page. You will then be prompted for the name of the machine on which SQL Server is installed. When you install the other machines, check the Connect to an Existing mrTables or mrInterview server option on the Cluster Settings page and when subsequently prompted for the names of the DPM Server and the SQL Server, enter the names of the machine on which you installed mrTables first and the SQL Server machine. In This Section
Installing mrTables Standard Installations onto a Domain Controller Installing mrTables Professional
Related Topics
Before You Start Post-Installation Tasks Previous Next
1/15/2008
Installation Instructions
Page 97 of 142
are valid for all machines in the domain. If you are using machines in different domains, the Installing User and Running User must be visible and trusted on all those domains. Both users must also have permission to create databases on the machine hosting the Database Service. If you are installing on machines within a workgroup, the users and the group must be created on all of the machines in the workgroup. If necessary, contact your system administrator for assistance. Note: For domain installations, if you are using case-sensitive SQL you must create the Running User and the Anonymous Access User with the Full Name and Logon Name in the same case. Create a user for installing. This user will be referred to as the Installing User in the rest of this document. Optionally, create a user for running. This user will be referred to as the Running User in the rest of this document. You can use the Installing User as the Running User if you wish. Create a user that can be used for anonymous IIS access to mrTables. This user will be referred to as the Anonymous Access User in the rest of this document. Create a group for users. In This Section
Before You Start Required Software Checklist Creating the Installing and Running Users Creating the Anonymous Access User Creating the mrTables Group Previous Next
1/15/2008
Installation Instructions
Page 98 of 142
In the list of names, choose the user name you created earlier and then click Add. Click OK to close the Select Users or Groups dialog box. Click OK again to return to the Local Security Settings window. In the right-hand frame, double-click Log on as a batch job. This allows the user to run a service that itself starts another application or service. This opens the Log on as a batch job Properties dialog box. Click Add. In the list of names, choose the user name you created earlier and then click Add. Click OK to close the Select Users or Groups dialog box. Click OK again to return to the Local Security Settings window. Close the Local Security Settings window. Open your SQL administration program and grant the user DB Creator permission. For example, if you have SQL Enterprise Manager, the steps will be as follows: From the Start menu choose: Programs Microsoft SQL Server Enterprise Manager Expand the tree in the left-hand frame until the contents of the Security node are visible for the mrInterview Database server, and select Server Roles. In the right-hand frame, double-click DB Creators. This opens the Server Role Properties dialog box. Click Add. In the list of names, choose the user name you created earlier and then click OK. Click OK to close the Server Role Properties dialog box and then close Enterprise Manager. Repeat these steps, except the one to add DB Creator rights in SQL, to create the Running User account. If you are installing on machines within a workgroup, repeat these steps on each machine in the workgroup that will run mrTables so that there are identical Installing and Running Users on each of those machines. Note: Be sure to log in as the Installing User before you install mrTables. In This Section
Creating the users and the user group Creating the Anonymous Access User Creating the mrTables Group Previous Next
1/15/2008
Installation Instructions
Page 99 of 142
1/15/2008
Installation Instructions
On the License Agreement page, read the license agreement. If you accept the agreement, click Yes. On the User Information page, enter your Professional license code and click Update, then click Next. On the Cluster Settings page: If you want to connect to an existing DPM Server that is installed on another machine, check the Connect to an Existing mrTables or mrInterview server box, then enter the server name and click Next. Choose this option only if you are installing mrTables in an mrInterview cluster or you are installing the second or subsequent machine in a clustered installation without mrInterview. If you are installing the second or subsequent machine in a non-mrInterview cluster, set the server name to the name of the first mrTables machine. When you install onto a machine that has the mrInterview Accessories service installed, the installer detects the presence of the DPM Server and automatically sets up mrTables to connect to it and this page is skipped. Note that you cannot install mrTables onto an mrInterview Interview Service machine unless it also has the mrInterview Accessories service installed. If you want to install the DPM Server software that is required for running mrTables, leave the check box blank and click Next. Choose this option if you are doing a single-machine installation or if you are installing the first machine in a clustered installation without mrInterview. (If the SQL Server software is on a different machine, you will be prompted for its name later.) If you are installing the DPM Server, enter the name of your cluster (sometimes called the site) in the Site Name field on the second Cluster Settings page, and then click Next. On the Dimensions User and Group page, enter information about the user and group that should be used for running mrTables. If you have already installed mrInterview on this machine, all the fields on this page (except the Password field) will show the information entered for mrInterview. In this case you should enter the password and leave the other fields unchanged. Otherwise, if the machine on which you are installing mrTables is part of a domain, click Domain and enter the domain name in the box. If the machine is part of a workgroup or you are installing mrTables on your local machine, click Workgroup. In the Username and Password boxes, enter the name and password of the Running User. In the Group box, enter the name of the mrTables Group. Note: The names that you enter must be valid names for the domain or workgroup on which you are installing. On the Dimensions Anonymous User page, enter the details for the Anonymous Access User. If you have already installed mrInterview on this machine, all the fields on this page (except the Password field) will show the information entered for mrInterview. In this case you should enter the password and leave the other fields unchanged. Otherwise, if the machine on which you are installing mrTables is part of a domain, click Domain and enter the domain name in the box. If the machine is part of a workgroup or you are installing mrTables on your local machine, click Workgroup. In the Username and Password boxes, enter the name and password of the Anonymous Access User. On the File Management Folder page, enter the location of the root folder for the file management system. This page appears only if you chose not to connect to an existing mrTables or mrInterview server on the Cluster Settings page. On the DimensionNet Database Setup page, enter the name of the server on which to create the DPM database. This page appears only if you chose not to connect to an existing mrTables or mrInterview server on the Cluster Settings page. On the Dimensions Database page, enter the name of the server that hosts the Microsoft SQL server software. This page appears only if you chose to connect to an existing mrTables or mrInterview server on the Cluster Settings page. On the DPM User Admin Details page, enter a name and password for the DimensionNet Administrator. If mrInterview has been installed, this user will already exist and the user name will be displayed. Just enter that user's password to continue. Note: This user name is simply for accessing DimensionNet's Distributed Property Management (DPM) database to perform administrative tasks such as setting up DimensionNet users and roles, and managing access to DimensionNet files and applications. It exists only in DPM. To avoid possible conflicts with other user names, the name that you choose should not match any of the NT user names known to your system. On the Internet Information Services (IIS) Configuration page, the installation program detects any web sites available on the installation machine and displays them in the drop-down list box. If you want to use a web site other than the default for your SPSS applications, select it from the drop-down list. The default file location for the web site you have selected is displayed. If the installation program detects a folder called SPSS MR within the web site folder structure, you are prompted to install the files in this folder instead. If you want to install the files to a different location, click Browse and choose the folder you want to use. If you are installing onto a machine running the Windows 2003 operating system, the Advanced button is available for advanced configuration of your chosen website. This allows you to place DimensionNet in its own application pool so that each process can be split across multiple application pools. (The operating system places a 2Gb restriction on processes in IIS. Put simply, splitting a process across application pools means that it is possible to run larger processes. Refer to your IIS documentation for general information about application pools.) If you want to use application pools, proceed as follows: Click Advanced. This opens the Advanced IIS Configuration page. To place DimensionNet in its own application pool, select Use "SPSSDimensionNetPool" application pool. If you want processes to recycle and/or shut down after so many minutes, select the appropriate option and enter the number of minutes elapse time required. Selecting this option means that if the DimensionNet process is recycled or shut down, anyone using DimensionNet activities at that time will have to restart their session in order to continue working. Click OK. On the Internet Information Services (IIS) Configuration page, click Next when you are ready to continue. Note: If you have already installed mrInterview, the IIS configuration settings are automatically inherited by mrTables, so the Internet Information Services Configuration page will not appear. If the installation process detects that your website runs SSL (Secure Sockets Layer), a message appears asking you whether to use SSL with Dimensions. This increases security by encrypting web pages passed to and from the site. If you choose Yes, the installation process creates a secure (https) URL for mrTables. On the Setup Type page, choose: Typical to install all components on your current machine Compact to install the minimum components on your current machine
1/15/2008
Installation Instructions
Custom to choose the components that you want to install If you chose the Custom installation, two additional pages are displayed. The Choose Destination Location page displays the name of the folder in which the mrTables files will be installed. The default is C:\Program Files\SPSS Dimensions. If you want to install into a different folder, click Browse and choose the folder you want to use. Click Next. On the Select Features page click mrTables Engine. Then click Next. The Start Copying Files page lists the installation choices you have made. If these settings are correct, click Install to begin the installation. If not, click Back and step back through the pages to make the necessary changes. Note: The installation procedure places a number of keys in the registry. The WebServiceURL key contains the URL that should be used for starting mrTables. If the installer can find the server's domain name in the registry, it includes it in the URL so that, for example, the server called olympus is shown as olympus.spss.com. If the WebServiceURL is incorrect. mrTables will not start. To complete the installation, you now need to perform the post-installation tasks. In This Section
Installing mrTables Standard Installation Scenarios Installations onto a Domain Controller
Related Topics
Before You Start Post-Installation Tasks Previous Next
Post-Installation Tasks
After you have installed mrTables Professional there are a number of tasks that you may need to do to ensure that all components are able to function correctly. Full details of these tasks are given below under separate headings. Users who have a license for Microsoft Office Web Components (OWC) (see What You Need to Run mrTables 4.5) can use the charting feature in mrTables. Access to charting is disabled by default. To enable access for licensed users, see Enabling access to charting Set up users and roles in DimensionNet and assign roles to DimensionNet activities For Windows XP Service Pack 2, or if running mrTables through a firewall, add the ASP.NET account to the Launch permissions on LogBck02 For Windows XP Service Pack 2 only, open port 80 on the firewall if remote connections are required for this machine Check Internet Explorer settings If you have installed onto a machine on which mrStudio is installed, add mrStudio users to the Dimensions group so that they have access to the log file folder. If using an SSL Accelerator, set up mrTables to use SSL Accelerators. If you have installed mrTables on more than one machine, you need to set up load balancing If you are using load balancing, set up a shared variable cache folder If using IIS 6.0 and Windows 2003, you can optionally configure mrTables and DimensionNet to use multiple worker processes and set up load balancing between the processes If required, set up mrTables to reject new sessions when the server is busy Start mrUserAdminServer and mrDPMServer3 if they are not already running If using SSL, configure your browser to save encrypted pages to disk Set up projects in DimensionNet Optionally, install the Dimensions Development Library In This Section
Setting Up mrTables Projects in DimensionNet
Related Topics
Installation Scenarios Maintenance Previous Next
1/15/2008
Installation Instructions
2. Enable access to charts for users and roles. Running the Chart Configuration Program Use Windows Explorer to locate the executable file ChartConfiguration.exe. By default, this is installed in C:\Program Files\SPSS Dimensions\DimensionNet. Double-click the file name to run the program, then check the Display Charts in DimensionNet box and click OK. Enabling Access to Charting for Users and Roles After running the chart configuration program, you can enable access to charting for users in a particular role, so that only correctly licensed users are able to access it. You may find that you need to create a separate role for these users. See Adding Roles for more information. In DimensionNet, choose Tools Manage Access The Manage Access activity starts. In the tree frame, expand Activities. Expand the Tabulation activity, and expand Features. Select the Can display charts feature. A frame appears on the right of the page listing the roles currently assigned to this feature. Click assign role(s). This opens the SPSS Manage Access dialog box. Choose the roles you want to assign to the feature and click OK.
Previous Next
Adding Users
Choose Tools Manage Users The Manage Users activity starts. In the User Roles tree, click Users. A list of current user names appears on the right of the screen. On the right of the screen, click add new user. The UserInfo dialog box appears. Complete the fields in the dialog box and click OK to create the new account. Related Topics
1/15/2008
Installation Instructions
Adding Roles Assigning Activities to Roles Setting Up DimensionNet Users, Roles, and Permissions Previous Next
Adding Roles
Choose Tools Manage Users The Manage Users activity starts. In the User Roles tree, click Roles. A list of current role names appears on the right of the screen. In this frame click add new role. This opens the SPSS Manage Users dialog box. Complete the fields in the dialog box and click OK. On the next dialog box, select the users who will be members of this role. Click OK to create the role with the selected users as members. Related Topics
Adding Users Assigning Activities to Roles Setting Up DimensionNet Users, Roles, and Permissions Previous Next
1/15/2008
Installation Instructions
In the left-hand frame expand the display to show the following hierarchy: Component Services > Computers > My Computer > DCOM Config. In the left-hand frame, right-click LogBck02, and select Properties. This opens the LogBckO2 Properties dialog box. Select the Security tab. In the Launch and Activation Permissions frame click Edit. This opens the Launch Permissions dialog box. Click Add. This opens the Select Users or Groups dialog box. Click Locations, and change the location to be your local machine. Then click OK. Add ASPNET, and click OK. In the Launch Permissions window, check that Local Launch and Local Activation are allowed for the ASPNET user and set them if not. Close dcomcnfg.
Previous Next
1/15/2008
Installation Instructions
In the Trusted Sites dialog, add the URL for the mrTables website to the list of trusted websites, and click OK to close the dialog. Security Internet Options when Running mrTables GUI Server and Web Service on Different Machines See "Service Unavailable" Error When Running mrTables GUI Server and Web Service on Different Machines for further information on this setting. On the Security tab of the Internet Options dialog box, select the zone, and click the Custom Level button. In the Miscellaneous section, select Enable or Prompt for "Access data sources across domains". This is necessary even if the mrTables Front End and Web Service are in the same domain. Advanced Internet Options On the Advanced tab of the Internet Options dialog box: In the Browsing section, ensure that "Show friendly HTTP error messages" is unchecked. In the Security section, ensure that "Do not save encrypted pages to disk" is unchecked. See Configuring Your Browser to Save Encrypted Pages to Disk for more information. Enabling File Downloads Follow the instructions that the browser provides the first time it is unable to download a file. The changes made at this point enable all subsequent file downloads in mrTables. For example, when a user chooses to download a file onto his/her computer, the process will run but will display a message in the browser's information bar saying that Internet Explorer has blocked the site from downloading files onto the computer. To allow file downloads, the user should click on the location indicated in the message to display options for enabling downloads.
Previous Next
1/15/2008
Installation Instructions
This displays a page of XML script. Right-click on the page and choose View Source from the context menu. Press Ctrl+A, then Ctrl+C to select and copy the script to the clipboard. Open Notepad and paste in the script. At the end of the file, you will see the following section: <wsdl:service name="TablesService"> <documentation xmlns="http://schemas.xmlsoap.org/wsdl/" /> <wsdl:port name="TablesServiceSoap" binding="tns:TablesServiceSoap"> <soap:address location="https://MyAccessoriesServer/SPSSMR/mrTables/WebService/Webservice.asmx" /> </wsdl:port> </wsdl:service> Change the URL so that it points to the SSL Accelerator server: <soap:address location="https://MyVirtualServer/SPSSMR/mrTables/WebService/Webservice.asmx" /> Ensure that the path of the URL starts with https rather than the standard http. Save the file using the following path, name, and file extension (if your mrTables application is not installed in the default location, adjust the path as necessary): c:\inetpub\wwwroot\SPSSMR\mrTables\WebService\Webservice.wsdl Run regedit and navigate to HKEY_LOCAL_MACHINE\SOFTWARE\SPSS\MR Tables\4.5. Change the value of the WebServiceURL setting to point to the .wsdl file created in the previous step, for example: https://MyVirtualServer/SPSSMR/mrTables/WebService/Webservice.wsdl Restart IIS.
Previous Next
1/15/2008
Installation Instructions
In each <Application> section inside the <LoadReporting> element, update the value of applicationpath so that it shows the server's public URL. For example: <LoadReporting> <Application name="dimensionnet" applicationpool="SPSSDimensionNetPool" ReportingInterval="1000" protocoltype="TCP" applicationpath="https://localhost/SPSSMR/DimensionNet/Default.aspx"> ... </Application> </LoadReporting> Stop and restart the Load Balancing service. Related Topics
Post-Installation Tasks Previous Next
Enabling mrTables and DimensionNet Load Balancing Between Multiple IIS Worker Processes
mrTables runs in its own worker process. The memory limit for a worker process is 2 Gigabytes. If you have Windows 2003 and IIS 6, you can exceed this limit by configuring IIS to use multiple processes and enabling load balancing between the processes. Each process can then use up to the 2 Gigabyte limit. You can also use multiple processes for DimensionNet if required. To do this, you need to carry out the following steps: 1. Set up new Application Pools in IIS 6. 2. Copy the mrTables (or DimensionNet, if required) virtual directory. 3. Create virtual directories for the new applications based on the original. 4. Specify which application should run in each application pool. 5. Configure the LoadBalancingConfiguration.xml file to use the new application pools. To Set Up New Application Pools From Control Panel select Administrative Tools Internet Information Services Right-click the Application Pools folder. Select New, then Application Pool from the menu.
1/15/2008
Installation Instructions
Enter a name for the new pool, for example, SPSSDimensionNetPool2. Do this for as many Application Pools as you want to set up. To Copy the mrTables Virtual Directory In the Web Sites folder, right-click the mrTables application. Select All Tasks, then Save Configuration to a File. In the Save Configuration to a File dialog, enter a name and location for the file, and click OK. To Create Virtual Directories for the New Applications Right-click the SPSSMR folder and select New, then Virtual Directory (from file). In the Import Configuration dialog, select the file that you created previously, then click Read File. The Location list box displays a number of locations. Select the SPSSMR/Tables location and click OK. In the IIS Manager dialog box that appears next, enter a name for the new directory, for example, mrTables2, then click OK. Repeat for each Application Pool you have created. To Assign Applications to Pools Expand one of the newly created application folders and right-click the WebService folder within it, then select Properties. In the Web Service Properties dialog, select the pool you want to assign to the application in the Application pool drop-down list, and click OK. Repeat for all the new applications you have created. To Configure the Load Balancing File Open the LoadBalancingConfiguration.xml file. By default, this is located in the C:\Inetpub\wwwroot\SPSSMR\Shared folder. Select the <Application> tag and make a copy for each new application that you have created. Modify the applicationpool and applicationpath attributes for each new application to point to the correct name and path, for example: <Application name="mrtables" applicationpool="SPSSDimensionNetPool" ReportingInterval="2000" protocoltype="TCP" applicationpath="http://localhost:80/SPSSMR/mrTables/webservice/webservice.asmx"> ... </Application> <Application name="mrtables" applicationpool="SPSSDimensionNetPool2" ReportingInterval="2000" protocoltype="TCP" applicationpath="http://localhost:80/SPSSMR/mrTables2/webservice/webservice.asmx"> ... </Application> <Application name="dimensionnet" applicationpool="SPSSDimensionNetPool3" ReportingInterval="2000" protocoltype="TCP" applicationpath="http://localhost:80/SPSSMR/DimensionNet/default.aspx"> ... </Application> <Application name="dimensionnet" applicationpool="SPSSDimensionNetPool4" ReportingInterval="2000" protocoltype="TCP" applicationpath="http://localhost:80/SPSSMR/DimensionNet2/default.aspx"> ... </Application>
Previous Next
1/15/2008
Installation Instructions
The installation process normally starts mrUserAdminServer and mrDPMServer3 on all machines running the Interviewing Service. Take the following steps to check whether the services are running and, if necessary, to start them. Open Control Panel and choose: Administrative Tools Services This opens the Services dialog box. In the list of services check that both services are running. If a service is not running, right-click on it and choose Start. If neither service is running, you should start mrUserAdminServer followed by mrDPMServer3. A dialog box reports progress of the start-up procedure. Related Topics
Post-Installation Tasks Previous Next
1/15/2008
Installation Instructions
Maintenance
This section describes tasks that you may need to carry out once you have been running mrTables for a while. It includes: Updating the password for mrTables Renewing the license for mrTables Running the variable edits migration tool In This Section
Updating the Password for mrTables Running the Variable Edits Migration Tool Previous Next
1/15/2008
Installation Instructions
Log on to the mrTables server. In Windows Explorer, navigate to the mrTables folder, for example: C:\Program Files\SPSS Dimensions\mrTables\. Double-click on the mrTablesVariableEditsMigrationTool.exe file. In the mrTables Upgrade Tool window, enter your DPMAdmin user name and password. You can either choose to migrate all the information for all projects or for a specific table document, user, and project. To migrate information for all projects Using the Migrate All option means that you can complete the upgrade for all users and projects at once. It also includes an option to delete the variable edits from DPM once the migration has completed successfully. Deleting variable edits is recommended as, once all projects have been upgraded, they are no longer of any use, and are simply taking up space. If required, check the Delete old variable edits once successfully migrated box. Choose the upper Migrate button. The migration tool checks for any users who have variable edits in DPM, and displays a list of the users. You can either choose to migrate all users, or press Cancel to return to the window and select individual users to migrate. If you choose to migrate all users, the results of the migration process are recorded in a log at the bottom of the window. You can copy the information from this log and save it to a file as a record of the upgrade process. Note: Once the upgrade has run successfully for all users and projects, the upgrade tool sets the VariableEditsMigratedToMTD property on the mrTables application in DPM to true, to indicate that all projects have been upgraded. To migrate information for a specific table document, user, or project Using the Migrate to selected file options means that you can carry out the migration for users, projects, and table document files individually. You may prefer to use these options rather than the Migrate All option if you want to perform the upgrade in stages. The option to delete edits from DPM is not available when you use the Migrate to selected file options. This is because the edits may be required by other table documents that have not yet been upgraded. When you have migrated the required users and projects, you may want to use the Migrate All option to check that nothing has been missed, and to delete the variable edits from DPM. To migrate information for individual table documents, users, or projects: To migrate information to a specific table document, browse to the location of the table document in the FMRoot folder, for example: C:\Program Files\SPSS Dimensions\mrInterview\FMRoot\Users\Admin\Projects\Museum\museum tables.mtd. To migrate information for a specific project, type the project's name To migrate information for a specific user, enter the user name Choose the lower Migrate button to run the migration. The results of the migration process are recorded in a log at the bottom of the window. You can copy the information from this log and save it to a file as a record of the upgrade process. In This Section
Maintenance Updating the Password for mrTables Previous Next
Repairing an Installation
Log on with the user name that you created for installing mrTables. In Windows Explorer, browse to the network directory in which the site preparation file was created and double-click autoplay.exe. This opens the SPSS mrTables Installer window. From the SPSS mrTables Installer window, choose Install mrTables 4.5. This starts the SPSS mrTables Setup wizard. On the Welcome page, click Repair and then click Next. The Setup Status page reports the repair's progress. When the repair has finished, click Finish. Related Topics
1/15/2008
Installation Instructions
Removing mrTables
To remove mrTables, use the uninstall feature. If you simply delete the files and folders associated with the product, the application is not properly removed and you may have problems installing or removing later versions. After you installed mrTables, you may have changed some of the files that control how DimensionNet or mrTables works. To save you having to make the same changes when you reinstall mrTables, the removal procedure backs up key files so that you can copy them back to their original locations after a reinstall. Files are backed up to \Program Files\SPSSMR\Backup\SPSS DimensionNet version_date_time; for example, SPSS DimensionNet 2.3_10.15.2004_13.59.20. Inside this folder are subfolders containing files from various locations within \Program Files and the IIS Web site folder. Files that are backed up typically include the following: Web.config files for DimensionNet activities The Web.config file for mrTables ProjectMgmt\pm.ini. To Remove mrTables Log on with the user that you created for installing mrTables. Open Control Panel and choose Add/Remove Programs. Choose SPSS mrTables 4.5. Click Add/Remove or Change/Remove. This starts the SPSS mrTables Setup wizard. On the Welcome page, choose Remove and then click Next. Confirm your request when prompted to do so. On the Maintenance Complete page, click Finish. Reboot when prompted to do so. (If you do not reboot you will not be able to reinstall mrTables.) Related Topics
Repairing or Removing Your Installation Previous Next
Troubleshooting
Problem List
Running mrTables when not connected to a network How do I create an installation log file? The install will not accept the password for the running user I've installed a new version of mrTables and get errors when I try to select things from the menus in DimensionNet I can log in to DimensionNet if I enter the URL as //localhost/... but not if I enter the server's name instead of localhost I can't access a localized version of mrTables after reinstalling or upgrading The location of the Web Site folder containing SPSSMR has changed since mrTables was installed. What changes do I need to make in order to continue using mrTables? My site uses Microsoft ISA. Are there any changes I need to make in order to run DimensionNet? The installer says it can't find SQL server running on the machine specified I'm installing onto Windows XP, and the installation fails when I click Next on the DimensionNet Database Setup page Checking that Machines in a Cluster can Communicate with Each Other To Install the Export Components Enabling Security Access for Microsoft Excel and Microsoft Word Exports "Server is unable to process request. Error setting up cache. Could not find as part of path" Error when Running mrTables "Unable to find a Valid License Code" Error when Running mrTables mrTables has missing icons or does not display new features Changing the Table Size Limits in mrTables mrInterview activities are appearing in the list of activities for mrTables projects Changing to Web Sites That do not Use Port 80 Configuring mrTables after Changing to SSL When opening mrTables I get a message saying: "This page is accessing information that is not under its control. This poses a security risk. Do you want to continue?". What should I do? "Service Unavailable" Error When Running mrTables GUI Server and Web Service on Different Machines Previous Next
1/15/2008
Installation Instructions
Change the FileMgt_RootFolderUNC= setting to the same value as the FileMgt_RootFolderLocalPath= setting. Open a command prompt and run C:\Program Files\Common Files\SPSS Dimensions\ProjectMgmt\pmsetup.exe to update DPM. Note: It is recommended that you use a command prompt to run pmsetup.exe (rather than running it from within Windows Explorer) as this displays any errors that are returned. If you want to revert to running mrTables when connected to the network, you need to replace the value of FileMgt_RootFolderUNC= in pm.ini with the original value and run pmsetup.exe again. You can find the original value using the Registry Editor: From the Start menu select Run. In the Open box, type regedit and click OK. This opens the Registry Editor. In the left-hand frame, navigate to HKEY_LOCAL_MACHINE\SOFTWARE\SPSS\DimensionNet\InstallOptions. Make a note of the setting for FMRoot_UNC. You will also need to install the Microsoft Loopback Adapter. See Improving Stability when Running DimensionNet Off-line for more information.
Previous Next
The install will not accept the password for the running user
If you are installing locally using Windows XP Pro, the install will not accept the password for the running user if you are not installing with a domain user. To resolve this problem, you must run secpol.msc, as follows: Click
1/15/2008
Installation Instructions
Start Run Type secpol.msc and click OK. Open the Security Settings>Local Policies>Security Options folder. Change Network access: Sharing and security model for local accounts to Classic - local users authenticate as themselves instead of the default, which references guests.
Previous Next
I've installed a new version of mrTables and get errors when I try to select things from the menus in DimensionNet
When you run applications from your browser, the browser maintains a number of temporary files that help it to keep track of what you have done and to run the application as efficiently as possible. Sometimes, when you install and run a different version of an application, your browser attempts to reuse the information in the temporary files. If this no longer matches the way the application works, errors will occur. You can solve this problem easily by deleting the temporary files. Open your browser and select Tools Internet Options In Temporary Internet Files, click Delete Files. Confirm your request when prompted to do so.
Previous Next
I can log in to DimensionNet if I enter the URL as //localhost/... but not if I enter the server's name instead of localhost
If the server name contains any characters other than letters, numbers, hyphen, and dot, you will not be able to log in to DimensionNet by specifying the server name in the URL. This is due to a limitation in Internet Explorer which prevents servers whose names contain characters other than these from setting cookies. If you want to use this server with DimensionNet and mrInterview you will either have to change its name or refer to it using its IP address.
Previous Next
The location of the Web Site folder containing SPSSMR has changed since mrTables was installed. What changes do I need to make in order to continue using mrTables?
If the location of the Web site on which you installed mrTables changes after installation, you will need to move the mrTables and DimensionNet application folders and the webctrl_client folder from the original Web site to the new one. You will also need to change the pathname defined for the DimensionNet load balancing configuration file in DimensionNet's Web.config file. If the SPSSMR folder does not appear in the new Web site folder, copy it from the Web site folder in which it was installed into the new location. Move the webctrl_client folder from the original Web site folder into the new folder so that it is at the same level as the SPSSMR folder.
1/15/2008
Installation Instructions
From Control Panel choose: Administrative Tasks Internet Information Services This opens the Internet Information Services window. Create the new SPSSMR virtual directory In the left-hand frame, right-click the Web site to which you have just copied the SPSSMR folder and select New, Virtual Directory. This starts the New Virtual Directory wizard. On the first page of the wizard, click Next. On the Virtual Directory Alias page, enter SPSSMR as the Alias name and then click Next. On the Web Site Contents Directory tab, click Browse and select the SPSSMR folder in its new location. Then click Next. On the Access Permissions page, ensure that only the Read and Run script check boxes are selected. Then click Next. On the last page, click Finish. Create virtual directories for Dimensions activities Create virtual directories for activities within the SPSSMR folder by repeating the previous set of steps for each activity folder. For example, to create a virtual directory for the Activate activity, right-click SPSSMR in the left-hand frame and choose New, Virtual Directory. Within each activity's virtual directory, create virtual directories pointing to the SPSSMR\Shared and SPSSMR\Shared\Login folders. For example, to create an SPSSMR\Activate\Shared virtual directory, right-click Activate in the left-hand frame and choose New, Virtual Directory. Remove the Create Application setting from the SPSSMR, Shared and Login virtual directories In the left-hand frame, right-click SPSSMR and select Properties. This opens the SPSSMR Properties dialog box. In the Application Settings frame, click Remove. The text box is greyed out and the button name changes to Create. Click OK. Repeat this procedure for every Shared and Login virtual directory within SPSSMR. Close IIS. Reconfigure DimensionNet load balancing Browse to the DimensionNet folder in the new Web site folder. Right-click Web.config, select Properties, and remove the Read-only attribute from the file. Click OK to close the dialog box. Using a text editing program such as Notepad, open Web.config. Scroll to the end of the file and locate the line that defines the SPSS_LoadBalanceXmlFile key. In this line, replace the pathname with the drive letter and pathname of the new Web site folder (do not change the filename itself). Save your changes and close the file. Update the Registry setting for the mrTables variable cache directory From the Windows Start menu, select Run. In the Open box, type regedit and click OK. This opens the Registry Editor. In the left-hand frame, navigate to HKEY_LOCAL_MACHINE\SOFTWARE\SPSS\MR Tables\4.5. In the right-hand frame, right-click VariableCacheDir, and select Modify. In the Edit String dialog, replace the pathname with the drive letter and pathname of the new Web site folder and click OK. You must reboot your machine before the changes take effect.
Previous Next
My site uses Microsoft ISA. Are there any changes I need to make in order to run DimensionNet?
If you have Microsoft Internet and Security Acceleration (ISA) installed, you may encounter problems if your site has machines that have different names or IP addresses depending on whether they are being accessed via an intranet or via the internet. Typically, if a user runs DimensionNet from the internet and starts an activity, DimensionNet will fail when the user ends the activity. This is because it tries to return the user to DimensionNet using the server's intranet name or IP address rather than the internet name or IP address that the user originally used. To avoid this problem, make the following changes: Open ISA and select the Action tab. Select Send the original host header to the publishing server instead of the actual one. Click OK.
1/15/2008
Installation Instructions
The installer says it can't find SQL server running on the machine specified
If the installation procedure issues the message "Can't find SQL server running on the machine specified." when you click Next on the DimensionNet Database Setup page, this may be for any of the following reasons: You mistyped the server's name. The machine running the SQL Server is unreachable. Microsoft Data Access Components (MDAC) are not correctly installed. The latest Windows updates are not installed. To resolve the problem, do the following: Check that your spelling is correct and, in the case of a named SQL server instance, that you have typed the instance name correctly. Check that you can ping the machine. See Checking that Machines in a Cluster can Communicate with Each Other for more information. If MDAC are not installed, proceed as follows: Cancel the mrTables install and select Install Microsoft Data Access Components (MDAC) 2.8 from the autoplay menu. See Installing Microsoft Data Access Components 2.8 for more information. When the MDAC installation finishes, reboot the machine. Download and install the latest Windows updates from Microsoft.com. If you are using Windows XP and the error still persists and you now see the message "The procedure entry point SetFileSecurityI could not be located in the dynamic link library MSDART.DLL", follow the instructions in I'm installing onto Windows XP, and the installation fails when I click Next on the DimensionNet Database Setup page.
Previous Next
I'm installing onto Windows XP, and the installation fails when I click Next on the DimensionNet Database Setup page
When you click Next on the DimensionNet Database Setup page, the installation procedure runs a script to check that it can communicate with the database server named on this page. If you are installing mrTables on a machine running Windows XP (this is supported for demonstration machines only), you may find that the installation procedure fails at this point with the message "The procedure entry point SetFileSecurityI could not be located in the dynamic link library MSDART.DLL", regardless of the server name you enter and whether you can communicate with the server in other ways. This is due to a problem with the operating system, which you should be able to resolve by copying the msdart.dll file to be msdart32.dll. You'll find the file in c:\Windows\system32. Once you have created a copy with the new name you should be able to install mrTables with no problems.
Previous Next
1/15/2008
Installation Instructions
In the main installer window, choose Browse the CD-ROM. Browse to the SPSS mrTables Exports Installer folder and double-click the file Setup.exe. This opens the SPSS mrTables 4.5 Exports window. On the Welcome page, click Next. On the License Agreement page, read the license agreement. If you accept the agreement, click Yes. In the Customer Information page, enter your user name and your organizations name, and then click Next. In the Setup Type page, choose one of the following and then click Next: Complete. Choose this option if you want to install the export components into the default locations. Custom. Choose this option if you want to specify which where the export components will be installed. If you chose the Custom installation, in the Custom Setup page specify where the files will be installed by clicking the Change button in the lower part of the window. The SPSS Dimensions Exports Setup wizard is now ready to start the installation. Click Install. This installs and registers the export components on your local machine. You can then select export options from mrTables. Related Topics
Enabling Security Access for Microsoft Excel and Microsoft Word Exports Previous Next
Enabling Security Access for Microsoft Excel and Microsoft Word Exports
If you are using Microsoft Office XP, Microsoft Office 2003, or Microsoft Office 2007, security settings in Microsoft Excel or Microsoft Word may prevent you from exporting to these applications. If this occurs, you can enable the export to run by changing a security setting in Microsoft Excel or Microsoft Word. If you need to change the setting on your machine, a message will inform you of this. Follow the instructions below to change the settings. If you are in doubt about whether changing security settings is permitted by your organization, please contact your system administrator. Note: Ensure that you have the latest Microsoft Office service pack installed. For Microsoft Office 2000 or XP, Service Pack 3 or later is required, and for Microsoft Office 2003, Service Pack 2 or later is required. To check this, choose the Check for Updates option on the Microsoft Excel Help menu to display the Microsoft Office Downloads page, where you can download the latest service pack. Microsoft Office XP or 2003 Note: Setting the security options in one program does not set them in the other. You may need to follow these steps for both Excel and Word, depending on your existing security settings. Ensure that mrTables and all Microsoft Office applications are closed. Open Excel or Word. From the menu, choose: Tools Macro Security This opens the Security dialog box in Excel, or the Macro Security dialog box in Word. Click the Trusted Sources tab (the Trusted Publishers tab in some versions of Excel and Word). Select the Trust access to Visual Basic Project check box. Click OK to apply the setting. Close Excel or Word. Microsoft Office 2007 Note: Setting the security options in one program does not set them in the other. You may need to follow these steps for both Excel and Word, depending on your existing security settings. In Microsoft Office 2007, macro security settings are located in the Trust Center. Ensure that mrTables and all Microsoft Office applications are closed. Open Excel or Word. Click the Microsoft Office button. Click the Excel Options or Word Options button. Click Trust Center Trust Center Settings
1/15/2008
Installation Instructions
In Excel, additionally click Macro Settings. Select the Trust access to the VBA project object model check box. Click OK to apply the setting. Close Excel or Word. For more information, see Enable or disable macros in Office documents at http://office.microsoft.com/en-us/help/HA100310711033.aspx. Related Topics
To Install the Export Components Previous Next
"Server is unable to process request. Error setting up cache. Could not find as part of path" Error when Running mrTables
The error message: "Server is unable to process request. Error setting up cache. Could not find as part of path <drive>." may occur when you when you click the Tabulation activity to start mrTables. To resolve this error, ensure that the mrTables anonymous user account has read access to the root of the Inetpub drive; for example, C:\ or D:\.
Previous Next
1/15/2008
Installation Instructions
Right-click, and select New, then String Value, from the context menu. Enter a value called PopulateLimit. Right-click, and select Modify from the context menu. Enter the number of cells at which you want mrTables to display an error message and prevent population, then click OK.
Previous Next
mrInterview activities are appearing in the list of activities for mrTables projects
If you have both mrInterview and mrTables and you have upgraded from release 2.x to release 3.x, mrInterview activities such as Build may appear in the list of activities for mrTables projects in DimensionNet, even though the activities are not valid for those projects. This occurs because the upgrade process does not check whether the project is an mrInterview or an mrTables project or both, and therefore displays mrInterview activities for all projects. To prevent mrInterview activities from displaying for mrTables projects In DimensionNet, select the project and click the Edit Project Properties icon.
In the Properties tab, click the ShowInterviewApps property for the project. This selects and highlights the value of the property, which is currently set to True. Type False, then click the Home button to save your change and return to the DimensionNet Activities screen.
Previous
Next
1/15/2008
Installation Instructions
When opening mrTables I get a message saying: "This page is accessing information that is not under its control. This poses a security risk. Do you want to continue?". What should I do?
A. Internet Explorer automatically displays this warning message when a page links to another page that is not in the same domain. You can prevent the message from appearing by adding the website for the mrTables page to the list of trusted sites in Internet Explorer. To do this: When the above message appears, choose Yes to open the mrTables web page, then copy the url for the page. From the Internet Explorer menu, choose: Tools Internet Options Click the Security tab and select Trusted Sites. Click the Sites button. In the Trusted Sites dialog, enter the url for the mrTables web page and click OK. Note that this adds all pages in the web site to the list of trusted sites, not just the selected page. You may prefer to retain the warning message and just choose Yes when it appears as you open mrTables.
Previous
"Service Unavailable" Error When Running mrTables GUI Server and Web Service on Different Machines
When running mrTables GUI server (the host in the URL used to launch mrTables) and the web service on different machines, there is sometimes no connection. This has been observed when the mrTables GUI server is running Windows Server 2003. The message from mrTables is "Service Unavailable". To resolve this problem: From the Internet Explorer menu, choose: Tools Internet Options On the Security tab of the Internet Options dialog box, select the zone, and click the Custom Level button. In the Miscellaneous section, select Enable or Prompt for "Access data sources across domains". This is necessary even if the mrTables GUI server and web service are in the same domain.
Next
1/15/2008
Installation Instructions
Software Microsoft .NET Framework version 2.0 (included on the Desktop Reporter 4.5 installation CD). Microsoft Internet Explorer 6.0 or 7.0 Microsoft Data Access Components 2.8 or later (included on the Desktop Reporter 4.5 installation CD). The installation automatically installs the English language version, but if you are running a different language version of Windows you need to install the appropriate language version. Microsoft Office 2000, XP, 2003, or 2007 (required for exporting to Microsoft Word, Excel or PowerPoint, or to HTML). For Microsoft Office 2000 or XP, Service Pack 3 or later is required; for Microsoft Office 2003, Service Pack 2 or later is required. Microsoft Office Web Components version 10 or later (required for displaying charts in Desktop Reporter 4.5). Hardware Pentium-class processor operating at 1 GHz or faster, 2 GHz recommended. 512 MB RAM minimum, 1 GB recommended. A hard disk with at least 200 MB of available disk space. CD-ROM drive required for installation. A graphics adapter with 1024 x 768 resolution or higher. Minimum 16-bit color quality setting. License Code Your license code, which is supplied with your Desktop Reporter 4.5 installation CD. This enables you to install the system that you have purchased. Related Topics
Required Software Checklist Previous Next
1/15/2008
Installation Instructions
Follow the instructions on the screen. Restart your computer. This is recommended even if the installation program does not request it. Related Topics
Required Software Checklist Previous Next
1/15/2008
Installation Instructions
If the license code is valid, the purchased product is now marked as active. Click Next. In the Customer Information page, enter your user name and your organization's name and click Next. In the Setup Type page, choose one of the following: Complete. Choose this option if you want to install Desktop Reporter 4.5 into the default location. Custom. Choose this option if you want to specify where Desktop Reporter 4.5 is to be installed. Click Next. If you chose the Custom installation, on the Custom Setup page you can specify where the files will be installed by clicking the Change button in the lower part of the window. Then click Next. The SPSS Desktop Reporter 4.5 Setup wizard is now ready to start the installation. Click Install. At the end of the installation process, the Setup wizard prompts you to check: the SPSS Support website, for new releases and patches the Microsoft Update website, for security updates and Microsoft Office service pack updates. For information on the Microsoft Office service packs required for exporting tables to Microsoft Office products, see What You Need to Run Desktop Reporter 4.5. Download and install any required updates. Related Topics
Installing the Dimensions Development Library Previous Next
Examples The following example installs Desktop Reporter 4.5 into the default folder without logging the install: setup.exe /s /v"/qn LICENSECODE=\"11111 11111 11111 11111 11111 11111 11111 11111\"" The following example installs Desktop Reporter 4.5 into the default folder and logs the installation messages to a file called C:\log.txt: setup.exe /s /v"/qn /l*v C:\log.txt LICENSECODE=\"11111 11111 11111 11111 11111 11111 11111 11111\"" The following example installs Desktop Reporter 4.5 into the specified folder and logs the installation messages to a file called C:\log.txt: setup.exe /s /v"/qn /l*v C:\log.txt INSTALLDIR=\"C:\MyInstallFolder\" LICENSECODE=\"11111 11111 11111 11111 11111 11111 11111 11111\""
Previous Next
1/15/2008
Installation Instructions
about Desktop Reporter 4.5. You may find it useful when installing Desktop Reporter 4.5 because it contains sample data sets that users can use while learning Desktop Reporter 4.5, as well as step-by-step instructions for installing these data sets. The DDL is included on the Desktop Reporter 4.5 installation CD. Take the following steps to install it. From the Desktop Reporter 4.5 Installer window, choose Browse the CD-ROM. Browse to the DDL folder. Double-click DDL_Installation_Guide.chm, which provides step-by-step instructions. Double-click Autoplay.exe to start the installation.
Previous Next
1/15/2008
Installation Instructions
/x /qn
Required. Uninstalls the product. Required. Tells the MSI uninstaller to run in Quiet mode, that is, not to provide any user interface.
Previous Next
Troubleshooting
Related Topics
Running a Logged Installation Previous
1/15/2008
Installation Instructions
Pentium-class processor operating at 1GHz or faster, 2GHz recommended. * 512MB RAM minimum, 2GB recommended. * A hard disk with at least 200MB of available disk space, and additional space for mrStudio data files. CD-ROM drive required for installation. A graphics adapter with 1024 x 768 resolution or higher. Minimum 16-bit color quality setting. * Minimum requirements will vary depending on the type of processing that will be done with mrStudio, for example, data processing, tabulation, or interview scripting. For more information, please contact your SPSS Dimensions account manager. License Code Your license code, which is supplied with your mrStudio 4.5 installation CD. This enables you to install the system that you have purchased. Related Topics
Documentation for mrStudio 4.5 Required Software Checklist Previous Next
1/15/2008
Installation Instructions
Notes Installing Microsoft .NET Framework 2.0 upgrades a number of Windows components. To Install Microsoft .NET Framework 2.0 From the SPSS mrStudio 4.5 Installer window, choose Install .NET Framework 2.0. Follow the instructions on the screen. Restart your computer. This is recommended even if the installation program does not request it. Related Topics
Required Software Checklist Previous Next
1/15/2008
Installation Instructions
this does not happen, follow these steps to start the installation program manually: Insert the mrStudio 4.5 installation CD into the CD-ROM drive. From the Windows Start menu, choose Run. In the Run dialog box, type d:\autoplay where d:\ is the CD-ROM drive. This opens the SPSS mrStudio 4.5 Installer window. To Install mrStudio 4.5 From the SPSS mrStudio 4.5 Installer window, choose Install mrStudio 4.5. This starts the SPSS mrStudio 4.5 Setup wizard. On the Welcome page, click Next. On the License Agreement page, read the license agreement. If you accept the agreement, click I accept the terms in the license agreement and click Next. On the Licensing Information page, enter the license code(s) supplied with your mrStudio 4.5 installation CD and click Update. If the license code is valid, the purchased product is now marked as active. Click Next. In the Customer Information page, enter your user name and your organization's name and click Next. In the Setup Type page, choose one of the following: Complete. Choose this option if you want to install mrStudio 4.5 into the default location. Custom. Choose this option if you want to specify where mrStudio 4.5 is to be installed. Click Next. If you chose the Custom installation, on the Custom Setup page you can specify where the files will be installed by clicking the Change button in the lower part of the window. Then click Next. The SPSS mrStudio 4.5 Setup wizard is now ready to start the installation. Click Install. Related Topics
Installing the Dimensions Development Library Installing Microsoft .NET Framework 2.0 Previous Next
Post-Installation Tasks
After you have installed mrStudio, you may need to carry out the following task. Setting the Target for Project Activation If you have installed the mrStudio interview option, you will be able to activate your interview script (.mdd) files so that they can be used in mrInterview. By default, when you choose Activate from the mrStudio Tools menu, a Login dialog appears in which you can enter the name of the primary DPM server in the target mrInterview cluster. If you do not have access to the FMRoot shared folder on that server, you can enter the DimensionNet URL and login details instead. If you typically activate to only one mrInterview cluster, and you have access to FMRoot, you can specify the default server name and stop the Login dialog from appearing by setting two options in mrStudio: Activate Server or URL. Set this option to the name of the primary DPM server in the target mrInterview cluster. Show Login Dialog. Set this option to False. If you typically activate to more than one cluster, leave the value of "Show Login Dialog" as True (which is the installation value), as you can then select the required server name or URL from a drop down list in the Login dialog. For more information, see the entries for "Activate Server or URL" and "Show Login Dialog" in topic "mrStudio Options" in the Dimensions Development Library (DDL) documentation. That topic is indexed under mrStudio > Options.
Previous Next
1/15/2008
Installation Instructions
Browse to the DDL folder. Double-click the DDL_installation_guide.chm file, which provides step-by-step installation instructions.
Previous Next
Troubleshooting
Related Topics
Running a Logged Installation Previous Next
1/15/2008
Installation Instructions
FAQs
Q. How do I add the mrStudio Interview Option or the mrStudio Tables Option to my existing installation of mrStudio? A. It is not possible to add these components to an existing installation. You must remove and reinstall mrStudio. During the installation, make sure that you enter the license codes for all the components that you want to add.
Next
1/15/2008
Installation Instructions
See Installing the Dimensions Development Library for more information. Related Topics
Required Software Checklist Installing the Dimensions Development Library Previous Next
1/15/2008
Installation Instructions
The Windows AutoPlay feature should detect and start the installation program when you insert the Dimensions Component Pack 4.5 installation CD into the CD-ROM drive. If this does not happen, follow these steps to start the installation program manually: Insert the Dimensions Component Pack 4.5 installation CD into the CD-ROM drive. From the Windows Start menu, choose Run. In the Run dialog box, type d:\autoplay where d:\ is the CD-ROM drive. This opens the SPSS Dimensions Component Pack 4.5 Installer window. To Install Dimensions Component Pack 4.5 From the SPSS Dimensions Component Pack 4.5 Installer window, choose Install Dimensions Component Pack 4.5. This starts the SPSS Dimensions Component Pack 4.5 Setup wizard. On the Welcome page, click Next. On the License Agreement page, read the license agreement. If you accept the agreement, click I accept the terms in the license agreement and click Next. On the Licensing Information page, enter the license code(s) supplied with your Dimensions Component Pack 4.5 installation CD and click Update. If the license code is valid, the purchased product is now marked as active. Click Next. In the Customer Information page, enter your user name and your organization's name and click Next. In the Setup Type page, choose one of the following: Complete. Choose this option if you want to install Dimensions Component Pack 4.5 into the default location. Custom. Choose this option if you want to specify where Dimensions Component Pack 4.5 is to be installed. Click Next. If you chose the Custom installation, on the Custom Setup page you can specify where the files will be installed by clicking the Change button in the lower part of the window. Then click Next. The SPSS Dimensions Component Pack 4.5 Setup wizard is now ready to start the installation. Click Install. Related Topics
Installing the Dimensions Development Library Installing Microsoft .NET Framework 2.0 Previous Next
1/15/2008
Installation Instructions
Troubleshooting
Related Topics
Running a Logged Installation Previous
1/15/2008
Installation Instructions
In the Print Topics window, select Print the selected heading and all subtopics and then press Enter. Related Topics
What You Need to Run Data Model 4.5 Previous Next
1/15/2008
Installation Instructions
1/15/2008
Installation Instructions
On the License Agreement page, read the license agreement. If you accept the agreement, click I accept the terms in the license agreement and click Next. In the Customer Information page, enter your user name and your organization's name and click Next. In the Setup Type page, choose one of the following: Complete. Choose this option if you want to install Data Model 4.5 into the default location. Custom. Choose this option if you want to specify where Data Model 4.5 is to be installed. Click Next. If you chose the Custom installation, on the Custom Setup page you can specify where the files will be installed by clicking the Change button in the lower part of the window. Then click Next. The SPSS Data Model 4.5 Setup wizard is now ready to start the installation. Click Install. Related Topics
Installing the Dimensions Development Library Installing Microsoft .NET Framework 2.0 Previous Next
Troubleshooting
Related Topics
Running a Logged Installation Previous
1/15/2008
Installation Instructions
1/15/2008
Installation Instructions
License Code Your license code, which is supplied with your Interview Player 4.5 installation CD. This enables you to install the system that you have purchased. Related Topics
Required Software Checklist Previous Next
1/15/2008
Installation Instructions
1/15/2008
Installation Instructions
Optional. Waits until the command is finished before returning to the command prompt. Although this is optional it is useful in a silent install, as otherwise the log needs to be continually examined to find out when the install has completed. Required. Tells setup.exe to be silent. Required. Tells setup.exe to pass the following parameters (that is, everything between the following quotation mark and the final quotation mark at the end of the command) to the MSI installer. Required. Tells the MSI installer to run in Quiet mode, that is, not to provide any user interface. Optional. Tells the MSI installer to log in Verbose mode to the file mylogfile. Optional. Defines the folder where you want to install Interview Player 4.5. Not necessary if you want to install into the default folder for Dimensions products, which is C:\Program Files\SPSS Dimensions. Required. The license code supplied with your Interview Player 4.5 CD.
Examples The following example installs Interview Player 4.5 into the default folder without logging the install: setup.exe /s /v" /qn LICENSECODE=\"12345 67890 12345 67890 12345 67890 12345 67890\" " The following example installs Interview Player 4.5 into the default folder and logs the installation messages to a file called C:\log.txt: setup.exe /s /v" /qn /l*v \"C:\log.txt\" LICENSECODE=\"12345 67890 12345 67890 12345 67890 12345 67890\" " The following example installs Interview Player 4.5 into the specified folder and logs the installation messages to a file called C:\log.txt: setup.exe /s /v" /qn /l*v \"C:\log.txt\" INSTALLDIR=\"C:\MyInstallFolder\" LICENSECODE=\"12345 67890 12345 67890 12345 67890 12345 67890\" " The following example does the same as the previous example, but waits for the install to complete before returning to the command prompt: start /WAIT setup.exe /s /v" /qn /l*v \"C:\log.txt\" INSTALLDIR=\"C:\MyInstallFolder\" LICENSECODE=\"12345 67890 12345 67890 12345 67890 12345 67890\" " Related Topics
Removing Interview Player 4.5 Using the Command Line Previous Next
1/15/2008
Installation Instructions
Examples The following example shows a basic uninstallation: setup.exe /s /x /v" /qn " The following example logs the uninstallation messages to a file called C:\log2.txt. It also waits for the uninstall to complete before returning to the command prompt: start /WAIT setup.exe /s /x /v" /qn /l*v \"C:\log2.txt\" " Related Topics
Installing Interview Player 4.5 From the Command Line Previous Next
Troubleshooting
Related Topics
Running a Logged Installation Previous
1/15/2008
Installation Instructions
When you install or remove an SPSS Dimensions product, information relating to the installation or removal is added to a log file. The file is called instlog.txt and is located in folder C:\Program Files\Common Files\SPSS Dimensions\Installer. For an installation, the information written to the log includes the Microsoft Windows build number and service pack level. For a list of Windows build numbers and the Windows versions they relate to, see http://msdn.microsoft.com/library/default.asp?url=/library/enus/msi/setup/operating_system_property_values.asp.
1/15/2008