Whamcloud - gitweb
LU-12639 tests: initialize variable sanity 317
[fs/lustre-release.git] / lustre / tests / sanity.sh
index 37e6ab7..ec3d67e 100644 (file)
@@ -53,8 +53,8 @@ fi
 if [[ $(uname -m) = aarch64 ]]; then
        # bug number:    LU-11596
        ALWAYS_EXCEPT+=" $GRANT_CHECK_LIST"
-       # bug number:    LU-11671 LU-11594 LU-11667 LU-11729
-       ALWAYS_EXCEPT+=" 45       103a      317      810"
+       # bug number:    LU-11671 LU-11594 LU-11667 LU-11729 LU-4398
+       ALWAYS_EXCEPT+=" 45       103a      317      810       817"
 fi
 
 #                                  5          12          (min)"
@@ -6312,7 +6312,7 @@ check_migrate_links() {
        # make sure hard links were properly detected, and migration was
        # performed only once for the entire link set; nonlinked files should
        # also be migrated
-       local actual=$(grep -c 'done migrate' <<< "$migrate_out")
+       local actual=$(grep -c 'done' <<< "$migrate_out")
        local expected=$(($uniq_count + 1))
 
        [ "$actual" -eq  "$expected" ] ||
@@ -6363,13 +6363,14 @@ test_56xc() {
 
        # Test 1: ensure file < 1 GB is always migrated with 1 stripe
        echo -n "Setting initial stripe for 20MB test file..."
-       $LFS setstripe -c 2 -i 0 "$dir/20mb" || error "cannot setstripe"
+       $LFS setstripe -c 2 -i 0 "$dir/20mb" ||
+               error "cannot setstripe 20MB file"
        echo "done"
        echo -n "Sizing 20MB test file..."
        truncate "$dir/20mb" 20971520 || error "cannot create 20MB test file"
        echo "done"
        echo -n "Verifying small file autostripe count is 1..."
-       $LFS_MIGRATE -y -A -C 1 "$dir/20mb" &> /dev/null ||
+       $LFS_MIGRATE -y -A -C 1 "$dir/20mb" ||
                error "cannot migrate 20MB file"
        local stripe_count=$($LFS getstripe -c "$dir/20mb") ||
                error "cannot get stripe for $dir/20mb"
@@ -6382,24 +6383,28 @@ test_56xc() {
        # sqrt(size_in_gb) + 1 OSTs but is larger than 1GB.  The file must
        # have at least an additional 1KB for each desired stripe for test 3
        echo -n "Setting stripe for 1GB test file..."
-       $LFS setstripe -c 1 -i 0 "$dir/1gb" || error "cannot setstripe"
+       $LFS setstripe -c 1 -i 0 "$dir/1gb" || error "cannot setstripe 1GB file"
        echo "done"
        echo -n "Sizing 1GB test file..."
        # File size is 1GB + 3KB
-       truncate "$dir/1gb" 1073744896 &> /dev/null ||
-               error "cannot create 1GB test file"
-       echo "done"
-       echo -n "Migrating 1GB file..."
-       $LFS_MIGRATE -y -A -C 1 "$dir/1gb" &> /dev/null ||
-               error "cannot migrate file"
-       echo "done"
-       echo -n "Verifying autostripe count is sqrt(n) + 1..."
-       stripe_count=$($LFS getstripe -c "$dir/1gb") ||
-               error "cannot get stripe for $dir/1gb"
-       [ $stripe_count -eq 2 ] ||
-               error "unexpected stripe count $stripe_count (expected 2)"
+       truncate "$dir/1gb" 1073744896 || error "cannot create 1GB test file"
        echo "done"
 
+       # need at least 512MB per OST for 1GB file to fit in 2 stripes
+       local avail=$($LCTL get_param -n llite.$FSNAME*.kbytesavail)
+       if (( avail > 524288 * OSTCOUNT )); then
+               echo -n "Migrating 1GB file..."
+               $LFS_MIGRATE -y -A -C 1 "$dir/1gb" ||
+                       error "cannot migrate 1GB file"
+               echo "done"
+               echo -n "Verifying autostripe count is sqrt(n) + 1..."
+               stripe_count=$($LFS getstripe -c "$dir/1gb") ||
+                       error "cannot getstripe for 1GB file"
+               [ $stripe_count -eq 2 ] ||
+                       error "unexpected stripe count $stripe_count != 2"
+               echo "done"
+       fi
+
        # Test 3: File is too large to fit within the available space on
        # sqrt(n) + 1 OSTs.  Simulate limited available space with -X
        if [ $OSTCOUNT -ge 3 ]; then
@@ -6407,15 +6412,15 @@ test_56xc() {
                # file size (1GB + 3KB) / OST count (3).
                local kb_per_ost=349526
 
-               echo -n "Migrating 1GB file..."
-               $LFS_MIGRATE -y -A -C 1 -X $kb_per_ost "$dir/1gb" &>> \
-                       /dev/null || error "cannot migrate file"
+               echo -n "Migrating 1GB file with limit..."
+               $LFS_MIGRATE -y -A -C 1 -X $kb_per_ost "$dir/1gb" ||
+                       error "cannot migrate 1GB file with limit"
                echo "done"
 
                stripe_count=$($LFS getstripe -c "$dir/1gb")
-               echo -n "Verifying autostripe count with limited space..."
-               [ "$stripe_count" -a $stripe_count -eq 3 ] ||
-                       error "unexpected stripe count $stripe_count (wanted 3)"
+               echo -n "Verifying 1GB autostripe count with limited space..."
+               [ "$stripe_count" -a $stripe_count -ge 3 ] ||
+                       error "unexpected stripe count $stripe_count (min 3)"
                echo "done"
        fi
 
@@ -6466,18 +6471,20 @@ test_56z() { # LU-4824
        test_mkdir $dir
        for i in d{0..9}; do
                test_mkdir $dir/$i
+               touch $dir/$i/$tfile
        done
-       touch $dir/d{0..9}/$tfile
        $LFS find $DIR/non_existent_dir $dir &&
                error "$LFS find did not return an error"
        # Make a directory unsearchable. This should NOT be the last entry in
        # directory order.  Arbitrarily pick the 6th entry
        chmod 700 $($LFS find $dir -type d | sed '6!d')
 
+       $RUNAS $LFS find $DIR/non_existent $dir
        local count=$($RUNAS $LFS find $DIR/non_existent $dir | wc -l)
 
        # The user should be able to see 10 directories and 9 files
-       [ $count == 19 ] || error "$LFS find did not continue after error"
+       (( count == 19 )) ||
+               error "$LFS find found $count != 19 entries after error"
 }
 run_test 56z "lfs find should continue after an error"
 
@@ -7321,7 +7328,7 @@ cleanup_65k() {
        do_facet $SINGLEMDS lctl --device  %$INACTIVE_OSC activate
        echo $INACTIVE_OSC "is Activate"
 
-       wait_osc_import_state mds ost$ostnum FULL
+       wait_osc_import_state mds ost$(( ostnum + 1 )) FULL
 }
 
 test_65k() { # bug11679
@@ -7381,7 +7388,7 @@ test_65k() { # bug11679
                do_facet $SINGLEMDS lctl --device  %$INACTIVE_OSC activate
                echo $INACTIVE_OSC "is Activate"
 
-               wait_osc_import_state mds ost$ostnum FULL
+               wait_osc_import_state mds ost$(( ostnum + 1 )) FULL
        done
 }
 run_test 65k "validate manual striping works properly with deactivated OSCs"
@@ -10853,6 +10860,47 @@ test_124c() {
 }
 run_test 124c "LRUR cancel very aged locks"
 
+test_124d() {
+       [ $PARALLEL == "yes" ] && skip "skip parallel run"
+       $LCTL get_param -n mdc.*.connect_flags | grep -q lru_resize ||
+               skip_env "no lru resize on server"
+
+       # cache ununsed locks on client
+       local nr=100
+
+       lru_resize_disable mdc
+       stack_trap "lru_resize_enable mdc" EXIT
+
+       cancel_lru_locks mdc
+
+       # asynchronous object destroy at MDT could cause bl ast to client
+       test_mkdir $DIR/$tdir
+       createmany -o $DIR/$tdir/f $nr ||
+               error "failed to create $nr files in $DIR/$tdir"
+       stack_trap "unlinkmany $DIR/$tdir/f $nr" EXIT
+
+       ls -l $DIR/$tdir > /dev/null
+
+       local nsdir="ldlm.namespaces.*-MDT0000-mdc-*"
+       local unused=$($LCTL get_param -n $nsdir.lock_unused_count)
+       local max_age=$($LCTL get_param -n $nsdir.lru_max_age)
+       local recalc_p=$($LCTL get_param -n $nsdir.pool.recalc_period)
+
+       echo "unused=$unused, max_age=$max_age, recalc_p=$recalc_p"
+
+       # set lru_max_age to 1 sec
+       $LCTL set_param $nsdir.lru_max_age=1000 # milliseconds
+       stack_trap "$LCTL set_param -n $nsdir.lru_max_age $max_age" EXIT
+
+       echo "sleep $((recalc_p * 2)) seconds..."
+       sleep $((recalc_p * 2))
+
+       local remaining=$($LCTL get_param -n $nsdir.lock_unused_count)
+
+       [ $remaining -eq 0 ] || error "$remaining locks are not canceled"
+}
+run_test 124d "cancel very aged locks if lru-resize diasbaled"
+
 test_125() { # 13358
        $LCTL get_param -n llite.*.client_type | grep -q local ||
                skip "must run as local client"
@@ -14444,6 +14492,41 @@ test_185() { # LU-2441
 }
 run_test 185 "Volatile file support"
 
+function create_check_volatile() {
+       local idx=$1
+       local tgt
+
+       $MULTIOP $MOUNT/.lustre/fid V${idx}Fw4096_c >&/tmp/${tfile}.fid &
+       local PID=$!
+       sleep 1
+       local FID=$(cat /tmp/${tfile}.fid)
+       [ "$FID" == "" ] && error "can't get FID for volatile"
+       $CHECKSTAT -t file $MOUNT/.lustre/fid/$FID || error "can't stat $FID"
+       tgt=$($LFS getstripe -m $MOUNT/.lustre/fid/$FID)
+       [ "$tgt" != "$idx" ] && error "wrong MDS $tgt, expected $idx"
+       kill -USR1 $PID
+       wait
+       sleep 1
+       cancel_lru_locks mdc # flush opencache
+       $CHECKSTAT -t file $MOUNT/.lustre/fid/$FID && error "can stat $FID"
+       return 0
+}
+
+test_185a(){
+       # LU-12516 - volatile creation via .lustre
+       [[ $MDS1_VERSION -ge $(version_code 2.12.55) ]] ||
+               skip "Need MDS version at least 2.3.55"
+
+       create_check_volatile 0
+       [ $MDSCOUNT -lt 2 ] && return 0
+
+       # DNE case
+       create_check_volatile 1
+
+       return 0
+}
+run_test 185a "Volatile file creation in .lustre/fid/"
+
 test_187a() {
        remote_mds_nodsh && skip "remote MDS with nodsh"
        [ $MDS1_VERSION -lt $(version_code 2.3.0) ] &&
@@ -18280,6 +18363,20 @@ test_276() {
 }
 run_test 276 "Race between mount and obd_statfs"
 
+test_277() {
+       $LCTL set_param ldlm.namespaces.*.lru_size=0
+       dd if=/dev/zero of=$DIR/$tfile bs=1M count=1
+       local cached_mb=$($LCTL get_param llite.*.max_cached_mb |
+                       grep ^used_mb | awk '{print $2}')
+       [ $cached_mb -eq 1 ] || error "expected mb 1 got $cached_mb"
+       dd if=/dev/zero of=$DIR/$tfile bs=1M count=1 \
+               oflag=direct conv=notrunc
+       cached_mb=$($LCTL get_param llite.*.max_cached_mb |
+                       grep ^used_mb | awk '{print $2}')
+       [ $cached_mb -eq 0 ] || error "expected mb 0 got $cached_mb"
+}
+run_test 277 "Direct IO shall drop page cache"
+
 cleanup_test_300() {
        trap 0
        umask $SAVE_UMASK
@@ -19293,14 +19390,13 @@ run_test 316 "lfs mv"
 test_317() {
        [ $MDS1_VERSION -lt $(version_code 2.11.53) ] &&
                skip "Need MDS version at least 2.11.53"
+       if [ "$ost1_FSTYPE" == "zfs" ]; then
+               skip "LU-10370: no implementation for ZFS"
+       fi
+
        local trunc_sz
        local grant_blk_size
 
-       if [ "$(facet_fstype $facet)" == "zfs" ]; then
-               skip "LU-10370: no implementation for ZFS" && return
-       fi
-
-       stack_trap "rm -f $DIR/$tfile" EXIT
        grant_blk_size=$($LCTL get_param osc.$FSNAME*.import |
                        awk '/grant_block_size:/ { print $2; exit; }')
        #
@@ -19308,7 +19404,8 @@ test_317() {
        # blocks count.
        #
        dd if=/dev/zero of=$DIR/$tfile bs=5M count=1 conv=fsync ||
-               error "Create file : $DIR/$tfile"
+               error "Create file $DIR/$tfile failed"
+       stack_trap "rm -f $DIR/$tfile" EXIT
 
        for trunc_sz in 2097152 4097 4000 509 0; do
                $TRUNCATE $DIR/$tfile $trunc_sz ||
@@ -20368,6 +20465,234 @@ test_420()
 }
 run_test 420 "clear SGID bit on non-directories for non-members"
 
+test_421a() {
+       local cnt
+       local fid1
+       local fid2
+
+       [ $MDS1_VERSION -lt $(version_code 2.12.54) ] &&
+               skip "Need MDS version at least 2.12.54"
+
+       test_mkdir $DIR/$tdir
+       createmany -o $DIR/$tdir/f 3
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt != 3 ] && error "unexpected #files: $cnt"
+
+       fid1=$(lfs path2fid $DIR/$tdir/f1)
+       fid2=$(lfs path2fid $DIR/$tdir/f2)
+       $LFS rmfid $DIR $fid1 $fid2 || error "rmfid failed"
+
+       stat $DIR/$tdir/f1 && error "f1 still visible on the client"
+       stat $DIR/$tdir/f2 && error "f2 still visible on the client"
+
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt == 1 ] || error "unexpected #files after: $cnt"
+
+       rm -f $DIR/$tdir/f3 || error "can't remove f3"
+       createmany -o $DIR/$tdir/f 3
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt != 3 ] && error "unexpected #files: $cnt"
+
+       fid1=$(lfs path2fid $DIR/$tdir/f1)
+       fid2=$(lfs path2fid $DIR/$tdir/f2)
+       echo "remove using fsname $FSNAME"
+       $LFS rmfid $FSNAME $fid1 $fid2 || error "rmfid with fsname failed"
+
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt == 1 ] || error "unexpected #files after: $cnt"
+}
+run_test 421a "simple rm by fid"
+
+test_421b() {
+       local cnt
+       local FID1
+       local FID2
+
+       [ $MDS1_VERSION -lt $(version_code 2.12.54) ] &&
+               skip "Need MDS version at least 2.12.54"
+
+       test_mkdir $DIR/$tdir
+       createmany -o $DIR/$tdir/f 3
+       multiop_bg_pause $DIR/$tdir/f1 o_c || error "multiop failed to start"
+       MULTIPID=$!
+
+       FID1=$(lfs path2fid $DIR/$tdir/f1)
+       FID2=$(lfs path2fid $DIR/$tdir/f2)
+       $LFS rmfid $DIR $FID1 $FID2 && error "rmfid didn't fail"
+
+       kill -USR1 $MULTIPID
+       wait
+
+       cnt=$(ls $DIR/$tdir | wc -l)
+       [ $cnt == 2 ] || error "unexpected #files after: $cnt"
+}
+run_test 421b "rm by fid on open file"
+
+test_421c() {
+       local cnt
+       local FIDS
+
+       [ $MDS1_VERSION -lt $(version_code 2.12.54) ] &&
+               skip "Need MDS version at least 2.12.54"
+
+       test_mkdir $DIR/$tdir
+       createmany -o $DIR/$tdir/f 3
+       touch $DIR/$tdir/$tfile
+       createmany -l$DIR/$tdir/$tfile $DIR/$tdir/h 180
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt != 184 ] && error "unexpected #files: $cnt"
+
+       FID1=$(lfs path2fid $DIR/$tdir/$tfile)
+       $LFS rmfid $DIR $FID1 || error "rmfid failed"
+
+       cnt=$(ls $DIR/$tdir | wc -l)
+       [ $cnt == 3 ] || error "unexpected #files after: $cnt"
+}
+run_test 421c "rm by fid against hardlinked files"
+
+test_421d() {
+       local cnt
+       local FIDS
+
+       [ $MDS1_VERSION -lt $(version_code 2.12.54) ] &&
+               skip "Need MDS version at least 2.12.54"
+
+       test_mkdir $DIR/$tdir
+       createmany -o $DIR/$tdir/f 4097
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt != 4097 ] && error "unexpected #files: $cnt"
+
+       FIDS=$(lfs path2fid $DIR/$tdir/f* | sed "s/[/][^:]*://g")
+       $LFS rmfid $DIR $FIDS || error "rmfid failed"
+
+       cnt=$(ls $DIR/$tdir | wc -l)
+       rm -rf $DIR/$tdir
+       [ $cnt == 0 ] || error "unexpected #files after: $cnt"
+}
+run_test 421d "rmfid en masse"
+
+test_421e() {
+       local cnt
+       local FID
+
+       [ $MDSCOUNT -lt 2 ] && skip "needs >= 2 MDTs"
+       [ $MDS1_VERSION -lt $(version_code 2.12.54) ] &&
+               skip "Need MDS version at least 2.12.54"
+
+       mkdir -p $DIR/$tdir
+       $LFS setdirstripe -c$MDSCOUNT $DIR/$tdir/striped_dir
+       createmany -o $DIR/$tdir/striped_dir/f 512
+       cnt=$(ls -1 $DIR/$tdir/striped_dir | wc -l)
+       [ $cnt != 512 ] && error "unexpected #files: $cnt"
+
+       FIDS=$(lfs path2fid $DIR/$tdir/striped_dir/f* |
+               sed "s/[/][^:]*://g")
+       $LFS rmfid $DIR $FIDS || error "rmfid failed"
+
+       cnt=$(ls $DIR/$tdir/striped_dir | wc -l)
+       rm -rf $DIR/$tdir
+       [ $cnt == 0 ] || error "unexpected #files after: $cnt"
+}
+run_test 421e "rmfid in DNE"
+
+test_421f() {
+       local cnt
+       local FID
+
+       [ $MDS1_VERSION -lt $(version_code 2.12.54) ] &&
+               skip "Need MDS version at least 2.12.54"
+
+       test_mkdir $DIR/$tdir
+       touch $DIR/$tdir/f
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt != 1 ] && error "unexpected #files: $cnt"
+
+       FID=$(lfs path2fid $DIR/$tdir/f)
+       $RUNAS $LFS rmfid $DIR $FID && error "rmfid didn't fail (1)"
+       # rmfid should fail
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt != 1 ] && error "unexpected #files after (2): $cnt"
+
+       chmod a+rw $DIR/$tdir
+       ls -la $DIR/$tdir
+       $RUNAS $LFS rmfid $DIR $FID && error "rmfid didn't fail (2)"
+       # rmfid should fail
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt != 1 ] && error "unexpected #files after (3): $cnt"
+
+       rm -f $DIR/$tdir/f
+       $RUNAS touch $DIR/$tdir/f
+       FID=$(lfs path2fid $DIR/$tdir/f)
+       echo "rmfid as root"
+       $LFS rmfid $DIR $FID || error "rmfid as root failed"
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt == 0 ] || error "unexpected #files after (4): $cnt"
+
+       rm -f $DIR/$tdir/f
+       $RUNAS touch $DIR/$tdir/f
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt != 1 ] && error "unexpected #files (4): $cnt"
+       FID=$(lfs path2fid $DIR/$tdir/f)
+       # rmfid w/o user_fid2path mount option should fail
+       $RUNAS $LFS rmfid $DIR $FID && error "rmfid didn't fail(3)"
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt == 1 ] || error "unexpected #files after (5): $cnt"
+
+       umount_client $MOUNT || "failed to umount client"
+       mount_client $MOUNT "$MOUNT_OPTS,user_fid2path" ||
+               "failed to mount client'"
+
+       $RUNAS $LFS rmfid $DIR $FID || error "rmfid failed"
+       # rmfid should succeed
+       cnt=$(ls -1 $DIR/$tdir | wc -l)
+       [ $cnt == 0 ] || error "unexpected #files after (6): $cnt"
+
+       # rmfid shouldn't allow to remove files due to dir's permission
+       chmod a+rwx $DIR/$tdir
+       touch $DIR/$tdir/f
+       ls -la $DIR/$tdir
+       FID=$(lfs path2fid $DIR/$tdir/f)
+       $RUNAS $LFS rmfid $DIR $FID && error "rmfid didn't fail"
+
+       umount_client $MOUNT || "failed to umount client"
+       mount_client $MOUNT "$MOUNT_OPTS" ||
+               "failed to mount client'"
+
+}
+run_test 421f "rmfid checks permissions"
+
+test_421g() {
+       local cnt
+       local FIDS
+
+       [ $MDSCOUNT -lt 2 ] && skip "needs >= 2 MDTs"
+       [ $MDS1_VERSION -lt $(version_code 2.12.54) ] &&
+               skip "Need MDS version at least 2.12.54"
+
+       mkdir -p $DIR/$tdir
+       $LFS setdirstripe -c$MDSCOUNT $DIR/$tdir/striped_dir
+       createmany -o $DIR/$tdir/striped_dir/f 512
+       cnt=$(ls -1 $DIR/$tdir/striped_dir | wc -l)
+       [ $cnt != 512 ] && error "unexpected #files: $cnt"
+
+       FIDS=$(lfs path2fid $DIR/$tdir/striped_dir/f* |
+               sed "s/[/][^:]*://g")
+
+       rm -f $DIR/$tdir/striped_dir/f1*
+       cnt=$(ls -1 $DIR/$tdir/striped_dir | wc -l)
+       removed=$((512 - cnt))
+
+       # few files have been just removed, so we expect
+       # rmfid to fail on their fids
+       errors=$($LFS rmfid $DIR $FIDS 2>&1 | wc -l)
+       [ $removed != $errors ] && error "$errors != $removed"
+
+       cnt=$(ls $DIR/$tdir/striped_dir | wc -l)
+       rm -rf $DIR/$tdir
+       [ $cnt == 0 ] || error "unexpected #files after: $cnt"
+}
+run_test 421g "rmfid to return errors properly"
+
 prep_801() {
        [[ $(lustre_version_code mds1) -lt $(version_code 2.9.55) ]] ||
        [[ $OST1_VERSION -lt $(version_code 2.9.55) ]] &&
@@ -21352,6 +21677,30 @@ test_816() {
 }
 run_test 816 "do not reset lru_resize on idle reconnect"
 
+cleanup_817() {
+       umount $tmpdir
+       exportfs -u localhost:$DIR/nfsexp
+       rm -rf $DIR/nfsexp
+}
+
+test_817() {
+       systemctl restart nfs-server.service || skip "failed to restart nfsd"
+
+       mkdir -p $DIR/nfsexp
+       exportfs -orw,no_root_squash localhost:$DIR/nfsexp ||
+               error "failed to export nfs"
+
+       tmpdir=$(mktemp -d /tmp/nfs-XXXXXX)
+       stack_trap cleanup_817 EXIT
+
+       mount -t nfs -orw localhost:$DIR/nfsexp $tmpdir ||
+               error "failed to mount nfs to $tmpdir"
+
+       cp /bin/true $tmpdir
+       $DIR/nfsexp/true || error "failed to execute 'true' command"
+}
+run_test 817 "nfsd won't cache write lock for exec file"
+
 #
 # tests that do cleanup/setup should be run at the end
 #