Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

For advanced NAKIVO Backup & Replication configuration, you can enable an expert mode. 

To do this, take the following steps:

  1. Log in to your NAKIVO Backup & Replication instance.
  2. Add the “expert” word to the URL parameters of the Settings page.
    Examples:
    https://localhost:4443/c/configuration?expert or  
    https://localhost:4443/c/configuration?action=&targetId=&backUrl=&wizard=false&expert
  3. Click the Expert tab. 

Configuring Settings

To configure advanced product settings, make the necessary changes in the following parameters:

Parameters

Description

Possible Values

system.email.smtp.localhost.mode:

Specifies how to determine the name of the localhost that is used in the SMTP HELO or EHLO commands

  • Default
  • Use DNS
  • Provide custom hostname

system.email.smtp.localhost.name:

Specifies the name of the localhost that is used in the SMTP HELO or EHLO commands. This setting is valid for custom hostname resolution mode only


system.email.notifications.skip.event.list:

List of event names to skip when creating a email digest. Use space or , or ; as separators. 

The event names can be found in events.log. 

error60

error61

other

system.vmware.esxi.ssh.port:

For VMware only. Specifies the SSH port to connect to ESXi (global setting).

  • Default value: 22
  • Minimum value: 1
  • Maximum value: 65535

system.vmware.skip.outdated.tools.checking:

For VMware only. When enabled, the system will not check VMware Tools outdated status when creating quiescing snapshot.

  • Checked
  • Unchecked (default)

system.vmware.skip.tag.discovery:

VMware only. When enabled, the system will not discover VMware Tags. This is applied to all tenants.

  • Checked
  • Unchecked (default)

system.vmware.job.run.hotadd.target.datastore.min.free.space.percent:

For VMware only. Specifies the minimum free space for the target datastore during replication job run with HotAdd enabled. If the free space goes below this value, an alarm is generated.

  • Default value: 63
  • Minimum value: 1
  • Maximum value: 100

http.max.upload.size:

VMware only. Specifies the minimum free space for the target datastore during replication job run with HotAdd enabled. If the free space goes below this value, an alarm is generated.

  • Default value: 1073741824
  • Minimum value: 1
  • Maximum value: 999999999999

system.auth.use.lockout:

Enables or disables the login lockout feature. When enabled, the offending IP address is not allowed to login after several failed attempts.

  • Checked
  • Unchecked (default)

system.auth.max.login.attempt.count:

Specifies the maximum number of failed login attempts to trigger the login lockout feature for the offending IP.

  • Default value: 5
  • Minimum value: 1
  • Maximum value: 9999

system.auth.lockout.timeout:

Specifies the timeout (minutes) for the login lockout feature. The offending IP is allowed to login again after the timeout expires.

  • Default value: 15
  • Minimum value: 1
  • Maximum value: 9999

system.auth.login.history.period:

Specifies the period (minutes) to calculate the maximum number of failed login attempts for the login lockout feature.

  • Default value: 5
  • Minimum value: 1
  • Maximum value: 9999

system.job.pool.queue.length:

Specifies the length of the job queue. A job is put into queue before execution. Requires restart.

  • Default value: 200
  • Minimum value: 10
  • Maximum value: 9999

system.job.pool.thread.min:

Specifies the minimum thread pool size for jobs. A job requires 1 thread from the job pool to start running. Requires restart.

  • Default value: 30
  • Minimum value: 10
  • Maximum value: 9999

system.job.pool.thread.max:

Specifies the maximum thread pool size for jobs. A job requires 1 thread from the job pool to start running. When the pool thread limit is reached, the job is put into the job queue. Requires restart.

If using Linux and systemd, please add to the service startup script: TasksMax=infinity

  • Default value: 200
  • Minimum value: 10
  • Maximum value: 9999


system.job.resolve.host.hostname.on.transporter:

If set, sends the source and/or target host hostname as is to Transporter. The Transporter will resolve the hostname into IP address(es) and check if it is reachable. This is done during the Transporter to host checks on a  job run.

The default behavior is to do the resolution locally and send the IP addresses to Transporter. This can be a problem in complex network topologies (VPN, etc).

  • Checked
  • Unchecked (default)

system.job.resolve.transporter.hostname.on.transporter:

If set, sends the source and/or target Transporter hostname as is to Transporter. The Transporter will resolve the hostname into IP address(es) and check if it is reachable. This is done during Transporter to Transporter checks on job run.

The default behavior is to do the resolution locally, then get hostnames for all resolved IP addresses, then send them to Transporter. This can be a problem in complex network topologies (VPN, etc).

  • Checked
  • Unchecked (default)

system.job.bandwidth.throttling.source:

If set, applies bandwidth throttling for data reading from source.

  • Checked (default)
  • Unchecked 

system.job.bandwidth.throttling.target:

If set, applies bandwidth throttling for data writing to target.

  • Checked (default)
  • Unchecked 

system.job.bandwidth.throttling.network:

If set, applies bandwidth throttling for data transfer between source and target.

  • Checked (default)
  • Unchecked

system.task.pool.queue.length:

Specifies the length of the task queue. A task is put into queue before execution. Requires restart.

  • Default value: 200
  • Minimum value: 10
  • Maximum value: 9999

system.task.pool.thread.min:

Specifies the minimum thread pool size for tasks. A task requires 1 thread from the task pool to start running. Task example: repository refresh, Transporter refresh, support bundle creation. Requires restart.

  • Default value: 30
  • Minimum value: 10
  • Maximum value: 9999

system.task.pool.thread.max:

Specifies the maximum thread pool size for tasks. A task requires 1 thread from the task pool to start running. When the pool thread limit is reached, the task is put into the task queue. Task example: repository refresh, Transporter refresh, support bundle creation. Requires restart.

  • Default value: 200
  • Minimum value: 10
  • Maximum value: 9999


system.repository.min.free.space.byte:

Specifies the minimum free space (bytes) for the repository. If the free space goes below this value, an alarm is generated.

  • Default value: 5368709120
  • Minimum value: 1024
  • Maximum value: 1099511627776

system.repository.min.free.space.percent:

Specifies the minimum free space (percent) for the Backup repository. If the free space goes below this value, an alarm is generated.

  • Default value: 5
  • Minimum value: 1
  • Maximum value: 99

system.repository.maintenance.interrupt.timeout.seconds:

Specifies the timeout (seconds) to wait for repository maintenance stop during job run.

  • Default value: 300
  • Minimum value: 1
  • Maximum value: 86400

system.debug.mode.enabled:

The debug mode prints more information into the logs, including some sensitive one (hardware UUIDs, MAC addresses, etc). The passwords are not printed, unless they are present in raw communication dumps (e.g. SOAP/XML/JSON).

  • Checked
  • Unchecked (default)

system.debug.mode.log.passwords:

When debug mode is enabled, also log passwords. This can be a security risk.

  • Checked
  • Unchecked (default)

system.debug.mode.log.api.requests:

When debug mode is enabled, also log product API requests/responses. The data is logged as is and will contain plaintext passwords. This can be a security risk.

  • Checked
  • Unchecked (default)

system.hyperv.optimize.queries:

Hyper-V only. Instructs to use a faster query method to read VM and host information. This will speed up the refresh process in large environments.

  • Checked (default)
  • Unchecked 

system.hyperv.discovery.host.thread.count:

Hyper-V only. Sets the max parallel threads to run when refreshing cluster hosts during discovery. Each cluster host can be refreshed separately. This will speed up the refresh process in large environments.

  • Default value: 20
  • Minimum value: 1
  • Maximum value: 20

system.hyperv.discovery.vm.thread.count:

Hyper-V only. Sets the max parallel threads to run when refreshing host VMs during discovery. When increasing the setting value, make sure to test its influence on host CPU usage during refresh. This will speed up the refresh process in large environments.

  • Default value: 2
  • Minimum value: 1
  • Maximum value: 10

system.database.scheduled.backup.path:

Hyper-V only. Sets the max parallel threads to run when refreshing host VMs during discovery. When increasing the setting value, make sure to test its influence on host CPU usage during refresh. This will speed up the refresh process in large environments.

  • Text field 
  • Optional
  • Default value: "userdata"

system.database.scheduled.backup.max.count:

Specifies the maximum number of files for periodic database backups. The number is applied separately to each tenant database. The master and tenants product databases are backed up each day.

  • Default value: 5
  • Minimum value: 0
  • Maximum value: 365

system.logging.max.index:

Specifies the max index of a the log files. This works globally for all log files. Set 0 to use default value (configured in log4j.xml).

  • Default value: 0
  • Minimum value: 0
  • Maximum value: 999

system.product.min.free.space.byte:

Specifies the minimum free space (bytes) for the product installation folder. If the free space goes below this value, an alarm is generated.

  • Default value: 2147483648
  • Minimum value: 10485760
  • Maximum value: 10737418240

system.product.free.memory.threshold:

Specifies the minimum ratio for JVM free memory. If the free JVM memory goes below this value, an alarm is generated.

  • Default value: 0.1
  • Minimum value: 0.01
  • Maximum value: 0.9

system.nutanix.discovery.vm.thread.count:

Nutanix AHV only. Sets the max parallel threads to run when refreshing host VMs during discovery. When increasing the setting value, make sure to test its influence on host CPU usage during refresh. This will speed up the refresh process in large environments.

  • Default value: 2
  • Minimum value: 1
  • Maximum value: 10

system.plugin.flr.operation.timeout.seconds:

Specifies the timeout (seconds) to wait for plugin session FLR/OLR. This is a low-level setting that is only sent to Transporter and used during iSCSI interaction.

  • Default value: 900
  • Minimum value: 1
  • Maximum value: 86400

system.physical.skip.os.checking:

Physical Windows host discovery only. When enabled, the system will not check supported OS version.

  • Checked
  • Unchecked (default)

system.transporter.agent.injection.skip.vc.redist:

When enabled, the system will not automatically install VC redistributable during Transporter/agent injection.

  • Checked
  • Unchecked (default)

system.transporter.load.max.time.created.state.hours:

Specifies the timeout (hours) to wait for getting Transporter load request. Default is 3 hours.

  • Default value: 3
  • Minimum value: 1
  • Maximum value: 72

system.transporter.modern.min.heap.size.megabyte:

Megabytes.

The -Xms option sets the initial and minimum Java heap size. The Java heap (the “heap”) is the part of the memory where blocks of memory are allocated to objects and freed during garbage collection.

Note: Transporter restart is required to apply the setting.

  • Default value: 512
  • Minimum value: 256
  • Maximum value: 65536


system.transporter.modern.max.heap.size.megabyte:

Megabytes.

This option sets the maximum Java heap size. The Java heap (the “heap”) is the part of the memory where blocks of memory are allocated to objects and freed during garbage collection. Depending upon the kind of operating system you are running, the maximum value you can set for the Java heap can vary.

Notes:

-Xmx does not limit the total amount of memory that the JVM can use.

Transporter restart is required to apply the setting.

  • Default value: 3072
  • Minimum value: 256
  • Maximum value: 65536


system.transporter.modern.thread.stack.size.kilobyte:

Kilobytes.

-Xss sets the thread stack size. Thread stacks are memory areas allocated for each Java thread for their internal use. This is where the thread stores its local execution state.

Note: Transporter restart is required to apply the setting.

  • Default value: 512
  • Minimum value: 64
  • Maximum value: 2048


system.transporter.modern.job.handler.max.thread.count:

Specifies the job thread count for modern Transporter.

Note: 1 job thread equals ~200MB of memory, consider changing the related setting.

Note: Transporter restart is required to apply the setting.

  • Default value: 10
  • Minimum value: 1
  • Maximum value: 128


system.deleted.users.groups.remove.frequency:

Specifies the schedule time for removing unnecessary deleted users, groups (in second).

  • Default value: 86400
  • Minimum value: 300
  • Maximum value: 1.7976931348623157e+308

system.hyperv.force.agent.vss:

Fo Hyper-V only. When enabled, the system will force Agent based VSS.

  • Unchecked (default)
  • Checked 

system.inventory.allow.duplicated:

Microsoft 365 and Physical only. When enabled, the system will allow duplicated discovery items.

  • Unchecked (default)
  • Checked 

system.inventory.optimize.discovery.time:

Microsoft 365 (SharePoint) only. When enabled, the system will skip some attributes to optimize the discovery time.

  • Unchecked (default)
  • Checked 

system.0365.suppress.throttling.event:

Suppress throttling warning.

  • Unchecked (default)
  • Checked 

Configuring Actions View

Click on the Actions tab to configure the following actions:

  • Remove all events: By clicking on the link, you can remove all events/alarms/etc for the current tenant. 
  • Forget all passwords (except users): By clicking on the link, you will set the stored passwords to “” for the current tenant items. The only exception is the user passwords, they must be set manually.

In the text box, you can see the report on the actions.

Example 1

Request 1: sending (Remove all events)...

Request 1: success=true (Remove all events).

Example 2

Request 1: sending (Forget all passwords (except users))...
Request 1: success=true (Forget all passwords (except users)).

Packages

By clicking on the Packages tab, you can see the following information:

  • Base local path: packages. Location of packages in product installation directory
  • List of Existing packages 
  • List of Supported packages
  • No labels