Domains - Installation procedure

Steps

The installation of the Master configuration follows these steps :

  1. declaration of the Master server

  2. registration of Watchdoc servers.

You can complete this installation by activating centralised configuration:

  1. activate centralised configuration

  2. activate synchronisation mode.

Access the Domain management interface

  1. From the administration interface Main Menu, Configuration section, click on Advanced Configuration;

  2. in the [Server_Name]>Advanced_Configuration interface, click on Domain management:


     

→ you will access the Watchdoc Domain Management interface.

Some of the information that appears here is the same information that was entered when Watchdoc was installed, in the Initial Service Configuration interface.

Declaration of the master server

From Watchdoc v6, the master role can be declared from the Wathdoc administration interface > Advanced administration > Domain management.

In versions prior to v6 or when you wish to assign the Master role to a large number of slave servers, you can do this using the WCLI (Watchdoc Command in Line) command line tool.

Declare the master from Watchdoc

  1. From the Domain Management interface, click Create a domain as master;

  2. in the Create a domain interface, enter :

    • Identifier: the IP address of the master server;

    • Name: the name of the server which will be used to identify it in Watchdoc;

    • Description: additional information to identify the server if necessary:


  1. Click Create to confirm the creation of the domain and its master server.

Declare the master from WCLI

The Watchdoc Master declaration is carried out with the command line tool WCLI (Watchdoc Command in Line).
The WCLIClosed (Watchdoc Command Line) is a command line tool that allows you to generate recurring tasks in Watchdoc. In particular, it can be used to manage the Master/Slave configuration, create an ASSETS database, create external queues on a server, for example. ASSETS database, create external queues on a server, for example. tool does not have to be launched from the server to be declared. It can be launched from any Watchdoc server, as long as there is network connectivity between the target Watchdoc service and the command tool. The role declaration is carried out using the WCLI command line tool.

  1. with the inline command tool, go to the Watchdoc installation directory cd "\Program Files\Doxense\Watchdoc"

  2. launch the master creation command

    WCLI CREATEMASTER /master=address /password=maintenance_password

    In this command, the value Address may have the following shapes:

    • an IP address (ex: 10.10.0.110) ;

    • an hostname (ex: printserver1) ;

    • a FQDN (ex: printserver1.doxense.local) ;

    • an URI (ex: https://printserver1:5753/watchdoc/server).

     

  3. verify you received the following confirmation message:

 

→ In the Watchdoc Main menu the new server status is displayed:

Check the master server statut

  1. in the Watchdoc Main Menu, the server new status is displayed:



  2. in the Domain management interface, the domain information and certificates are displayed:



→ You can complete in the information for the master server, and also add other servers in the domain.

Declare Watchdoc others servers

Declare other servers from Watchdoc

Once the master has been declared and the domain created, you can add other servers to it:

  1. Access the master Watchdoc administration interface as an administrator

  2. From the Main Menu, click on Advanced Configuration;

  3. In Advanced configuration, click onDomain management:

 

  1. in the Domain Management interface, Server List section, click Add a slave server ;

  2. in the Add a slave server interface, enter the Watchdoc slave server address and port (DSP service port) ;

  3. click on Add to validate the addition of the slave server:

 

N.B. This configuration can also be done in Watchdoc, in the slave server administration interface.

Declare others servers from WCLI

The WCLI tool does not have to be launched from the server to be declared. It can be launched from any Watchdoc server, as long as there is network connectivity between the target Watchdoc service and the command tool.

  1. Using the command line tool, go to the Watchdoc installation folder;

  2. run the command to register the server in the domain (case sensitive): WCLI CREATESLAVE /master=server_master /slave=server_watchdoc /password=maintenance_password

  3. check that you receive the following confirmation message:

Activate settings replication

Watchdoc enables various configuration items to be synchronised between the master and the slaves. These items are managed from the Watchdoc administration interface and from the master server's supervision console (WSC).

Replicating configuration items from Watchdoc

When configuring the master server, the Global parameter is used to replicate the configuration of certain configuration items on the Slavic servers included in the domain. This parameter can be activated for the following configuration items:

  • Printing queues

  • Pricings

  • Directories

  • Filters

 

To enable replication from one of these elements from the master server to the slave servers:

  1. in the Watchdoc master administration interface, select the configuration item to replicate;

  2. click on the Edit properties button for the configuration item to be replicated (group of files and directories in the example);

  3. in the General information section, tick the Global box ;

  4. click Validate to save the configuration:

 

→ Once a master server setting is declared as Global, it is directly replicated on all the Watchdoc servers.

→ Once a setting is replicated, the Global check box can't be unchecked.

→ The logo reports on the Master server configuration items replicated on the other servers.

→ The logo specifies on other servers that the item is configured on the Master server.


Replicate configuration items from the supervisory console (WSC)

The following configuration items can be replicated from the master's supervisory console:

  • security profiles ;

  • notification configuration ;

  • unlock profiles

  • default unlock profiles.

 

Synchronisation can be performed on a one-time basis and/or scheduled to be restarted on a regular basis.

 

To activate synchronisation :

  1. Access the Supervision Console of the Master server as an administrator;

  2. From the Main Menu, click on Advanced Configuration, then Server Maintenance:

     

  3. Tick the box Enable the maintenance tasks on servers, and set frequency :

     

  4. In the section Master-Slave synchronisation, tick the boxes corresponding to the synchronisation actions you want to activate:

     

  5. Validate the setting.