Moving the FMRoot folder
The FMRoot folder stores copies of all projects that are being developed as well as those that are currently being used for live interviewing. It is usually in the main installation folder, but you can specify a different location as part of the installation procedure.
To move FMRoot after installing UNICOM Intelligence Interviewer, complete the following steps:
Moving FMRoot and updating the DPM properties that point to FMRoot
See:
If you have access to DPM Explorer
1 In Windows Explorer, move the FMRoot folder and all of its contents to the new location.
2 A message warns that the folder will no longer be shared if you move it, and asks whether to continue: Click OK.
3 Right-click FMRoot in its new location, and then click Sharing and Security.
The FMRoot Properties dialog opens.
4 On the Sharing tab, do the following:
▪Select Share this folder. In Share name, type SPSSMR_FMROOT.
▪Click Permissions. On the Share Permissions tab, give “Full Control” to Everyone, and then click OK.
5 On the Security tab, add your UNICOM Intelligence Interviewer group if it is not already there, and then give it “Full Control”. Click OK.
6 Go to the folder in which the UNICOM Intelligence Developer Documentation Library is installed (usually [INSTALL_FOLDER]\IBM\SPSS\DataCollection\<version>\DDL\, and then to \Code\Tools\VB.NET\DPM Explorer.Net.
7 Double-click DPMExplorer.exe.
8 In the left pane, select Properties.
9 Check the values of the following properties, and change them if necessary. For example, if the FMRoot path has changed, you might need to change a full path; or if the UNC path has changed to a different computer, you might need to change a computer name.
To change a property, click it in the top right frame; change its value in the bottom right frame; and then click Apply.
▪Brad_Backups_UNC
▪FileMgt_RootFolderLocalPath
▪FileMgt_RootFolderUNC
▪InterviewCacheUNC
▪InterviewRespondentFilesFolderUNC
▪SyncRejectFolder
If you do not have access to DPM Explorer
1 In the Windows Control Panel, click Administrative Tools > Services.
2 Stop mrDPMServer3 and mrUserAdminServer.
4 Navigate to C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ ProjectMgmt, and then open the pm.ini file.
5 Change the values of the following properties in the pm.ini file to refer to the new location. For example, if the FMRoot path has changed, you might need to change a full path, or if the UNC path has changed to a different computer, you might need to change a computer name.
▪FileMgt_RootFolderUNC
▪FileMgt_RootFolderLocalPath
▪SyncRejectFolder
▪InterviewCacheUNC
▪InterviewRespondentFilesFolderUNC
▪Brad_Backups_UNC
6 Save the file, and then close it.
7 In the Services application, restart mrDPMServer3 and mrUserAdminServer.
8 From the Start menu, select Run, and then type cmd to open a command prompt.
9 Go to C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ ProjectMgmt, and then type pmsetup.exe.
A message indicates that the DPM has been updated.
Updating Microsoft Internet Information Services (IIS)
Update the DataCollectionStyles Virtual Application to use the new UNC path. To do this, follow these steps:
1 In Internet Information Services (IIS) Manager, go to the site that hosts the UNICOM Intelligence software.
2 Click DataCollectionStyles Virtual Application.
3 Click Basic Settings in the right pane; change the Physical path; and then click OK.
4 Restart IIS, and then close IIS Manager.
Updating the registry entry
Use regedit to update the following registry entry:
HKEY_LOCAL_MACHINE\SOFTWARE\SPSS\mrInterview\3\ProjectCache\MasterDirectory
Other updates based on FMRoot access rules
Depending on how the ImageCache is set up, web servers might need direct access to FMRoot, and the ImageCache web.config files need to be updated:
1 For each of the servers in the cluster, edit the following file:
\inetpub\wwwroot\SPSSMR\ImageCache\web.config
2 If the IS_REMOTE application setting is false, update the BASE_LOCATION and the SHARED_LOCATION to give web servers direct access to FMRoot.
Testing FMRoot
1 Start UNICOM Intelligence Interviewer - Server Admin, and then make sure that you can create a project; activate it; and then run an interview.
If activation fails because UNICOM Intelligence Interviewer - Server Admin cannot access the project’s Temp folder, it might be because the permissions on the Sharing tab are incorrect (see
If you have access to DPM Explorer, step 3).
2 Check that the interview displays as expected, indicating that templates and images are loading correctly.
Updating FMRoot for consistency and future installations
To keep all properties up-to-date, the FMROOTUNC property in the DataCollectionSitePrep.ini file must also be updated. The file is created on the primary server when the server software is installed.
If you change the location of the FMROOT in DPM Explorer after installation, you must also update the associated registry entries to match the DPM Explorer values. If the environment is a cluster environment, you must update the registry entries on all clustered accessory servers, servers and servers. The mapping of DPM properties and registry entries is as follows:
|
DPM property
|
Registry entry
|
|
FileMgt_RootFolderLocalPath
|
HKEY_LOCAL_MACHINE\Software\SPSS\DimensionNet\InstallOptions\FMRoot_Local
and
HKEY_LOCAL_MACHINE\Software\SPSS\mrInterview\3\InstallOptions\FMRoot_Local
|
|
FileMgt_RootFolderUNC
|
HKEY_LOCAL_MACHINE\Software\SPSS\DimensionNet\InstallOptions\FMRoot_UNC
and
HKEY_LOCAL_MACHINE\Software\SPSS\mrInterview\3\InstallOptions\FMRoot_UNC
|
Updating the image cache BASE_LOCATION and SHARED_LOCATION
If you move FMRoot, and a survey contains images, you must change the image cache BASE_LOCATION property to the new FMRoot location. The BASE_LOCATION property is in the image cache's web.config file at: wwwroot\SPSSMR\ImageCache\web.config.
For example, if the original location of FMRoot is \\SERVER_A\SPSSMR_FMROOT, and then you move it to \\SERVER_B\SPSSMR_FMROOT, you must change BASE_LOCATION from \\SERVER_A\SPSSMR_FMROOT\Master to \\SERVER_B\SPSSMR_FMROOT\Master in each web.config file for every Web server.
The SHARED_LOCATION might also need to be change if you use shared content. If you are using the default setup for shared content, the changes are as follows.
If you have chosen one of the other options described in
Supporting shared content, refer to that topic to determine if changes are required.
Updating mrIWeb > Images virtual drive properties
1 Open Microsoft Internet Information Services Manager from the Windows Control Panel's Administrative Tools feature.
2 Select the virtual drive for Images ([Server Name] > Web Sites > mrIWeb > Images).
3 Open the Images properties (right-click).
4 In the Virtual Directory tab, update the Network directory value with the new FMRoot location.
5 Click Apply, and then close the Images Properties dialog.
6 Reset Internet Information Services (enter the command IISReset in a Windows command prompt).
See also