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.
To move FMRoot to a different location after installation, proceed as follows.
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.
This displays the FMRoot Properties dialog box.
4 On the Sharing tab, do the following:
▪Select Share this folder and, in Share name, type SPSSMR_FMROOT.
▪Click Permissions and, on the Share Permissions tab, give Everyone Full Control. Click OK.
5 On the Security tab, add your UNICOM Intelligence Interviewer group if it is not already there and give it Full Control. Click OK.
6 Navigate to \Code\Tools\VB.NET\DPM Explorer.Net in the folder in which the UNICOM Intelligence Developer Documentation Library is installed (usually [INSTALL_FOLDER]\IBM\SPSS\DataCollection\<version>\DDL\) and double-click DPMExplorer.exe.
7 In the left pane, select Properties.
8 If you have moved FMRoot to a different server, change the value of FileMgt_RootFolderUNC:
▪In the upper right frame, select FileMgt_RootFolderUNC.
▪In the lower right frame, change the computer name in the property's value to the new location and click Apply.
9 In the upper right-hand frame, select FileMgt_RootFolderLocalPath.
10 In the lower right-hand frame, change the value to the new location and click Apply.
11 Close DPM Explorer.
12 To keep all properties up-to-date, the FMROOTUNC property must also be updated in the DataCollectionSitePrep.ini file. The file is created on the primary server when the server software is installed.
13 Start UNICOM Intelligence Interviewer - Server Admin and check that you can create and activate a project and run an interview. If activation fails because it cannot access the project's Temp folder, this is a sign that you have not set the correct permissions on the Sharing tab.
If you do not have access to DPM Explorer
1 From Control Panel, choose Administrative Tools > Services.
2 Stop all the "mr" services; that is, mrDPMServer3 and mrUserAdminServer.
3 Move FMRoot to its new location and set its permissions as described above.
4 Navigate to C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ ProjectMgmt, and then open pm.ini.
5 If you have moved FMRoot to a different server, change the value of FileMgt_RootFolderUNC to the new server.
6 Change the value of FileMgt_RootFolderLocalPath to the new location of FMRoot.
7 Save your changes and close the file.
8 In the Services application, restart the "mr" services.
9 From the Start menu, select Run and type cmd to open a command prompt.
10 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.
11 Start UNICOM Intelligence Interviewer - Server Admin and check that you can create and activate a project and run an interview. If activation fails because it cannot access the project's Temp folder, it might mean that you have not set the correct permissions on the Sharing tab.
Updating the registry after moving FMROOT
If you change the location of the FMROOT in DPM Explorer post 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
See also