====== Exalead / Master/Slave ======

In the following architecture, the slave server will only be used to serve UI with an index that can be detached from Master when performing full scan.
In the current example, the CV Slave server will be installed on the physical server => in the screen shots, 'localhost' is used. It has to changed according to your architecture.

===== Add roles =====

In Deployment/Roles, create a new host :

{{ :exalead:exalead_masterslave_addhost.png?600 |}}

Select the following roles for the host :
  * Indexing/Index
  * Search/Mashup API
  * Search/Mashup UI
  * Search/Search API 
  * Search/Search server
  * Search/Storage Service

{{ :exalead:exalead_masterslave_selectroles.png?200 |}}
===== Add Local Search Target =====

In Deployment/Build Groups/Search Target, create a new search target with type 'Local Only'.

{{ :exalead:exalead_masterslave_addsearctarget.png?600 |}}

Use the 'Only Local' search target in the Search API :

{{ :exalead:exalead_masterslave_searchapi_defaultsearchtarget.png?600 |}}

===== Install Slave =====

From kitdir, run the following command

<code>
<INSTALLDIR>/install.sh -license <LICENSE> -data <DATADIR> -host <SLAVE_HOSTNAME> 
-importSecurity <EXISTING_DATADIR/security> -install <SLAVE_INSTALL> 
-slave <MASTER_GATEWAY_URL> 
</code>

^ Variable      ^ Description       ^
| <LICENSE>   | The path to the CloudView license file (cvlicense.dat). |
| <DATADIR>    | Creates the specified directory during installation, to store the index and configuration data. Specify a new directory for <DATADIR>. |
| <SLAVE_HOSTNAME>    | The slave's hostname value in the master's Deployment.xml |
| <MASTER_GATEWAY_URL>  | <nowiki>Use the format http://<MASTERHOSTNAME>:<BASEPORT+11></nowiki> |
| <SLAVE_INSTALL>  | The slave's install value in the master's Deployment.xml |


Example for the install on vdemopro server
<code>
# Remove old datadir
datadir='/home/data/RTV/DEMOR422/cloudview/data-edf-2020X-16000/'
kitdir='/home/data/RTV/DEMOR422/cloudview/cloudview-V6R2020x.R0.101779-linux-x64'
license='/tmp/cvlicense.dat'
if [ -d $datadir ]; then
        echo '============== STOP CLOUDVIEW INSTANCE =============='
        $datadir/bin/cvinit.sh stop
        sleep 15
        echo '============== REMOVE DATADIR =============='
        rm -rf $datadir
fi
echo '============== INSTALL CLOUDVIEW INSTANCE =============='
# Install from Kit
$kitdir/install.sh -license $license -data $datadir -host localhost -install cvdefault_slave -slave http://localhost:15011
echo '============== INSTALLATION DONE =============='

</code>

===== Useful commands =====

==== Detach SliceReplica  ====
<code>
./cvcommand vdemopro1128dsy.extranet.3ds.com:15011 /mami/indexing detachSliceReplica sliceInstance=i1 indexSlice=0 buildGroup=bg0
./cvcommand vdemopro1128dsy.extranet.3ds.com:15011 /mami/indexing detachSliceReplica sliceInstance=i1 indexSlice=1 buildGroup=bg0
</code>

==== Clear Build Group ====
Clear Master build group without clearing replicas
<code>
./cvcommand vdemopro1128dsy.extranet.3ds.com:15011 /mami/indexing clearBuildGroup keepIndexInstances=false keepReplicatedIndexInstances=true buildGroup=bg0
</code>

==== Clear Consolidation ====

<code>
./cvcommand vdemopro1128dsy.extranet.3ds.com:15011 /mami/consolidation clear instanceName=cs0
</code>

==== Clear Replica ====

<code>
./cvcommand vdemopro1128dsy.extranet.3ds.com:15011 /mami/indexing clearSliceReplica sliceInstance=i1 indexSlice=0 buildGroup=bg0
./cvcommand vdemopro1128dsy.extranet.3ds.com:15011 /mami/indexing clearSliceReplica sliceInstance=i1 indexSlice=1 buildGroup=bg0
</code>

==== Attach Slice Replica ====

<code>
./cvcommand vdemopro1128dsy.extranet.3ds.com:15011 /mami/indexing attachSliceReplica sliceInstance=i1 indexSlice=0 buildGroup=bg0
./cvcommand vdemopro1128dsy.extranet.3ds.com:15011 /mami/indexing attachSliceReplica sliceInstance=i1 indexSlice=1 buildGroup=bg0
</code>