Locator supports the deployment of multiple Locator servers, configured to work together to search and index documents from the various data sources within the customer environment. In a multi-server scenario, the secondary Locator search server can be added to the SolrCloud of the primary Locator Search Server to offer distribution of index, replication, failover and load balancing.  You can add as many Secondary Search Servers as you like to the Primary Locator Server depending on the needs and requirements.

...

1. In the Locator Installer choose Custom Install 
   
2. On the Server Address page, replace localhost with the primary server hostname for the Licensing service address field
3. For the Zookeeper address, replace localhost with the primary server IPV4 address and keep the port :9983
4. If using PostgreSQL, on the Database Information page, leave the drop down as PostgreSQL and the database name as Locator.
5. If using Microsoft SQL, on the Database Information page, change the drop down as Microsoft SQL Server and fill in the database server hostname, database name and database user account credentials. Click Verify Connection
6. Choose the following components
   
7. Finish the installer and wait for the installation to complete.

Configuring a Locator Secondary Search Server in a multi-server environment

Before you start: If you plan to use the server as both a search and fetch server, you need to skip the step disabling the fetch services and make sure the server is configured as a fetch server. See Installing/Configuring an Additional Fetch Server.

1. Make sure you have installed and configured the primary Locator Server, see Installing/configuring a Primary Server in a multi-server environment

2. Add a new rule to the Windows firewall allowing all traffic inbound on TCP port 8983 for Solr.  Run the following from an elevated command prompt.  This command will work on Windows Server 2008 R2 or later:

   Code Block
   language powershell theme RDark
   netsh advfirewall firewall add rule name="Locator Solr (TPC-In)" protocol=TCP localport=8983 action=allow dir=IN remoteip=xxx.xxx.xxx.xxx,yyy.yyy.yyy.yyy

   Replace xxx.xxx.xxx.xxx and yyy.yyy.yyy.yyy with the IP(s) of the servers involved with the multi server setup. This applies both to servers in a multi server SOLR ViaWorksCloud setup, as well as setups where additional fetch servers are set up.

...

2. Once installed, stop all Locator services in the specified order.  This can be accomplished either manually, via the Windows Services UI, or from a PowerShell session.

   Windows Services UI Method
   
   From the Windows Services app, stop each Locator Service in the following order:

...

1. 
   

   
   
   • Locator Index

...

1. • Service
   • Locator Database Service

   
   PowerShell Method
   
   Paste the following code into an elevated PowerShell session to stop all Locator services:

   Code Block
   language powershell theme RDark
   # Create an array of Locator service names in the order they should be stopped.

...

...

1. $vwServices=

...

1. Get-

...

1. Service | Where { $_.Name -like "Via.Index.Service"

...

1. -or $_.Name -like "ViaWorksDatabaseService"} # Stop each Locator service $vwServices|

...

1. ForEach-

...

1. Object { Stop-

...

1. Service $_.

...

1. Name -Verbose }

   
   

2. Postgres only: If you used Custom Install Path in the Locator Installer these values should have already been set. Please verify in %ProgramFiles%\ayfie\Locator\Config\DataAccess.config. If the values are still localhost, do the following from an elevated command prompt, first make a backup copy and then edit the file %ProgramFiles%\ayfie\Locator\Config\DataAccess.config
   
   

   1. Change the value of the “ViaDatabaseServer” key to reflect the IPv4 address of the Primary Locator server as opposed to the default value of 127.0.0.1.
      
      

   2. Add this line before the </appSettings> line:

      Code Block
      language xml
      <add key="LicensingServiceServer" value="<IPv4_addr>" />

      
      Where <IPv4_addr> is the IPv4 address of the Primary Locator server.

      
      

3. Edit the REST Service web.config: "[Drive]:\Program Files\ayfie\Locator\RestService\web.config": change <add key="LicenseHostName" value="localhost" /> to <add key="LicenseHostName value="FQDN_of_primary_server" />. Use "[Drive]:\Program Files\ayfie\Locator\RestService\Custom\web_config_overrides.config" to persist change through upgrades, see How do override files work?

4. Verify that the REST Service web.config "[Drive]:\Program Files\ayfie\Locator\RestService\web.config": AuthorityServiceBaseUrl key reflect the FQDN of the primary Locator Server. The Locator installer sets this value.

5. Disable

...

1. all Locator services except the Locator Index Service. Perform this manually from the Services UI or by executing the command in an elevated PowerShell session:

   Code Block
   language powershell theme RDark

...

$fetchServices= Get-Service | Where {$_.DisplayName -like "*Locator*" -and $_.DisplayName -notlike "*Locator*Fetch*" -and $_.DisplayName -notlike "*Index Service*"}
$fetchServices| Set-Service -StartupType Disabled -Verbose

...

1. # Create an array of Locator service names in the order they should be disabled. $vwServicesExceptIndexService= Get-Service | Where { $_.Name -like "ViaWorksDatabaseService"} # Disable each Locator service $vwServicesExceptIndexService| Set-Service -StartupType Disabled -Verbose

   
   

2. Start the Locator Index Service. Perform this manually from the Services UI or by pasting the following code into the same elevated PowerShell session:

   Code Block
   language powershell theme RDark

...

1. Get-Service | Where {$_.DisplayName -like "

...

1. Locator

...

1. Index Service"}

...

1. | ForEach-Object {

...

1. Start-Service -

...

Verify Configuration Server

1. Name $_.Name -Verbose}

...

After the Locator Installer finished you need to do manual configuration to set up the SolrCloud. See Web Server and Solr Cloud Configuration

...

1. On the Primary or Secondary Locator Search

   This server is now configured as a Locator Search server. On the secondary search server, open your browser and got to http://localhost:8983/solr/#/~cloud.

   This should now display the SolrCloud and all shards on all Locator Search Servers.On the Primary Locator server:
2. (Optional for PostgreSQL installations) From an elevated command prompt, run %ProgramFiles%\ayfie\Locator\PostgreSQL\bin\pgAdmin3.exe
3. Select the Locator database

Select the SQL button and paste the following text into the window:

Code Block
language sql
SELECT * FROM config.via_works_server;

4. Run the query
5. Verify there is a second row showing the secondary Locator server (see the ADDITIONAL_COMPUTERNAME and ADDITIONAL_COMPUTER_FQHN columns).
Close pgAdmin

 
Image Added
This displays the status of the SolrCloud setup. Note that the SolrCloud at this stage only has shards on the primary server.

6. If you plan to configure more secondary search servers, repeat this guide for all secondary search servers. If not, you can continue with configuring the SolrCloud index. See Web Server and Solr Cloud Configuration.