Moving FMRoot
FMRoot is one of the most important folders for UNICOM Intelligence Interviewer because it 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.
If you want to move FMRoot after installing UNICOM Intelligence Interviewer, follow these steps:
Moving FMRoot and updating the DPM properties that point to FMRoot
The steps to follow depend on whether you have access to DPM Explorer. DPM Explorer is included with the DDL (Developer Documentation Library), and you can install it on any server which also has UNICOM Intelligence installed.
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 Navigate 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
|
See also