Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. Veritas NetBackup™ Administrator's Guide, Volume I
  3. Section II. Configuring hosts
  4. Configuring Host Properties
  5. Configuration options for NetBackup servers
  6. CLIENT_READ_TIMEOUT option for NetBackup servers
Veritas NetBackup™ Administrator's Guide, Volume I

CLIENT_READ_TIMEOUT option for NetBackup servers

The CLIENT_READ_TIMEOUT option specifies the number of seconds that NetBackup waits for a response from a client before the operation attempt fails. For example, if the master server does not get a response from a client within the CLIENT_READ_TIMEOUT period, the backup or restore operation fails.

Table: CLIENT_READ_TIMEOUT information

Usage

Description

Where to use

On NetBackup master and media servers.

How to use

Use the nbgetconfig and the nbsetconfig commands to view, add, or change the option.

For information about these commands, see the NetBackup Commands Reference Guide.

Use the following format:

CLIENT_READ_TIMEOUT = seconds

By default, CLIENT_READ_TIMEOUT is not present on the server or the database agent and the client-read timeout is 300 seconds (five minutes). This time is a reasonable default. Change only in the event of problems.

CLIENT_READ_TIMEOUT on a database agent is a special case because these types of clients can initially require more time to get ready than other clients. Database backup utilities frequently start several backup jobs at the same time, which can slow the CPU.

The sequence on a database agent is as follows:

  • NetBackup on the database agent reads the client's CLIENT_READ_TIMEOUT to find the value to use initially. If the option is not set, the standard default of five minutes is used.

  • When the database agent API receives the server's value, it uses it as the CLIENT_READ_TIMEOUT.

Veritas recommends increasing the timeout value on the master and media server in the following situations:

  • For database agents, a setting of 15 minutes is adequate for many installations.

  • Backing up directly to a CloudCatalyst storage server. If the value is not increased, you may see jobs failing with the following message in the job details:

    Error bpbrm (pid=119850) socket read failed: errno = 62 - Timer expired

    Note that increasing the timeout is not needed it you use a storage lifecycle policy to first back up to an MSDP storage server and then duplicate the data to an MSDP cloud storage server using an optimized duplication operation. (This is the recommended method of operation.)

Note:

If using the bpstart_notify script: The Client read timeout (CLIENT_READ_TIMEOUT option) must be equal to or greater than the Backup start notify timeout (BPSTART_TIMEOUT option). If the Client read timeout is less than the Backup start notify timeout, the job can timeout while the bpstart_notify script is running.

Example

The following example configures a client read timeout of 15 minutes.

CLIENT_READ_TIMEOUT = 900

Equivalent Administration Console property

NetBackup Management > Host Properties > Click Master Servers or Media Servers > Double-click on server > Timeouts > Client read timeout.

See Timeouts properties.

Feedback

Was this page helpful?
Previous

CLIENT_PORT_WINDOW option for NetBackup servers and clients

Next

CLIENT_RESERVED_PORT_WINDOW option for NetBackup servers and clients

Feedback

Was this page helpful?