Adding instances

To add an instance, perform the following steps:

1. Under Groups menu choose the group you intend to add the new instance to. The Group Management page is open. Click the ADD INSTANCE button.

   

2. Specify the properties of the instance to be added and click ADD INSTANCE.
   

   Complete instance configuration first

   The first instance of a certain product should be licensed and configured before adding to Central Management. Otherwise security rules may not work properly. To fix security rules, the product and its instances should be removed and added again after fixing the configuration of the instance.

   The following properties are available:

   1. NAME: Mandatory, unique name of this instance,

   2. DESCRIPTION: Optional, additional description of this instance,

   3. TAGS: Optional, tags of this instance

      Tags defined elsewhere

      Tags defined at an instance will automatically be offered at the edition of tags of an other instance.

   4. REST ADDRESS: Mandatory, REST URI of the instance to be added,

      REST URI syntax

      The syntax of the REST URI must be:

      URI schema

      <scheme>://<host>:<port>[/function]

      For example:

      URI with no function

      https://localhost:8008

      URI with function

      http://10.0.0.1:8009/metadefender_rest

   5. CREDENTIALS: Mandatory to specify either the USERNAME / PASSWORD or the API KEY (or both),

      1. Human user credentials

         1. USERNAME: Username of a defined user in the instance,

         2. PASSWORD: Password of the appropriate user in the instance.

      2. API KEY: API key of a defined user in the instance.

         Credential preference

         If all the USERNAME / PASSWORD and API KEY properties are specified then the USERNAME / PASSWORD values will be used.

         User privileges

         The user specified here by the USERNAME / PASSWORD or by the API KEY must have FULL privileges on the User Management on the instance to be added.

         

   6. IMPORT CONFIGURATION: If the instance to be added is the first of its product in the group, its configuration should be imported by enabling this option. By default, it was enabled.

      Configuration imported from the first instance of a product

      Enabling or disabling this option for other instances than the first one of a product in a group will make no difference.

3. Clicking on ADD INSTANCE button takes back to the Group Management page.
   
   Under the PRODUCTS in the left panel, the product type of the added instance appears (if this is the first instance of a product within this group).

Managing instances

There are two ways to the Instances pages:

1. One is selecting the desired group and clicking the product on the Group Management page that has the instance you intend to manage.

2. The other one is selecting the desired group and choosing the Instances submenu of the product (for example: Groups > localhost > Core > Instances).

On the Instances page the list of instances displayed with details about each instance.

You can search for a specific instance by "instance name", "address" or "version". The list of instances can also be export to CSV or PDF.

To see available functions, hover your cursor over an instance.

The command icons appear at the end of the row: