Installation : Deploying Exalead CloudView : Adding Hosts, Roles and Build Groups
 
Adding Hosts, Roles and Build Groups
 
Add Hosts
Restart Exalead CloudView on Hosts
Configure Roles
Add a New Build Group
This section describes how to add hosts, configure roles and add build groups.
Add Hosts
Restart Exalead CloudView on Hosts
Configure Roles
Add a New Build Group
Add Hosts
To define your deployment, add secondary servers and configure them with specific roles that determine their function within the deployment.
For complete deployment role details, see "Appendix - Deployment Roles and Related Processes" in the Exalead CloudView Administration Guide.
When you add a new secondary server, you can duplicate an existing host's configuration. This creates the roles you require for a combined index and search host automatically. However, you can manually edit the host configuration as explained in the procedures below.
Add a New Secondary Server
1. In the Administration Console, select Deployment > Roles.
2. On the Roles page, click Add host.
a. Enter the Host Name of the secondary server, for example, server002.exalead.com
b. Enter the Install Name of the secondary server install, for example, secondary1.
c. If required, modify the Base port, Host agent, and Last port with the new secondary server's port range.
3. Click Accept.
4. On the Add roles window, add the roles required for your deployment then click Accept.
For more information, see the specific configuration steps for how to:
Add a Combined Search and Index Server
Add a Search Server Only
Add an Index Server Only
Add a New Build Group
5. Click Apply.
6. Restart Exalead CloudView.
For more information, see Restart Exalead CloudView on Hosts.
7. Install Exalead CloudView on the new secondary server.
For more information, see Installing Secondary Servers.
Copy a Secondary Server
1. In the Administration Console, select Deployment > Roles.
2. On the Roles page, click Add host.
a. Enter the Host Name of the secondary server install, for example, server002.exalead.com
b. Enter the Install Name of the secondary server install, for example, secondary2.
c. Select Duplicate from host, then select the host name, for example, server001.exalead.com
3. Click Accept.
The roles are duplicated for the new host, except those that cannot be duplicated and are unique per build group.
4. The new secondary server now has the required roles for a combined index and search host but you must configure them:
Modify roles that depend on other roles so they point to the role instance on this new secondary server. This ensures high availability.
For example, modify the Search API role on the secondary2 host so it points to secondary2's Search server, instead of secondary1's.
In most cases, you do not need the Connector and Crawler servers. So you can delete them.
For more information, see Configure Roles.
5. Click Apply.
6. Restart Exalead CloudView.
For more information, see Restart Exalead CloudView on Hosts.
7. Install Exalead CloudView on the new secondary server.
For more information, see Installing Secondary Servers.
Restart Exalead CloudView on Hosts
For several maintenance or administration operations, you will have to restart Exalead CloudView.
Restart Exalead CloudView in the Administration Console
1. In the Processes section, select the host you want to restart from the Host list.
2. Click Restart CloudView on this host at the bottom of the home page.
This restarts all the processes for the selected host.
Restart Exalead CloudView in Windows
1. To restart the registered Windows service, use the Microsoft Management Console or enter the following command:
net stop "Exalead CloudView - cvdefault"
2. Then
net start "Exalead CloudView - cvdefault"
where cvdefault is the default Exalead CloudView master install name.
Restart Exalead CloudView in Linux
1. From <DATADIR>/bin/, enter:
./cvinit.sh restart
Configure Roles
Each deployment role corresponds to a Exalead CloudView process, which displays on the Home page of the Administration Console.
For a description of all roles and their options, see "Appendix - Deployment Roles and Related Processes" in the Exalead CloudView Administration Guide.
Figure 8. By adding roles to a host, you install Exalead CloudView processes on that machine, which you can manage from the Administration Console’s Home page.
Add a Combined Search and Index Server
1. On the new secondary server, click Add roles.
2. On the Add roles window, select the Index role and all the Search roles:
Mashup UI
Mashup API
Search API
Search Server
Storage Service
3. Click Accept.
4. Configure the Index role:
a. Select the Build group such as bg0.
b. For Instance name, enter a name such as i0.
5. Configure the Search Server role:
a. For Instance name, enter a unique name such as ss1.
b. For API port, enter a port number, for example, baseport + 10.
c. For UI port, enter a port number, for example, baseport.
d. Select HTTPS if you need to use SSL for the hosted Mashup UIs; see also "Enable HTTPs for the Mashup UI" in the Exalead CloudView Administration Guide.
6. Configure the Search API role:
a. For Search server instance, enter the instance name specified in step 5.
7. Configure the Mashup API role:
a. For Search server instance, enter the instance name specified in step 5.
b. For Instance name, enter a unique name such as ac1.
c. For Mashup application, enter your application name, if not using default.
8. Configure the Storage Service role:
a. For Search server instance, enter the instance name specified in step 5.
b. For Instance name, enter a unique name such as sts1.
9. Configure the Mashup UI role:
a. For Search server instance, enter the instance name specified in step 5.
b. For Instance name, enter a unique name such as mu1.
c. For HTTP context path, enter the path for the application such as /mashup-ui.
d. For Storage service instance, enter the instance name specified in step 8.
10. Click Apply.
11. You are now ready to install a secondary server of the product. See Installing Secondary Servers.
Add a Search Server Only
1. On the new secondary server, click Add Roles.
2. On the Add Roles window, select all the Search roles:
Mashup API
Search API
Search Server
Mashup UI
Storage Service
3. Click Accept.
4. Configure the Search Server role:
a. For Instance name, enter a unique name such as ss1.
b. For API port, enter a port number, for example, baseport + 10.
c. For UI port, enter a port number, for example, baseport.
d. Select HTTPS if you need to use SSL for the hosted Mashup UIs. For more information, see "Enable HTTPs for the Mashup UI" in the Exalead CloudView Administration Guide.
5. Configure the Search API role:
a. For Search server instance, enter the instance name specified in step 4.
6. Configure the Mashup API role:
a. For Search server instance, enter the instance name specified in step 4.
b. For Instance name, enter a unique name such as ac1.
c. For Mashup application, enter your application name, if not using default.
7. Configure the Storage Service role:
a. For Search server instance, enter the instance name specified in step 4.
b. For Instance name, enter a unique name such as sts1.
8. Configure the Mashup UI role:
a. For Search server instance, enter the instance name specified in step 4.
b. For Instance name, enter a unique name such as mu1.
c. For HTTP context path, enter the path for the application such as /mashup-ui.
d. For Storage service instance, enter the instance name specified in step 7.
9. Click Apply.
10. You are now ready to install a secondary server of the product. See Installing Secondary Servers.
Add an Index Server Only
1. On the new secondary server, click Add Roles.
2. On the Add Roles window, select the Index role.
3. Click Accept.
4. Configure the Index role:
a. Select the Build group.
b. For Instance name, specify a name such as i0.
5. Click Apply.
6. You are now ready to install a secondary server of the product. See Installing Secondary Servers.
Define a Local-Only Search Target
While most of the deployment scenarios covered in this guide use the default search target, the scenario shown in Recommended Deployment uses a local-only search target. With a local-only search target, the search server only searches indexes that are on the same machine.
1. In the Administration Console, select Deployment > Build groups > Search Targets.
2. Delete the default search target, st0.
3. Click Add search target:
a. For Name, type st0.
b. For Type, select Local only.
c. Click Accept.
4. In the settings for this new search target, under Build groups, select the target build group.
5. Click Apply.
Add a New Build Group
When you add a new build group, you can add it to an existing host, or create a new slave host for the build group.
This new build group can use the same data model and indexing server configuration as the original build group (bg0), or you can create new ones for it.
1. To deploy the new build group on its own host, add a new slave host.
Important: For more information, see Add a New Secondary Server. However, for step 4, do not add an Indexing server role when adding this new host. When you create a new build group (in the steps that follow), this role is added to the target host automatically.
2. In the Administration Console, select Deployment > Build groups.
3. Click Add build group and specify the required information:
a. Enter the Name, for example, bg1.
Note: You cannot change the build group name once created.
b. For Deploy on this host, select the target host.
c. For PAPI server port, specify an available port.
4. Select different configurations for the following:
a. Data model: the classes and properties this build group must use to generate the index.
b. Indexing config: the index compaction policy and trigger conditions.
5. Modify these indexing options:
a. To deploy the index for this build group on a different host, clear Deploy index replica on same host.
b. Change No. of slices.
6. Click Accept.
This creates the new build group, and also adds the Indexing server role and an Index role (unless you cleared this option) to the target host.
7. For Document cache, you can disable the cache for the build group.
8. Click Apply.