NetWorker: Best Practices für die Netzwerkkonfiguration

• Fehler im Zusammenhang mit dem Netzwerk oder der Hostverbindung, einschließlich, aber nicht beschränkt auf:
• Fehler bei Backups, die die tatsächliche Datenübertragung abgeschlossen zu haben scheinen
• Allgemeine Erschöpfung von Ressourcen oder Kommunikationskollaps

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 ist eine Anwendung, die im normalen Betrieb viele Sockets sowohl lokal als auch auf Remotehosts erstellt. Während die Server- und Speicher-Nodes in der Regel mehr erstellen, kann sich die Clientkonfiguration auch auf den Joberfolg auswirken. 

Keepalives: Jeder Socket, der von einem NetWorker-Aufrufprozess erstellt wird, um eine Verbindung zu einem Listener-Daemon-Prozess herzustellen, und diese können unterbrochen werden, wenn sie zu lange von Netzwerkgeräten im Leerlauf gelassen werden, die versuchen, Ressourcen zurückzugewinnen. Im Allgemeinen erfordert dies, dass Keepalives für den NetWorker-Server und die Nodes standardmäßig aktiviert sind und dass Clients Probleme haben. NetWorker verfügt über eine eigene interne Keepalive-Handhabung für einige (aber nicht alle) Binärdateien. Das Betriebssystem verfügt außerdem über Keepalives, die standardmäßig aktiviert sein sollten.

Anschlussverfügbarkeit: Für jeden Socket, den NetWorker einrichten will, ist für die Kommunikation ein Port im kurzlebigen Bereich erforderlich, dieser Bereich ist jedoch standardmäßig auf allen Betriebssystemen begrenzt und sollte so weit wie möglich geöffnet werden, um die Kommunikation nicht künstlich einzuschränken. Wenn nsrauth standardmäßig aktiviert ist, beträgt die Anzahl der Ports, die für einen einzelnen gewünschten Socket erforderlich sind, mindestens 3, wobei bei jedem Fehler potenziell schnell ein erneuter Versuch unternommen wird, wobei die Ports in TIME_WAIT bleiben, bis die Verbindung erfolgreich ist. Aus diesem Grund sollte die maximal verfügbare Anzahl von Ports erhöht werden, wobei TIME_WAIT Zustände idealerweise gesenkt werden sollten.

Andere Sockel mit langer Laufzeit können auch mit bestimmten internen Softwarevariablen verstärkt werden, die eine höhere Ausfallsicherheit ermöglichen oder die Pufferung verbessern.

Im Folgenden sind die üblichen empfohlenen Einstellungen nach Betriebssystem und Hostklasse zusammen mit ihren Implementierungsbefehlen aufgeführt. Die Anwendbarkeit variiert immer; Diejenigen, die als universell wünschenswert erachtet werden, werden nicht kommentiert, während diejenigen mit variablerer Eignung kommentiert werden, aber bei Bedarf verwendet werden können. Diese Einstellungen werden in gutem Glauben als allgemeine Empfehlungen bereitgestellt, sollten jedoch vor der Implementierung von Betriebssystemadministratoren überprüft werden. Diese gelten als Best Default Best Practice alle Fälle für Server und Storage Nodes. Die Clienteignung kann je nach Konfiguration und Rolle in einer bestimmten Umgebung variieren und sollte in solchen Fällen vor der Verwendung sorgfältig geprüft werden, da verschiedene Anwendungsserverrollen mit empfohlenen Einstellungen in Konflikt stehen können – in diesen Fällen sollten die für die Rolle erforderlichen Einstellungen Vorrang haben. 

Linux: Alle entsprechenden Einstellungen sollten im Feld /nsr/nsrrc Datei, die über globale Lese-/Ausführungsberechtigungen (755) verfügen muss, um beim Start des Dienstes ausgeführt zu werden. Die standardmäßigen Standardeinträge sind unkommentiert, während nicht standardmäßige oder umständliche Optionen kommentiert werden. Ändern Sie die Verfügbarkeit von Einstellungen mit dem Präfix # in den entsprechenden Zeilen. Kürzen Sie die Datei je nach Bereitstellungsort für NetWorker-Clients, -Nodes oder -Server. Der Service muss neu gestartet werden, nachdem Änderungen vorgenommen wurden. 

### 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=30
export NW_TCP_KEEPINTVL_SECS
NW_TCP_KEEPCNT=10
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=30"
sysctl -w "net.ipv4.tcp_keepalive_probes=10"
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

 

Windows: Da die /nsr/nsrrc -Datei für Windows derzeit nicht vorhanden ist, müssen Änderungen per Batch-Datei ausgeführt werden, z.B. nsrrc.bat oder eine andere Bereitstellungsmethode. Befehle werden hier bereitgestellt, wenn eine befehlsgesteuerte Option vorhanden ist. Diese Änderungen sind global und müssen nicht wiederholt ausgeführt werden. Wie Linux's nsrrc -Datei werden die Standardeinträge nicht auskommentiert, wobei Nicht-Standard- oder Indizienoptionen kommentiert werden. Ändern Sie die Verfügbarkeit von Einstellungen mithilfe von REM in den relevanten Zeilen. Kürzen Sie die Datei je nach Bereitstellungsort für NetWorker-Clients, -Nodes oder -Server. Der Service muss neu gestartet werden, nachdem Änderungen vorgenommen wurden.

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 10000 /f
reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v TcpMaxDataRetransmissions /t REG_DWORD /d 10 /f

REM # Global NetWorker keepalive and connectivity variables
setx /m NW_TCP_KEEPIDLE_SECS 270
setx /m NW_TCP_KEEPINTVL_SECS 30
setx /m NW_TCP_KEEPCNT 10
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