NetScaler backup and restore

There are multiple ways to perform backups and restores on NetScaler. Usually you perform those backups for disaster recovery if the NetScaler corrupts, or you are performing an upgrade to NetScaler. You can manually backup and restore NetScaler configurations using the GUI, CLI, or you can use Citrix Command Center and NetScaler MAS to perform automatic backups and manual restores.

Backup and restore using GUI and CLI.

Navigate to System -> Backup and Restore -> Backup.

1-min

Specify a name for the backup and either Full or Basic backup.

Basic: Backs up configuration files only. These are the files that will change most often so you should consider frequently taking a basic backup of the NetScaler:

Folders and files that are backed up include /nsconfig/, /var/, /netscaler/, ns.conf.

Full: Backs up the same data as a basic backup however captures additional files that are less frequently updated:

Folders and files that are backed up include /nsconfig/, /var/, Certificates, License Files.

For a full list of what is backed up see http://support.citrix.com/article/CTX200418.

Click Backup.2-min

After a few moments the backup file will appear as below.3-min

Clicking on the Action button allows you to download the backup file to local HDD or perform a restore using this backup file.4-min

Backups are stored in /var/ns_sys_backup/ on NetScaler. 5-min

To perform a backup using the CLI, run command create system bbackup “backupname” -level Basic/Full6-min

You can specify Full or Basic and write a comment using the -comment switch.7-min

The new backups are now within the backup directory.8-min

The backups also show within the GUI.9-min

Run show system backup using CLI to get a list of backup on NetScaler.10-minTo restore NetScaler to a previous backup, run command restore system backup “backupname”.11-min

Now run reboot -warm, this performs a warm reboot of the NetScaler at which stage the restore will execute.12-min

You can also restore via the GUI. By default before a restore a backup is performed on the NetScaler. You can skip the backup by checking the Skip Backup box. Click Restore.13-min

Navigate to System -> Reboot.14-min

Check Warm reboot and click OK.15-min

Backup and restore using Citrix Command Center.

Citrix Command Center downloads NetScaler configuration, licence files and SSL certificate files from each discovered NetScaler and stores these files in the CCC database. As a NetScaler device is discovered or a rediscovery takes place, backups of the discovered/rediscovered device are also performed. By default backups are performed every 12 hours and a maximum of 50 backups are stored within the database.

To edit the backup schedule and frequency, navigate to Administration -> Inventory Settings.

16-min

As you can see below the archive interval is every 12 hours and the numberr of previous backups to retain is 50. You also have the check box to enable archiving once a Save Config trap is received by Citrix Command Center from the NetScaler appliance.17-min

To view backups of a NetScaler appliance, navigate to Citrix Network, click on your NetScaler and click Details.18-min

A new window pops up and at the bottom you will get a list of all the current backups. The date, time, and comments section give additional information such as the backup was created at the scheduled time.19-min

Select a backup file and click Download -> OK to save a backup to your local machine.20-min

To perform a manual backup, click Backup Config -> OK.21-min 22-min

After a few moments you will see the newly created backup. Notice the comments indicates the user requested this backup which is correct.23-min

To restore a NetScaler using a backup created with Citrix Command Center select a backup file of your choice and select Restore Configuration.24-min

Click OK. The restore takes place and you will have to restart NetScaler using GUI or CLI.25-min

Backup and restore using NetScaler MAS (Management and Analytics System).

NetScaler MAS is the newest platform to automate, manage, orchestrate and monitor appliances such as the NetScaler. It is seen as the replacement to both Citrix Command Center and NetScaler Insight Center. As a result it can perform many of the functions that you were familiar with on CCC/NSIC. Navigate to System -> Instances Backup Settings.26-min

For any instance adding to NetScaler MAS, a backup is by default going to be taken every 12 hours and a single copy will be kept. You have the otion to password protect all backups using a password of your choice. You also have the option to modify the backup interval. From what I believe, the maximum number of backup files to retain is 3 however this is not something I can confirm at this stage.27-min

To view or create a backup of an instance, navigate to Infrastructure -> Instances and select of your NetScaler then click View Backup.28-min

As yet, no automatic backups have been performed. To create one click Back Up.29-min

Specify to password protect the file. If you had of specified a global password under System -> Instances Backup Settings you would have the option to use that. Click Continue.30-min

The new backup has been successfully created.31-min

32-min

To restore check the backup file and click Restore -> Yes.33-min

Specify the backup password you used when creating the backup, click OK.34-min

You get a nice GUI view of the restore progress plus the NetScaler is automatically restarted for you.35-min

 

Note: Do not modify backup file names or modify the contents of the backup as it will invalidate the backup file and cause restores to fail.

 

 


23 Comments

  • Muhammad

    November 30, 2016

    Hi There,
    Good work.
    In case of SDX, with a PBR for Management Access configured on the VPXs, the restore process from SVM doesn’t seem to be working. We have to manually edit the backup to remove the PBR and then try. Any specific suggestions here.
    (In case of RMA, we need the SDX to be built quickly so really need the Restore process to work.)
    Thanks

    Reply
  • George Spiers

    November 30, 2016

    What are you trying to do, restore the SDX appliance or an individual VPX instance?
    Are you using MAS to do the restore or SVM?

    Reply
    • Bhavani Jajam

      February 21, 2017

      Hi George,

      Is it possible to backup entire SDX from CC?

      Reply
      • George Spiers

        February 25, 2017

        I’m pretty sure you can back up the SDX config from CC.

        Reply
    • MUHAMMAD ALI JINNAH MOHIDEEN PATHUSHA

      April 3, 2017

      Sorry about the delayed reply, I was trying to Restore the VPX instances using SVM. Any ideas?

      Reply
  • George Spiers

    April 3, 2017

    Have a closer look at the PBR. The SVM must be receiving some sort of blocked communications when trying a restore. Have a look for any relevant logs https://docs.citrix.com/en-us/sdx/11/using-logs-to-monitor-operations.html

    Reply
  • Scott

    October 10, 2017

    George I need to update the SDX hardware. I need to move several instances from the old SDX to the new one. Would you recommend a backup from one to a restore to the new one after it is up and running, licensed and certs added? Or is there another way to migrate the VMs that would be easier? Does that work or is it better to copy the nsconfig and create a new instance and load it?
    Thanks,

    Reply
    • George Spiers

      October 11, 2017

      Hi Scott. I would take the ns.conf approach on new instances built on your new SDX. Copy SSL files beforehand to the new instances then copy ns.conf to new instance, shut down old instance and reboot new instance so ns.conf is loaded in to memory.

      Reply
      • Chase Mixon

        February 1, 2018

        I know this is an old thread, so I apologize, I have an old NSGateway and I have installed a new one, is there any way to backup the config and restore to the new NSGateway? I don’t want to have to deal with the certificates or configuration of the new box.

        Reply
        • George Spiers

          February 1, 2018

          You can WinSCP to the old box and copy the certificates and ns.conf, then edit the ns.conf to replace old IPs with new then copy that plus certificates to the new box.

          Reply
          • Anonymous

            February 12, 2018

            Thanks, sorry for the late response, I found out later I could just upgrade the deployment I had, to the latest version, and it worked.

  • Pingback: NetScaler Security for the XenApp Dummy - Part 2: Design

  • Krzysztof

    December 12, 2018

    Hi George,
    I know it’s been posted couple of months ago but I have small issue.
    What you say here is all correct and as long as you have access to NetScaler you can back it up but what if NetScaler fails. You won’t be able to back it up and if you didn’t make backup just after you made changes (as most of us do) you won’t be able to restore to the latest version of NetScaler settings.
    My question is: Is there a way to automate NetScaler configuration backup to run it once a day/or week/or month and copy file to the shared location? I am not Citrix CLI guy but I know it’s possible with MS powershell to script similar thing on Windows.
    Thanks
    Krzysztof

    Reply
  • Pablo

    September 24, 2019

    Hi
    I don’t know how to make a scheduled backup to another server in version 10.5. Can you help me?
    I am not able to see the option either by web interface or by CLI.

    Best regardas

    Reply
    • George Spiers

      September 29, 2019

      Update to supported version of ADC. You can use MAS to schedule remote backups.

      Reply
  • Gregor

    November 21, 2019

    Hi George,

    Just a note. I don’t think you can perform a manual restore using a backup file which was taken with MAS/ADM. The restore “succeeds” but nothing is actually restored. The restore has to be performed with the MAS/ADM which performed the initial backup.

    Cheers,
    Gregor

    Reply
  • Pingback: Netscaler Config - How To Download Netscaler Backup Files - Support - Citrix

  • Shahi

    February 18, 2021

    Hi George,

    we are having VPX appliance, before upgrade of vpx appliance we have taken the full backup of netscaler & download that on our local machine. After upgrade our vpx appliance is not coming up and we want to restore the netscaler from the backup file which is in our local machine can we do that & how ?

    Thank you.

    Reply
  • John

    June 23, 2021

    Hello all, after perform a restore system become in cleaning configuration, but never ends tasks:

    NetScaler SDX(14020)
    Cleaning configuration

    Please wait…
    Appliance will be rebooted once restore is complete OK
    Initializing restore operation OK
    Extracting backup file OK
    Cleaning configuration PROGRESS (NEVER ENDS)
    Restoring default interface configuration OK

    DO you know what we need to do to resolv this issue:

    Reply
  • Pingback: Backup Netscaler Config - SecuredGuide

  • Rajeev kumar Mandal

    March 2, 2022

    Hi George,

    I need brief idea about the Citrix device and function, Can you provide me the link for the same so that I can got some Idea about NetScaler.

    Reply

Leave a Reply to George Spiers Cancel reply