F5 is upgrading its customer support chat feature on My.F5.com. Chat support will be unavailable from 6am-10am PST on 1/20/26. Refer to K000159584 for details.

Forum Discussion

Roman_Melekh's avatar
Roman_Melekh
Icon for Altocumulus rankAltocumulus
May 09, 2023
Solved

Backup F5 BigIP using RestAPI and PowerShell (again?)

Hello! I went through the Forum and I saw a lot of related messages but none of them actually answered my question. The documentation [I found] leaves to be desired and I hope that the community is ...
BIG-IP
devops
f5
powershell
RestAPI
Paulius's avatar
Paulius
Icon for MVP rankMVP
May 10, 2023

Roman_Melekh So config is the configuration on the device and is essentially loading what is in the config file on the device when you use the load command and saving the CLI changes you made to the config file on the device. A UCS is an archive file of the entire configuration and all settings on the F5 device. Please keep in mind that, depending on the code version, the UCS uses a master-key to encrypt and decrypt certain pieces of configuration in the UCS backup. It is important that you save the master-key of the device in a secure location so if you ever have to replace your device with a new one because the existing failed you will have to set the master-key to the same one as it was before or the UCS will not load properly. The UCS also stores the license of the device which is a unique pairing to the previous device so you will have to use the appropriate load command with the UCS so it doesn't load the license. You can use command "f5mku -K" without the quotations to view the existing master-key.

  • Paulius's avatar
    Paulius
    Icon for MVP rankMVP
    May 12, 2023

    Roman_Melekh I'm glade this worked for you. You should be able to add onto the end of the script a command that issues a delete of the existing archive file, exactly the same as you did to create the file but in this case a delete. Good luck with the SharePoint piece and if you find that the primary issue has been resolved please mark the comment that solved this for you.

    • Roman_Melekh's avatar
      Roman_Melekh
      Icon for Altocumulus rankAltocumulus
      May 12, 2023

      Yep, the command is here already:

       

      function Delete-F5ArchiveFile
{
    param 
    (
        [Parameter(Mandatory = $true)][string]$token,        
        [Parameter(Mandatory = $true)][string]$server,
        [Parameter(Mandatory = $true)][string]$UCSFileName        
    )
    
    $headers = @{
        "Content-Type" = "application/json"
        "X-F5-Auth-Token" = "$token"
    }

    $body = @{
        "command" = "run";
        "utilCmdArgs" = " -c `"rm -f /var/local/ucs/$UCSFileName`" "
    } | ConvertTo-Json


    $result = Invoke-RestMethod -Uri "https://$server/mgmt/tm/util/bash" -Method Post -Headers $headers -Body $body
    return $result
}