Starutil

From StarOS Community Wiki

Starutil is available from Valemount. It is used to perform the following functions with StarOS/StarV3 systems:

starutil : a configuration backup and restore utiltity v1.15
    usage: starutil ip [password] [-p port] [options ...]

      where valid options are:

  options:
       GENERAL OPTIONS:
       -s or -silent         Silent operation - only show critical errors.
       -a or -apply          Apply changes after the specified action.
       -reboot               Reboot the server after the specified action.
       -p <port>             TCP port to connect too. Default to 856.

       CONFIGURATION ACTIONS:
       -d <ofile>            Download the server's configuration.
       -u <ifile>            Upload a saved configuration.

       SCRIPT ACTIONS:
            [<scr> can be: cbq, fw, nat, proxy, dhcpd, rad_users, or rad_nas]
       -dscr <scr> <ofile>   Download the specified script.
       -uscr <scr> <ifile>   Upload the specified script.

       WIRELESS INFORMATION:
       -ci <dev>             Display card link information for selected device.
       -ai <dev> [index]     Display access point associations.

       WIRELESS OPTIONS:
       -da                   Display more information about associations (-ai).

       THOUGHPUT TEST OPTIONS:
       -rx                   Recieve throughput test
       -tx                   Transmit throughput test

       PPP USER OPTIONS:
       -dis_ppp "user"       Disconnect PPPoE / PPtP session by username
       -list_ppp             View list of logged in PPP users

       HOTSPOT USER OPTIONS:
       -dis_hot_user "user"  Disconnect hotspot based on username
       -dis_hot_ip "ip_addr" Disconnect hotspot based on IP address
       -list_hot             View list of logged in Hotspot users
       -list_hot_simple      View list of logged in Hotspot users in an easy to
                             parse format.

       HOTSPOT PAGE OPTIONS:
             [<page> can be: login, alogin, mlogin, logout, status,
                             noservice, or splash]
       -dpage <page> <ofile> Download hotspot page
       -upage <page> <ifile> Upload hotspot page

       REPORTING OPTIONS:
       -sysinfo              View system information
       -kernlog              View kernel log
       -support <ofile>      support file download

       FIRMWARE ACTIONS:
       -f <ifile>            Upload the specified firmware to the server.

  arguments:
       ip         Ip address or hostname of target server.
       password   The admin password as entered on the target server.
                  If not entered on the command-line, you will be prompted.

EXAMPLES:
  Backup a server's configuration:
    starutil 192.168.1.1 MyPass -d server.dat

  Restore the previously backed up configuration, and activate changes:
    starutil 192.168.1.1 MyPass -u server.dat -a

  Download a CBQ script:
    starutil 192.168.1.1 MyPass -dscr cbq cbq.txt

  Upload a changed CBQ script, and activate it:
    starutil 192.168.1.1 MyPass -uscr cbq cbq.txt -a

  Upload a new firmware to the server:
    starutil 192.168.1.1 MyPass -f strs-1.1x.x-xxxx.bin

You can also use StarCom