Application Delivery Management

Attach an extra disk to NetScaler Console

NetScaler Console storage requirement is determined based on your NetScaler Console sizing estimation. By default, NetScaler Console provides you a storage capacity of 120 GB. If you need more than 120 GB for storing your data, you can attach an extra disk.

Note:

  • Estimate storage requirements and attach an extra disk to the server.

  • For a NetScaler Console single-server deployment, you can attach only one disk to the server in addition to the default disk.

  • For a NetScaler Console high availability deployment, you must attach an extra disk to each node. The size of both disks must be the same.

  • If there is an existing external disk of lower capacity, you must remove the disk before attaching a new disk.

  • We recommend using solid-state drive (SSD) technology for NetScaler Console deployments.

This document explains the following scenarios about attaching an extra, new disk, creating partitions, and resizing the additional disks:

  1. Attach an extra disk in a standalone NetScaler Console

  2. Launch the disk partition tool

  3. Create partitions in the new additional disk

  4. Resize the partitions in the existing additional disk

  5. Remove the partitions in the additional disk

Attach an extra disk in a standalone NetScaler Console

  1. Shut down the NetScaler Console virtual machine.

  2. In the hypervisor, attach an extra disk of the required disk size to the NetScaler Console virtual machine.

    The newly attached larger disk stores the database data and NetScaler Console log files. The existing default disk of 120 gigabytes is now used to store the core files, operating system log files, and so on.

  3. Start the NetScaler Console virtual machine.

Launch the disk partition tool

NetScaler Console now provides NetScaler Console disk partition tool, a new command line tool.

  1. Using the tool, you can create partitions in the newly added extra disk.

  2. You can also resize the existing extra disks using the tool. But the existing external disk must not be greater than 2 terabytes.

    Note:

    • Resizing existing disks beyond 2 terabytes might cause data loss. This is because of a known limitation on the platform.

    • To create a storage capacity greater than 2 terabytes, you must remove the existing partitions and create partitions using this new tool.

  3. Using this new tool, you can do any partition action on the disk explicitly. The tool provides you with clear visibility and control over the disk and the associated data.

    Note:

    You can only use this tool on the additional disk that you have attached to the NetScaler Console server. You cannot create partitions in the primary (default) disk using this tool.

To launch the disk partition tool:

  1. Open an SSH connection to the NetScaler Console by using an SSH client, such as PuTTY.

  2. Log on to the NetScaler Console by using the nsrecover/nsroot credentials.

  3. Switch to the shell prompt and type:

    /mps/DiskPartitionTool.py
    <!--NeedCopy-->
    

    Disk partition tool

    Note:

    For NetScaler Console in high availability deployment, you must launch the tool in both nodes and create or resize partitions after attaching disks to the respective virtual machines.

Create partitions in the new additional disk

The create command is used to create partitions whenever a new secondary disk is added. You can also use this command to create partitions on an existing secondary disk after the existing partitions are deleted using the “remove” command.

Create command 1

Note:

There is no 2 terabytes size limitation while creating partitions with the disk partition tool. The tool can create partitions larger than 2 terabytes. When you partition the disk, a swap partition of size 32 GB is automatically added. The primary partition then uses all the remaining space on the disk.

Once the command is run, a GUID partition table (GPT) partition scheme is created. Also a 32 GB swap partition and data partition are created to use rest of the space. A new file system is then created on the primary partition.

Note:

This process can take a few seconds, and you must not interrupt the process.

Create command 2

Create command 3

Once the create command completes, the virtual machine is automatically restarted for the new partition to get mounted.

Create command 3

After the restart, the new partition is mounted at /var/mps.

New partition

The swap partition added shows up as swap space in the output of the “create” command.

Swap partition

Note:

The tool restarts the virtual machine after the partition is created.

Resize the partitions in the existing additional disk

You can use the resize command to resize the attached (secondary) disk. You can resize a disk that has a master boot record (MBR) or GPT scheme. The size of the disk must be less than 2 terabytes in size.

Note:

  • The resize command is designed to function without losing any existing data. But we recommend that you back up critical data in this disk to external storage before resizing. Data backup is helpful in cases where the disk data can get corrupted during the resize operation.

  • Make sure you increase the disk space in increments of 100 GB of space while resizing the partitions. An incremental increase of this kind ensures that you won’t have to resize more frequently.

Resize partition

The resize command checks for all preconditions and proceeds if all preconditions are met and after you have given consent to resizing. It stops the processes accessing the disk, which includes the NetScaler Console subsystems, PostgreSQL DB processes, and the NetScaler Console monitor process. Once the processes are stopped, the disk is unmounted to prepare it for resizing. The resizing is done by extending the partition to occupy the complete available space and then growing the file system. If a swap partition exists on the disk, it is deleted and recreated at the end of the disk after resizing. The swap partition is discussed in the Create command section of the document.

Note:

The “growing file system” process can take some to complete and take care that you do not interrupt the process while it is in progress. The tool restarts the virtual machine after you have resized the partition. Growing file system 1

Growing file system 2

All the intermediate steps in the resize process (stopping applications, resizing disk, growing filesystem) are shown on the console. Once the process completes, the following message is seen.

Resize done

After rebooting, the increase in size can be observed using the df command. Here’s the before and after details when you increase the size:

Before and after details

Remove the partitions in the additional disk

An existing partition on the secondary disk can be resized up to 2 terabytes. This issue is because of a known limitation on the partition. If you want a disk larger than 2 terabytes, either attach a new disk and partition it by using the disk partition tool. You can also remove the existing partition by using the remove command, and then create a partition.

Note:

Removing the existing partition deletes all existing data. So, any critical data must be backed up to external storage before using this command.

Remove existing partition

Running the “remove” command asks you for confirmation and once confirmed, it stops all processes (such as NetScaler Console subsystems, PostgreSQL processes, and NetScaler Console monitors) using the secondary disk. If a swap partition exists and swap is enabled on the partition, then the swap is disabled.

Remove existing partition 2

When you type “y,” the command unmounts the disk and removes all partitions on the disk.

Unmount disk

Note:

The tool restarts the virtual machine after you have removed the partition.

Restart the virtual machine

When a partition is created or resized, or when a swap file is created, restart the virtual machine. The changes take effect only after restarting. For this purpose, a reboot command is provided in the tool.

Restart virtual machine 1

You are prompted for confirmation and after confirmation, all processes (such as NetScaler Console subsystems, PostgreSQL processes, and NetScaler Console monitors) are stopped. The virtual machine is then restarted.

Restart virtual machine 2

Restart virtual machine 3

Create a backup file of the disk data

Note:

Creating a backup file requires disk space. Make sure there is sufficient disk space (50% or more) before the backup commands are run.

To back up the NetScaler Console data before resizing or removing the partitions:

  1. Stop NetScaler Console.

    /mps/masd stop
    <!--NeedCopy-->
    
  2. Stop PostgreSQL.

    su -l mpspostgres /mps/scripts/pgsql/stoppgsql_smart.sh
    <!--NeedCopy-->
    
  3. Stop NetScaler Console Monitor.

    /mps/scripts/stop_mas_monit.sh
    <!--NeedCopy-->
    
  4. Create a tarball.

    cd /var
    tar cvfz /var/mps/mps_backup.tgz mps
    <!--NeedCopy-->
    

    Note:

    The operation takes time depending on the size of the data to be backed up.

  5. Generate a checksum.

    md5 /var/mps/mps_backup.tgz > /var/mps/mps_backup_checksum
    <!--NeedCopy-->
    
  6. Copy the tarball and checksum files to a remote server.

  7. Validate the correctness of the copied tarball. Generate a checksum of the transferred file and compare with the source checksum.

  8. Remove the tarball from the NetScaler Console virtual machine.

    cd /var/mps/
    rm mps_backup.tgz  mps_backup_checksum
    <!--NeedCopy-->
    

Additional commands

In addition to the commands listed earlier, you can also use the following commands in the tool:

Help command:

To list the supported commands, type help or ? and press enter. To get further help on each of the commands press help or ? followed by the command name and press the Enter key.

Help command

Info command:

The info command provides information about the attached secondary disk if the disk exists. The command provides the device name, the partition scheme, size in human-readable form, and the number of disk blocks. The scheme can be MBR or GPT. An MBR scheme means that the disk was partitioned using an earlier version of NetScaler Console version. The MBR/GPT based partition can be resized but not beyond 2 terabytes. The GPT partition scheme means that the disk was partitioned using NetScaler Console 12.1 or later.

Note:

A GPT partition can be greater than 2 terabytes but when it is created. But you cannot resize the disk to a size greater than 2 terabytes after creating a disk with a smaller size. This issue is a known limitation of the platform.  

Info command

Create_swapfile command:

The default swap partition on the primary disk of NetScaler Console is 4 GB and so, the default swap space is 4 GB. For the default memory configuration of NetScaler Console which is 2 GB, this swap space is sufficient. However, when you run NetScaler Console with a higher memory configuration, you need to have more swap space allocated on the disk.

Note:

Swap partition is usually a dedicated partition that is created on a hard disk drive (HDD) during the installation of the operating system. Such a partition is also referred to as a swap space. A swap partition is used for virtual memory that simulates the additional main memory.

Secondary disks that were added in the earlier versions of NetScaler Console do not have a swap partition created by default. The “create_swapfile” command is meant for secondary disks created using older NetScaler Console versions which don’t have a swap partition. The command checks for the following:

  • Presence of a secondary disk

  • Disk being mounted

  • Size of the disk (at least 500 GB)

  • The existence of the swap file

The create_swapfile command is useful only when the memory is greater or equal to 16 GB and not when memory is low. So, this command also checks for memory before proceeding with swap file creation.

Info command 2

If all the conditions are met, and the user consents to continue, a 32 GB swap file is created on the secondary disk. The swap file creation process takes a few minutes to complete and take care that you do not interrupt the process while in progress. After successful completion, a restart is done for the swap file to take effect.  

Create swap file command

After reboot, the increase in swap can be observed using the top command.

Create swap file command 2

Exit command:

To exit from the tool, type exit and press the Enter key.

Exit command

Attach additional disks to NetScaler Console deployed in high availability

Consider you have configured a pair of NetScaler Console servers in a high availability set up without any secondary disks. Also, consider you have added 2 or more NetScaler instances, checked and ensured all processes are running. You might want to add secondary disks to the virtual machines in this setup. In a high availability set up, you must add additional disks to both nodes as detailed in this task:

  1. Shut down the secondary node.

  2. Add a disk through the hypervisor.

    Note:

    Make sure not to extend the secondary node main disk.

  3. Start the secondary node.

  4. Run the partition tool on the secondary node.

  5. After the disk is added, the secondary node restarts.

  6. Shut down the secondary node after it restarts.

  7. Shut down the primary node.

  8. Add a disk through the hypervisor.

    Note:

    Make sure not to extend the primary node main disk.

  9. Start the primary node.

  10. Run the partition tool on the primary node.

  11. After the disk is added, the primary node restarts.

  12. After the primary node is up and running, start the secondary node.

  13. Make sure that the secondary node is up and running and the databases have synchronized.

  14. Confirm that all data still exists.

To increase the capacity of RAM on both the nodes:

  1. Shutdown Console_Secondary and increase the RAM size as required. Don’t restart the node.

  2. Shutdown Console_Primary and increase the RAM size as required.

    Make sure that you increase the RAM size equally on both nodes. For example, if you increase the RAM size on the primary node to 16 GB, do the same on the secondary node as well.

  3. Restart the Console_Primary.

  4. After the Console_Primary reboots, check if it is the primary node.

  5. Start the Console_Secondary node. After it restarts, make sure that it has come up as secondary and the DB sync is working.

  6. Confirm that all data still exists.

    Note:

    After you add the secondary disk, the primary node takes some time to come up. Also, the entire process of adding secondary disks to both nodes and increasing RAM capacity requires both nodes to be down for some time. Consider this downtime while planning this maintenance activity.