NetWorker: Best practices voor netwerkconfiguratie

• Fouten met betrekking tot netwerk- of hostconnectiviteit, inclusief maar niet beperkt tot:
• Fouten van back-ups die de daadwerkelijke dataoverdracht lijken te hebben voltooid
• Gegeneraliseerde uitputting van middelen of ineenstorting van de communicatie

GSS warning Session information (number hex:hex) registered by user for nsrexecd has expired because a NetWorker daemon had not requested it after 120 minutes
GSS error Session information (number hex:hex) was requested by nsrmmd but the session has expired
RPC severe Unable to query NSR database for list of configured devices: RPC receive operation failed; peer = ip_addr:port, errno = Connection timed out
RPC severe Unable to query NSR database for list of configured devices: RPC send operation failed; peer = ip_addr:port, errno = Broken pipe
NSR notice Chunking ssid ssid failed, because saveset was aborted
ddp_open_file_ext() failed for File: //mtree/vol_dir/nn/nn/long_ssid, Err: 5004-nfs lookup failed (nfs: No such file or directory) ).
NSR critical Connectivity check request is failed for: SN_CONN_REPORT_DD type data_domain device
RPC error RPC client handle: No route to host.
RPC error RPC client handle: Connection refused.
RPC error Unable to create the connection with 'portmapper' to host 'hostname' with address 'ip_addr' at port number 7938.
RPC critical Aborting client connection from ip_addr: Connection timed out.
RPC critical Check whether the firewall is blocking the client ports on the host 'hostname'.
RPC critical Check whether the client services are running on the host 'hostname'.

NetWorker is een applicatie die tijdens reguliere bewerkingen veel sockets creëert, zowel lokaal als naar externe hosts. Hoewel de server- en storageknooppunten over het algemeen meer creëren, kan de clientconfiguratie ook van invloed zijn op het succes van taken. 

Keepalives: NetWorker-aanroepprocessen maken sockets om verbinding te maken met listener-daemons, maar inactieve verbindingen kunnen worden onderbroken door netwerkapparaten die ongebruikte bronnen terugwinnen. Over het algemeen vereist dit dat keepalives standaard zijn ingeschakeld voor de NetWorker-server en -knooppunten en clients die problemen ondervinden. NetWorker heeft zijn eigen interne keepalive-afhandeling voor sommige (maar niet alle) binaire bestanden. Het besturingssysteem heeft ook keepalives die standaard moeten worden ingeschakeld.

Beschikbaarheid van poorten: NetWorker-sockets hebben kortstondige poorten nodig om te communiceren, maar het besturingssysteem beperkt dit bereik standaard: breid het volledig uit om te voorkomen dat de communicatie wordt beperkt of onderbroken. Met nsrauth Ingeschakeld (standaard), elke socket heeft ten minste drie poorten nodig; Fouten worden snel opnieuw geprobeerd, waarbij poorten in TIME_WAIT blijven totdat een succesvolle verbinding tot stand is gebracht. Om deze reden moet het maximaal beschikbare aantal poorten worden verhoogd, waarbij TIME_WAIT statussen idealiter worden verlaagd.

Andere sockets met een lange looptijd kunnen ook worden versterkt met specifieke interne softwarevariabelen die een hogere tolerantie mogelijk maken of de buffering verbeteren.

Hieronder volgen de gebruikelijke aanbevolen instellingen per besturingssysteem en hostklasse, samen met de bijbehorende implementatieopdrachten. De toepasbaarheid varieert altijd; Degenen die als universeel wenselijk worden beschouwd, worden niet becommentarieerd, terwijl die met een meer variabele geschiktheid wel worden becommentarieerd, maar beschikbaar zijn voor gebruik naar behoefte. Deze instellingen worden te goeder trouw verstrekt als algemene aanbevelingen, maar moeten vóór implementatie worden gecontroleerd door administrators van besturingssystemen. Deze worden beschouwd als de beste standaard best practice voor alle cases voor servers en storageknooppunten. De geschiktheid van de client is afhankelijk van de configuratie en rol; Conflicterende serverrollen kunnen de aanbevolen instellingen overschrijven, dus rolspecifieke vereisten moeten prioriteit hebben bij de implementatie.

Linux: Alle juiste instellingen moeten worden ingevoerd in de /nsr/nsrrc bestand, dat algemene machtigingen voor lezen/uitvoeren (755) moet hebben om te kunnen worden uitgevoerd bij het opstarten van de service. De standaard standaardvermeldingen zijn zonder commentaar, met niet-standaard of indirecte opties met commentaar. Beschikbaarheid van instellingen wijzigen met behulp van # voorvoegsel op de betreffende regels. Trim het bestand indien relevant voor NetWorker-clients, -knooppunten of -servers, afhankelijk van waar u het bestand implementeert. Opnieuw starten van de service is vereist nadat wijzigingen zijn aangebracht. 

### GENERAL USAGE AND CONFIRMATION OF ENGAGEMENT
# This file will only be read, parsed and executed if permissions are set to 755 EXACTLY.
# Note that for Linux / Unix systems, it will only be engaged at service startup time, and will only 
# affect NetWorker runtime environment, overriding system settings, but leaving them in place for all
# other operations. Changes to nsrrc require service restart to be engaged. To confirm parameters
# are being engaged, check /nsr/nsrrc.log for datestamps and values. See end of script for details.

### LINUX - For all NetWorker hosts - Clients, Nodes and Server
NSR_KEEPALIVE_WAIT=10
export NSR_KEEPALIVE_WAIT
NSR_EXEC_MAX_AUTH_THREADS=50
export NSR_EXEC_MAX_AUTH_THREADS
# NSR_SOCK_BUF_SIZE=65536 # (262144 for 10 Gb ETH NICs)
# export NSR_SOCK_BUF_SIZE

# NetWorker internal keepalive settings for some, but not all binaries - 4.5 minutes to ensure keepalives are passed before the increasingly common 5 minute router idle socket kill timer
NW_TCP_KEEPIDLE_SECS=270
export NW_TCP_KEEPIDLE_SECS
NW_TCP_KEEPINTVL_SECS=75
export NW_TCP_KEEPINTVL_SECS
NW_TCP_KEEPCNT=20
export NW_TCP_KEEPCNT

# OS-level keepalive values - also set to 4.5 minutes for the same reason
sysctl -w "net.ipv4.tcp_keepalive_intvl=75"
sysctl -w "net.ipv4.tcp_keepalive_probes=20"
sysctl -w "net.ipv4.tcp_keepalive_time=270"

# Set kernel limits to ensure core dump generation
ulimit -Sn 262144
ulimit -Sc unlimited

### For NetWorker Storage Nodes and Server
# Set kernel limits to provide maximum file descriptor availability
ulimit -Hn 262144
ulimit -Hc unlimited

# Globally disable IPv6, if it is not necessary for operation:
# sysctl -w "net.ipv6.conf.all.disable_ipv6=1"

# Disable dynamic TCP window scaling - requires compatible equipment in the data path, as well as ECN
sysctl -w "net.ipv4.tcp_window_scaling=0"
sysctl -w "net.ipv4.tcp_ecn=0"

# Raise connection backlog (hash tables) to the maximum value allowed if desired
# sysctl -w "net.ipv4.tcp_max_syn_backlog=8192"
# sysctl -w "net.core.netdev_max_backlog=8192" # (For 10 Gb Eth use the value = 30000)

# Raise memory size available for TCP buffers as needed
# sysctl -w "net.core.rmem_default=262144"
# sysctl -w "net.core.wmem_default=262144"
# sysctl -w "net.core.rmem_max=16777216"
# sysctl -w "net.core.wmem_max=16777216"
# sysctl -w "net.ipv4.tcp_rmem=8192 524288 16777216"
# sysctl -w "net.ipv4.tcp_wmem=8192 524288 16777216"

# Increase shared memory pool if required - particularly for immediate mode on Storage Nodes
# sysctl -w kernel.shmmax = 2147483648 # - e.g. 2 GB
# sysctl -w kernel.shmall = 2147483648 # - e.g. 2 GB

# Available TCP client ephemeral port range increase from default:
sysctl -w "net.ipv4.ip_local_port_range=10000 64000"

# Enable TCP Time Wait Reuse for very high load servers and nodes to increase socket reuse availability
sysctl -w "net.ipv4.tcp_tw_recycle=0"
sysctl -w "net.ipv4.tcp_tw_reuse=2"

# Lower TIME_WAIT delay to close connections more quickly. This may not be necessary in concert with tw_reuse.
# sysctl -w "net.ipv4.tcp_fin_timeout=30"

# NFS I/O concurrency:
sysctl -w "sunrpc.tcp_slot_table_entries=128"
sysctl -w "sunrpc.udp_slot_table_entries=128"

### For NetWorker Server only
# Settings to increase device resilience for cloud operations or other potentially high-latency devices
# NSR_DEVOP_TIMEOUT=3600
# export NSR_DEVOP_TIMEOUT
# NSR_DEVOP_POLLING_INTERVAL=600
# export NSR_DEVOP_POLLING_INTERVAL
# NSR_DEVOP_INQUIRY_TIMEOUT=900
# export NSR_DEVOP_INQUIRY_TIMEOUT

### Media database tunables
# NSR_TCP_READ_LONG_WAIT=Y
# export NSR_TCP_READ_LONG_WAIT
# NSR_MAX_MEDIADB_RETRY=10
# export NSR_MAX_MEDIADB_RETRY
# MMDB_SQLITE_CONFIGURE_MEMORY=1
# export MMDB_SQLITE_CONFIGURE_MEMORY
# MMDB_SQLITE_PAGECACHE_SIZE=65536
# export MMDB_SQLITE_PAGECACHE_SIZE
# MMDB_SQLITE_PAGE_COUNT=65536
# export MMDB_SQLITE_PAGE_COUNT
# MMDB_SQLITE_HEAP_SIZE=1073741824
# export MMDB_SQLITE_HEAP_SIZE
# MDB_SQLITE_HEAP_MIN_ALLOC_SIZE=128
# export MDB_SQLITE_HEAP_MIN_ALLOC_SIZE

### NetWorker VMware Protection (NVP) Specific Tunables
## Increase the inventory (nsrvim) default timeout 
# GST_VBA_TIMEOUT=7200
# export GST_VBA_TIMEOUT
# NSR_HYPERVISOR_QUERY_REQUEST_TIMEOUT=3600
# export NSR_HYPERVISOR_QUERY_REQUEST_TIMEOUT

## NW server interval to change VMware inventory (nsrvim) frequency (Default is 15 minutes)
## NOTE only supported in 19.10.0.0 and later
# NSRVIM_TIME_INTERVAL=60 # Interval is in minutes and can be set between 15 and 60.
# export NSRVIM_TIME_INTERVAL

# Confirmation parameters added to end of script - comment or modify as desired.
echo "### $(date +%FT%T) - Starting with nsrrc parameters ###" >> /nsr/nsrrc.log 
sysctl -a >> /nsr/nsrrc.log 
env >> /nsr/nsrrc.log 
ulimit -a >> /nsr/nsrrc.log

Windows: Aangezien de /nsr/nsrrc bestand bestaat niet voor Windows, moeten wijzigingen worden uitgevoerd met behulp van een batchbestand, bijvoorbeeld nsrrc.bat of een andere implementatiemethode. Opdrachten worden hier geboden waar een opdrachtgestuurde optie bestaat. Deze wijzigingen zijn wereldwijd en hoeven niet herhaaldelijk te worden uitgevoerd. Net als Linux nsrrc bestand, zijn de standaard standaardvermeldingen zonder commentaar, met niet-standaard- of indirecte opties met commentaar. Beschikbaarheid van instellingen wijzigen met behulp van REM voorvoegsel op de betreffende regels. Trim het bestand indien relevant voor NetWorker-clients, -knooppunten of -servers, afhankelijk van waar u het bestand implementeert. Opnieuw starten van de service is vereist nadat wijzigingen zijn aangebracht.

REM ### WINDOWS - For all NetWorker hosts - Clients, Nodes and Server
REM # TCP window size tuning - greater throughput / Data Domain
REM reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AFD\Parameters /v DefaultSendWindow /t REG_DWORD /d 262144 /f
REM reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AFD\Parameters /v DefaultReceiveWindow /t REG_DWORD /d 262144 /f
REM reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v GlobalMaxTcpWindowSize /t REG_DWORD /d 262144 /f
REM reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v TcpWindowSize /t REG_DWORD /d 262144 /f

REM # Global keepalive registry settings - 270s to fall below common idle socket timer kills of 300s
reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v KeepAliveTime /t REG_DWORD /d 270000 /f
reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v KeepAliveInterval /t REG_DWORD /d 75000 /f
reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v TcpMaxDataRetransmissions /t REG_DWORD /d 20 /f

REM # Global NetWorker keepalive and connectivity variables
setx /m NW_TCP_KEEPIDLE_SECS 270
setx /m NW_TCP_KEEPINTVL_SECS 75
setx /m NW_TCP_KEEPCNT 20
setx /m NSR_KEEPALIVE_WAIT 10
setx /m NSR_EXEC_MAX_AUTH_THREADS 50
REM setx /m NSR_SOCK_BUF_SIZE=65536 # (262144 for 10 Gb Eth NICs)

REM ### For NetWorker Storage Nodes and Server
REM # Standard TCP features - disable in case of disconnections
REM netsh interface tcp set global rss=disabled
REM netsh interface tcp set global autotuning=disabled
REM netsh interface tcp set global ecncapability=disabled
REM netsh interface tcp set global timestamps=default

REM # Port range availability for TCP client callers
netsh int ipv4 set dynamicport tcp start=10000 num=54000
netsh int ipv4 set dynamicport udp start=10000 num=54000
netsh int ipv6 set dynamicport tcp start=10000 num=54000
netsh int ipv6 set dynamicport udp start=10000 num=54000

REM # Global port maximum (deprecated) and TIME_WAIT window
REM reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v MaxUserPort /t REG_DWORD /d 65535 /f
reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v TcpTimedWaitDelay /t REG_DWORD /d 30 /f

REM # Disable IPv6 if not required
REM reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters /v DisabledComponents /t REG_DWORD /d 0x000000ff /f

REM ### For NetWorker Server only
REM # Settings to increase device resilience for cloud operations or other potentially high-latency devices
REM setx /m NSR_DEVOP_TIMEOUT 3600
REM setx /m NSR_DEVOP_POLLING_INTERVAL 600
REM setx /m NSR_DEVOP_INQUIRY_TIMEOUT 900

REM ### Settings for media database tuning
REM setx /m NSR_TCP_READ_LONG_WAIT Y
REM setx /m NSR_MAX_MEDIADB_RETRY 10
REM setx /m MDB_SQLITE_HEAP_MIN_ALLOC_SIZE 128
REM setx /m MMDB_SQLITE_CONFIGURE_MEMORY 1
REM setx /m MMDB_SQLITE_HEAP_SIZE 1073741824
REM setx /m MMDB_SQLITE_PAGE_COUNT 65536
REM setx /m MMDB_SQLITE_PAGECACHE_COUNT 65536
REM setx /m MMDB_SQLITE_TMP path_to_temp_dir

REM ### NetWorker VMware Protection (NVP) Specific Tunables
REM ## Increase the inventory (nsrvim) default timeout 
REM setx /m GST_VBA_TIMEOUT 7200
REM setx /m NSR_HYPERVISOR_QUERY_REQUEST_TIMEOUT 3600

REM ## NW server interval to change VMware inventory (nsrvim) frequency (Default is 15 minutes)
REM ## NOTE only supported in 19.10.0.0 and later
REM setx /m NSRVIM_TIME_INTERVAL 60 
REM ## Interval is in minutes and can be set between 15 and 60.

NetWorker-processen en -poorten
Networker: Communicatie via een firewall testen