Advanced

1
$ ais advanced --help
2
3
NAME:
4
   ais advanced - Special commands intended for development and advanced usage
5
6
USAGE:
7
   ais advanced command [arguments...]  [command options]
8
9
COMMANDS:
10
   resilver          Resilver user data on a given target (or all targets in the cluster); entails:
11
                     - fix data redundancy with respect to bucket configuration;
12
                     - remove migrated objects and old/obsolete workfiles.
13
   preload           Preload object metadata into in-memory cache
14
   remove-from-smap  Immediately remove node from cluster map (beware: potential data loss!)
15
   random-node       Print random node ID (by default, ID of a randomly selected target)
16
   random-mountpath  Print a random mountpath from a given target
17
   rotate-logs       Rotate aistore logs
18
   enable-backend    (Re)enable cloud backend (see also: 'ais config cluster backend')
19
   disable-backend   Disable cloud backend (see also: 'ais config cluster backend')
20
   check-lock        Check object lock status (read/write/unlocked)
21
22
OPTIONS:
23
   --help, -h  Show help

1
$ ais advanced resilver # all targets will be resilvered
2
Started resilver "NGxmOthtE", use 'ais show job xaction NGxmOthtE' to monitor the progress
3
4
$ ais advanced resilver BUQOt8086  # resilver a single node
5
Started resilver "NGxmOthtE", use 'ais show job xaction NGxmOthtE' to monitor the progress

1
$ ais advanced preload ais://bucket

1
$ ais show cluster proxy
2
PROXY            MEM USED %      MEM AVAIL       UPTIME
3
BcnQp8083        0.17%           31.12GiB        6m50s
4
xVMNp8081        0.16%           31.12GiB        6m50s
5
MvwQp8080[P]     0.18%           31.12GiB        6m40s
6
NnPLp8082        0.16%           31.12GiB        6m50s
7
8
$ ais advanced remove-from-smap MvwQp8080
9
Node MvwQp 8080 is primary: cannot remove
10
11
$ ais advanced remove-from-smap p[xVMNp8081]

1
$ ais show cluster proxy
2
PROXY            MEM USED %      MEM AVAIL       UPTIME
3
BcnQp8083        0.16%           31.12GiB        8m
4
NnPLp8082        0.16%           31.12GiB        8m
5
MvwQp8080[P]     0.19%           31.12GiB        7m50s

1
$ ais show log t[kOktEWrTg]
2
3
Started up at 2023/11/07 18:06:22, host u2204, go1.21.1 for linux/amd64
4
W 18:06:22.930488 config:1713 load initial global config "/root/.ais1/ais.json"
5
...
6
...

1
$ ais advanced rotate-logs t[kOktEWrTg]
2
t[kOktEWrTg]: rotated logs
3
4
$ ais show log t[kOktEWrTg]
5
Rotated at 2023/11/07 18:07:31, host u2204, go1.21.1 for linux/amd64
6
Node t[kOktEWrTg], Version 3.21.1.69a90d64b, build time 2023-11-07T18:06:19-0500, debug false, CPUs(16, runtime=16)
7
...

1
$ ais ls s3://test-bucket
2
NAME     SIZE            CACHED
3
111      15.97KiB        yes
4
222      15.97KiB        yes
5
333      15.97KiB        no
6
444      15.97KiB        no

1
$ ais advanced disable-backend <TAB-TAB>
2
gcp     aws     azure
3
4
$ ais advanced disable-backend aws
5
cluster: disabled aws backend

1
$ ais ls s3://test-bucket
2
Error: ErrRemoteBucketOffline: bucket "s3://test-bucket" is currently unreachable

1
$ ais ls s3://test-bucket --cached
2
NAME     SIZE
3
111      15.97KiB
4
222      15.97KiB

1
$ ais get s3://test-bucket/111 /dev/null
2
GET (and discard) 111 from s3://test-bucket (15.97KiB)

1
$ ais get s3://test-bucket/333 /dev/null
2
Error: object "s3://test-bucket/333" does not exist

1
$ ais advanced enable-backend aws
2
cluster: enabled aws backend

1
$ ais ls s3://test-bucket
2
NAME     SIZE            CACHED
3
111      15.97KiB        yes
4
222      15.97KiB        yes
5
333      15.97KiB        no
6
444      15.97KiB        no
7
8
$ ais get s3://test-bucket/333 /dev/null
9
GET (and discard) 333 from s3://test-bucket (15.97KiB)

1
$ ais advanced check-lock --help
2
NAME:
3
   ais advanced check-lock - Check object lock status (read/write/unlocked)
4
5
USAGE:
6
   ais advanced check-lock BUCKET[/OBJECT_NAME_or_PREFIX] [command options]
7
8
OPTIONS:
9
   prefix     Select virtual directories or objects with names starting with the specified prefix, e.g.:
10
              '--prefix a/b/c'   - matches names 'a/b/c/d', 'a/b/cdef', and similar;
11
              '--prefix a/b/c/'  - only matches objects from the virtual directory a/b/c/
12
   max-pages  Maximum number of pages to display (see also '--page-size' and '--limit')
13
              e.g.: 'ais ls az://abc --paged --page-size 123 --max-pages 7
14
   limit      The maximum number of objects to list, get, or otherwise handle (0 - unlimited; see also '--max-pages'),
15
              e.g.:
16
              - 'ais ls gs://abc/dir --limit 1234 --cached --props size,custom,atime'  - list no more than 1234 objects
17
              - 'ais get gs://abc /dev/null --prefix dir --limit 1234'                 - get --/--
18
              - 'ais scrub gs://abc/dir --limit 1234'                                  - scrub --/--
19
   page-size  Maximum number of object names per page; when the flag is omitted or 0
20
              the maximum is defined by the corresponding backend; see also '--max-pages' and '--paged'
21
   help, h    Show help