LogoLogo
Island Router CLI Reference Guide 2.3.2
Island Router CLI Reference Guide 2.3.2
  • Overview
  • Context Sensitive Help
  • URL Format
  • Password Encryption and Public Key Authentication
  • Command Scheduler
  • Commands
    • auto-update
      • auto-update days
      • auto-update time
    • backup
      • backup interval
      • backup url
    • clear connections
    • clear dhcp-client
    • clear dump
    • clear everything
    • clear log
    • clear network
    • clear package
    • clear pin
    • clear ssh client-keys
    • clear ssh host-keys
    • clear ssh known-hosts
    • clear syslog
    • clear update
    • clear vpn-keys
    • compact
    • configure authorized-keys
    • configure known-hosts
    • configure network
    • configure terminal
    • description
    • duplex
    • end
    • ethernet polling
    • exit
    • help
    • history
      • history empty
      • history filter
      • history interval
      • history output-format
      • history rename
      • history url
      • history utc
    • hostname
    • interface
    • ip (interface context)
      • ip address
      • ip autoconfig
      • ip autovlan
      • ip arp-scan
      • ip arp-spoof
      • ip priority
      • ip dhcp6-client
      • ip dhcp6-server
      • ip dhcp-client
      • ip dhcp-lease
      • ip dhcp-monitor
      • ip dhcp-scope
      • ip dhcp-server
      • ip ident4
      • ip ident6
      • ip mtu
      • ip nat4
      • ip nat6
      • ip router-advertise
      • ip router-solicit
    • ip (global context)
      • ip ddns name
      • ip ddns ipv6
      • ip dhcp-reserve
      • ip dns local-only
      • ip dns mode
      • ip firewall
      • ip ipv6
      • ip load-sharing
      • ip max-clients
      • ip port-forward
      • ip route
    • led level
    • login confirm
    • login console
    • login remote
    • login support
    • mac output-format
    • ntp
    • package
    • packet level
    • parent
    • password
    • ping
    • reload
    • rollback
    • show clock
    • show config authorized-keys
    • show config known-hosts
    • show dumps
    • show free-space
    • show hardware
    • show history
    • show interface
    • show interface summary
    • show interface transceivers
    • show ip dhcp-reservations
    • show ip interface
    • show ip neighbors
    • show ip recommendations
    • show ip routes
    • show ip sockets
    • show log
    • show ntp
    • show packages
    • show public-key
    • show running-config
    • show ssh-client-keys
    • show startup-config
    • show stats
    • show syslog
    • show users
    • show vpns
    • show version
    • speed
    • ssh
    • stats
    • syslog
      • syslog level
      • syslog protocol
      • syslog server
    • telnet
    • terminal
      • terminal length
      • terminal terminal-type
      • terminal width
    • timezone
    • update
    • vpn key-exchange
    • vpn peer
      • vpn peer generate client
      • vpn peer host
      • vpn peer local-ip
      • vpn peer mac
      • vpn peer name
      • vpn peer public-key
      • vpn peer remote-ip
      • vpn peer route
      • vpn peer shutdown
      • vpn peer unapproved
      • vpn peer visible
    • vpn port
    • vpn renumber
    • vpn route
    • vpn server
      • vpn server auto-trust
      • vpn server auto-visible
      • vpn server no-local
      • vpn server pool
      • vpn server secret
    • vpn sort
    • write
      • write dump
      • write memory
      • write network
      • write syslog
      • write terminal
Powered by GitBook
On this page
  • Syntax
  • Syntax Description
  • Defaults
  • Usage Guidelines
  • Examples
  • Related Commands
Export as PDF
  1. Commands
  2. write

write network

Saves a backup of the system to a network location

Previouswrite memoryNextwrite syslog

Last updated 3 months ago

Syntax

write network [days <n>] [include-keys] [nohistory] [size] <url>

Syntax Description

Keyword
Description

n

(Optional) The number of days of history data to be included in the backup.

include-keys

(Optional) If specified, the Island's private keys are included in the backup.

nohistory

(Option) No history data will be included in the backup. This is the same as days 0.

size

(Optional) If specified, an estimate of the resulting backup file in bytes will be displayed, but no file will be written.

url

(Optional) The location to where the backup file is to be written. Required unless size is specified.

Defaults

By default, 10 years of history data will be included, and private keys will not be included.

Usage Guidelines

The write network command creates a backup of the Island router and writes it to a remote file. The resulting file can be restored using the command.

If desired, historical usage data can be included in the backup file. Note that history data can dramtically increase the size of the backup file. A backup file with no history data will typically be under 1 MB. On an Island with many devices, however, each day of history data may increase the size of the backup file by tens or hundreds of megabytes. The size option can be used to get an estimate of the backup file size before actually creating the backup.

Backup files should be kept in a secure location since they may contain sensitive data.

Private security keys are not included in the backup by default. If the resulting backup is restored to another Island, or to the same Island after performing a factory reset, all VPNs will have to be deleted and recreated, and any remote access sessions from the Island app will need to be reestablished. To avoid this issue, the include-keys option can be used to include the Island's private keys in the backup. Although all Island backup files should be kept secure from access by unauthorized parties, files contining private keys are especially sensitive. Anyone with access to a backup file containing private keys could potentially gain access to the Island remotely and/or intercept its VPN communications.

Examples

write network days 3 url sftp://jane:password@my.example.com/jane-island-backup
write network days 30 size

Related Commands

Refer to the section of this document for more information on the syntax of the url parameter.

configure network
URL Format
backup
configure network