1.3.2. ISSU tools

The following commands can be used during ISSU procedure:

  1. ISSU procedure status

    fast-path.sh upgrade status
    

    This command can be used to display current ISSU procedure status. If no procedure is in progress, it returns an error. If a procedure is in progress, it returns a 0 value and displays the current ISSU stage:

    • started: ISSU procedure started

    • fp-sync-stop, fp-stop, fp-restart, fp-sync-restart: virtual acceelerator service restart

    • fp-restore-conf: restoring fastpath configuration

    • fp-takeover: switching virtual accelerator instances

  2. ISSU procedure abort

    fast-path.sh upgrade abort
    

    As long as no other ISSU command has been issued (fast-path.sh upgrade or systemctl restart command), a just started ISSU procedure can be canceled using this command.

    If ISSU procedure is in progress, only way to interrupt it is by restarting the Virtual Accelerator service. Please refer to ISSU error handling section.

  3. ISSU procedure without package upgrade

    For testing purpose, it can be useful to run ISSU procedure without upgrading packages. This can be achieved by replacing ‘dnf upgrade’ command by the following command:

    fast-path.sh upgrade no-pkg-install
    

    This commands instructs ISSU procedure to restart on the same set of packages.

  4. Running command on old Virtual Accelerator instance

    fast-path.sh upgrade exec-old
    

    This command can be used to run a fp-cli or other fp command on the old Virtual Accelerator instance during an ISSU procedure. This command is only for debug purpose.

    For example:

    [root@host ~]# fast-path.sh upgrade exec-old fp-cli port
        0: ntfp1-vr0 cached ifp=0x7f17b40f97b0
        1: ntfp2-vr0 cached ifp=0x7f17b40f9948
        5: tap0-vr0 cached ifp=0x7f17b40fbdf0
        7: tap1-vr0 cached ifp=0x7f17b40fbf88
        9: tap2-vr0 cached ifp=0x7f17b40fc120
        11: tap3-vr0 cached ifp=0x0