ClusterEditorUI.exe scenarios
There are two methods for adding a server to a cluster:
▪Method 1: Adding an unprepared UNICOM Intelligence server to a cluster. This method prepares and attaches a server where UNICOM Intelligence software was not previously installed.
▪Method 2: Adding a prepared UNICOM Intelligence server to a cluster. This method entails attaching a prepared, but unused, UNICOM Intelligence server to the cluster. The new server already has the UNICOM Intelligence software installed. This new server can be created by copying an existing virtual machine with the software preinstalled.
Method 1: Adding an unprepared UNICOM Intelligence server to a cluster
In this scenario, the server is not yet installed or assigned a role. The Cluster Editor utility must be used to update the site preparation file before you install the UNICOM Intelligence Server software. You can go to
Method 2: Adding a prepared UNICOM Intelligence server if the server is already in a prepared state (prepared with the Cluster Editor utility and UNICOM Intelligence is installed).
1 Open the Cluster Editor UI from the server you want to prepare, and click Prepare Server. The right pane displays options for defining the new server, such as roles, connection settings, and performance settings.
Name: Enter an appropriate server name. The utility does not verify the server name.
Select the roles this server will perform within the cluster: Select the appropriate cluster roles for the new server. The following roles are provided:
▪Accessories Server
▪Phone Interviews
▪Remote Administration
▪Web Server
▪Interview Server
▪Survey Tabulation Server
▪Survey Reporter Server
▪Author Server
Note You must select at least one role.
Use secure socket layer: When selected, the new server uses secure socket layer (SSL) when it establishes connections.
Port number: Defines a specific port number for the new server. The port number must be an integer 1 - 65535. The default value is 80.
Virtual directories (for Accessories, Survey Tabulation, Survey Reporter Server, and Author Server): Defines the number of virtual directories to create for each server type (Accessories, Survey Tabulation, Survey Reporter, and Author). The minimum value is 1; the maximum value is 64.
Session engines (for Interviewer Server): Defines the number of session engines when the Interviewer Server role is selected for the server. Select the appropriate number of session engines for the server. The minimum value is 1; the maximum value is 64.
Web services (for Web Server): Defines the number of web services when the Web Server role is selected for the server. Select the appropriate number of web services for the server. The minimum value is 1; the maximum value is 64.
2 Click Save to save the new server's settings. The new server's status is set to Configured, which means the server's configuration information is saved to the site preparation file.
A <ServerName>.iss file is also created as a convenience and is used to support UNICOM Intelligence silent installations. When a silent installation is selected as the UNICOM Intelligence installation method for the prepared server, the file's various password settings must be manually updated. For example:
[{1EA0104A-75FE-4546-9D16-D71C22D6D590}-dlgUserAdmin-0]UserPassword=NOT_SETResult=1
[{1EA0104A-75FE-4546-9D16-D71C22D6D590}-DlgAskAnonUser-0]AnonymousUserPassword= NOT_SETResult=1
[{1EA0104A-75FE-4546-9D16-D71C22D6D590}-DlgAskDPMAdmin-0]DpmAdminPassword= NOT_SETEnableIWA=FALSE
Result=1
Note A silent installation creates encrypted passwords.
3 When changes are made on the server form, the Save andCancel controls are enabled (only when the server status isConfigured).
4 Close the Cluster Editor UI.
5 Run the UNICOM Intelligence installer on the selected server.
6 Open the Cluster Editor UI and select File > Refresh, select the server node in the left pane, and click Detach Server to detach the server from the separate, single computer cluster.
7 Now that the server is in a prepared state, refer to the following section for instructions on adding a prepared server.
Method 2: Adding a prepared UNICOM Intelligence server
This scenario assumes that the server is prepared in accordance with the steps outlined in the previous section. Before proceeding, you must ensure that the Cluster Editor utility was used to prepare the server and that the UNICOM Intelligence software is installed on the virtual or physical server.
Note A new server can be a copied from a virtual machine image, however the virtual machine image must be configured with a unique name before it can be added to the cluster.
Run ServerConfig.exe on the new virtual machine image or physical computer. The purpose is to collect information about which UNICOM Intelligence products and roles are installed on the image/computer, and to update the image/computer configuration to match the destination server cluster. For example:
ServerConfig.exe <site preparation file>
If the UNICOM Intelligence software was installed on the virtual machine image with a different service user (or as an anonymous user other than the normal cluster users) and the site preparation file does not contain the encrypted password for the users, the user is prompted to enter the service user and anonymous user passwords.
Note A silent installation creates encrypted passwords.
2 After you use ServerConfig.exe to update the site preparation file on the server, run ClusterEditorUI.exe, select the server from the tree view, and then click Attach Server to add the server to the cluster.
See
See also