Versions Compared

Old Version 32

changes.mady.by.user Steinar Skjerven

Saved on

compared with

New Version 33

changes.mady.by.user Daniel Dybsland

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Locator supports the deployment of multiple Locator servers, configured to work together to index documents from the various data sources within the customer environment.  In a multi-server scenario, the primary Locator server will be used to establish connections, "crawl" and discover documents to be indexed from each connection, and perform the conversion and indexing, while the secondary servers are used strictly to assist in the conversion process.  This document describes the process of deploying a secondary Locator server to enable the additional server to fetch and convert documents.

...

  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.

...

  1. Make sure you have installed and configured the primary Locator Server, see Installing/configuring a Primary Server in a multi-server environment
  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:


        • All Fetch Services, in any order (e.g. ayfie FileServer Fetch Service, ayfie Exchange Fetch Service, etc.)
        • Locator IndexBuilder Service (if existing)
        • Locator Index ServiceService (if existing)
        • Locator Licensing ServiceService (if existing)
        • Locator Database Service


    PowerShell Method

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

    Code Block
    languagepowershell
    themeRDark
    # Create an array of Locator service names in the order they should be stopped. Get the fetch services first.
$vwServices= Get-Service | Where { $_.DisplayName -like "*ViaWorks*Fetch*" -or $_.DisplayName -like "*Locator*Fetch*" -or $_.DisplayName -like "*ayfie*Fetch*"}

# These services must be stopped in this order after fetch services are stopped.
$vwServiceNames = @(
"ViaWorksIndexBuilder",
"Via.Index.Service",
"Via.Licensing.Service",
"ViaWorksDatabaseService"
)

# Add to the array of services for each of the additional services that are NOT fetch services
foreach ($n in $vwServiceNames) {
    $vwServices += (Get-Service -Name $n)
}

# Stop each Locator service
$vwServices| ForEach-Object {
    Stop-Service $_.Name -Verbose
}

    NOTE: IndexBuilder, Index.Service and Licencing.Service might not be installed (if following instructions on this page) and will produce errors that can be ignored. A change in the script that checks if the service exists would be great.

  3. From Locator 2.11 and above: The ayfie Authority Service is available from Locator 2.11. This component should not have been selected during Custom Install. If installed on the Fetch Server anyway, stop and disable the ayfie Authority service. Perform this manually from the Services UI by executing the command in an elevated PowerShell session:

    Code Block
    languagepowershell
    themeRDark
    $authorityService= Get-Service | Where {$_.DisplayName -like "ayfie Authority Service"}
$authorityService| ForEach-Object {Stop-Service $_.Name -Verbose}
$authorityService| Set-Service -StartupType Disabled -Verbose


  4. 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 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
      languagexml
      <add key="LicensingServiceServer" value="<IPv4_addr>" />


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

  5. Disable all non-fetch Locator services by executing the command in an elevated PowerShell session:

    Code Block
    languagepowershell
    themeRDark
    # These services must be stopped in this order after fetch services are stopped.
$vwServiceNames = @(
"ViaWorksIndexBuilder",
"Via.Index.Service",
"Via.Licensing.Service",
"ViaWorksDatabaseService"
)
$vwServiceNames | Set-Service -StartupType Disabled -Verbose


  6. Start all of the Locator fetch services by executing the command in an elevated PowerShell session:

    Code Block
    languagepowershell
    themeRDark
    Get-Service | Where { $_.DisplayName -like "*ViaWorks*Fetch*" -or $_.DisplayName -like "*Locator*Fetch*" -or $_.DisplayName -like "*ayfie*Fetch*"} | ForEach-Object {
Start-Service -Name $_.Name -Verbose
Start-Sleep -Seconds 10
}


  7. After completing these steps, the secondary server will be able to function as a fetch and conversion node once it has been configured in the scheduler. 
  8. Open Locator Management Console and install the required connectors

...

Verify Configuration and Assign Fetch Server

  1. On the Primary Locator server:
    1. (Optional for PostgreSQL installations) From an elevated command prompt, run %ProgramFiles%\ayfie\Locator\PostgreSQL\bin\pgAdmin3.exe
    2. Select the Locator database

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

      Code Block
      languagesql
      SELECT * FROM config.via_works_server;


    4. Run the query
    5. Verify there is a second row showing the secondary Locator server (see the computer_name and dns_name columns).
    6. Close pgAdmin
  2. Start the Locator Management Console and on the "Scheduling" page under Connections, assign the secondary server to each of the connections in each of the connectors from which the secondary server will be used to fetch documents.
    1. The secondary server should have the “Perform Discovery” option disabled and the “Perform Fetch” option enabled.
    2. Remember to click "Save" after assigning the server to each connection. 
    3. Note that the secondary server’s schedule must be set and is independent of the primary server’s schedule. See Scheduling (Connections).


See also

Child pages (Children Display)
pageInstalling the ayfie Locator Server