Skip to content
unRAID app to free space from one disk in the array, by moving folders/files to the other disks
Go JavaScript CSS Shell Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode Implement Go Modules Feb 9, 2019
client Release 5.6.0 Sep 7, 2019
metadata Release 5.6.0 Sep 7, 2019
plugin Fix protocol handling Sep 17, 2018
scripts Implement Go Modules Feb 9, 2019
server Bump github.com/gorilla/websocket from 1.4.0 to 1.4.1 in /server Sep 7, 2019
.cix.yml Fix CI script Nov 11, 2016
.gitignore Implement parcel-bundler Jul 8, 2018
CHANGES Release 5.6.0 Sep 7, 2019
DONATIONS.md Update documentation Dec 4, 2017
LICENSE - Add LICENSE (MIT) May 1, 2015
PLGVER Release 5.6.0 Sep 7, 2019
README.md Edit copy Jun 20, 2019
VERSION Release 5.6.0 Sep 7, 2019
unbalance.code-workspace Add workspace Jun 20, 2019

README.md

unBALANCE

tl;dr unBALANCE is an Unraid plugin to transfer files/folders between disks in your array.

Support Fund

If you wish to do so, read how to support the developer.

Changelog

Screenshot

Home

Videos

Thanks to gridrunner (Unraid forum member), you can watch unBALANCE in action !

Must Have Unraid Plugins - Part 3 Disk Utility Plugins

The discussion specific to unBALANCE starts here.

Introduction

unBALANCE helps you manage space in your Unraid array, via two operating modes:

  • Scatter
    Transfer data out of a disk, into one or more disks

  • Gather
    Consolidate data from a user share into a single disk

It's versatile and can serve multiple purposes, based on your needs.

Some of the use cases are:

  • Empty a disk, in order to change filesystems (read kizer's example)
  • Move all seasons of a tv show into a single disk
  • Move a specific folder from a disk to another disk
  • Split your movies/tv shows/games folder from a disk to other disks

You'll likely come up with other scenarios as you play around with it.

Core Features

  • Makes sure to fill the target disk(s) as much as possible, without running out of space
    If it can't transfer some files/folders, it will inform you in the console and via notifications (if you set them up in the settings), before any actual transfer takes place.

  • Operates in the background
    You can close your browser while the transfer operation is ongoing. It will keep transferring files on the server and show you the current progress as soon as you reopen the browser.

  • Transfer operations work at the disk level (not at the user share level)
    This avoids file/folder clobbering.

IMPORTANT: unBALANCE needs exclusive access to disks, so disable mover and/or any dockers that write to disks.

SCATTER Instructions

Scatter will transfer data from a source disk into one or more target disks, according to your selection.

It involves the following steps:

1 - Plan
The logic is simple

  • Get the contents of the selected files/folders from the source disk
  • Order the target disks by free space available
  • For each target disk, calculate how much it can be filled up with files/folder from the source disk, leaving some headroom (currently set at 512Mb).

Additionally, it will check files/folders permissions, to warn about potential issues during the transfer stage.

2 - Transfer
You can either MOVE or COPY the files.

  • MOVE
    Will first copy the files/folders into the target disk(s), and delete them as soon as the copy is finished.

  • COPY
    Will simply transfer the files/folders into the other disk(s).
    NOTE: Beware that COPY doesn't delete files/folders on the source disk, so you will be essentially duplicating the data.

Internally, all move operations are handled by diskmv.

Internally, it issues a slight variation of this rsync command.

Check this post for additional information.

3 - Validate (optional)
VALIDATE will only be enabled for a SCATTER / COPY operation. Just click the Validate button in the History screen and the operation will be replayed, but with checksum comparisons (instead of the simpler size/modification time check).

When using default flags, VALIDATE rsync will be invoked as -rcvPRX.

Quick Start

  • Click the FROM column of the disk you want to be the source of the transfer

  • Choose one or more files/folders you want to transfer

  • Click the TO column of the disks you want the files to be transferred to (the PLAN button will now be enabled)

  • Click the PLAN button
    It will display the console showing the progress of the plan stage.
    Once it's done, it will show how much space both source and target disks will have available (PLAN column).
    The screenshot below shows the warnings from the permissions check, as well as the message console Plan

  • Click the MOVE or COPY button (dry-run checked/unchecked)
    If dry-run is checked, no files/folder will be transferred. Otherwise the transfer operation will actually take place.
    In either case, you will be redirected to the Transfer screen, where you can monitor the progress of the operation.

GATHER Instructions

GATHER will consolidate data from a user share into a single disk.

It involves the following steps:

1 - Select Folder

Select

The 'SHARES EXPLORER' column lets you navigate your user shares, to choose a folder to consolidate. In the example, tvshows is the user share and Billions and Lost are the folders that will be consolidated.

When a folder is selected, the current selection and the drives where this folder is located are displayed.

Once you've chosen the folder, click NEXT.

2 - Choose Target Drive

Target

This page shows which drives have enough space to hold the full contents of the folder chosen in the previous step.

They are shown in descending order by the least amount of data transfer that will occurr.

An asterisk next to a drive means that the folder is present there.

Pick the drive you prefer, then click NEXT.

3 - Move
Move

This is a confirmation step. It shows how much data will be moved to which drive.

If you're ok, click PROCEED to start the transfer operation.

Installation

There are 2 ways to install this application

Running the app

After installing the plugin, you can access the web UI, via the following methods:

  • Method 1
    Go to Settings > Utilities
    Click on unBALANCE
    Click on Open Web UI

  • Method 2
    Go to Plugins > Installed Plugins
    Click on unBALANCE
    Click on Open Web UI

  • Method 3
    Navigate with your browser to http(s)://Tower:6237/ (replace Tower with the address/name of your Unraid server)

Other Features

Transfer

Here you can monitor the progress of an operation. It shows overall metrics, as well as each invididual command as they unfold.

Transfer

History

unBALANCE keeps a history of the operations you have run, showing each command that was executed.

You can replay the most recent operation (excluding dry-runs) or validate the most recent Scatter Copy.

Additionally, you can review operations which contain one or more flagged rsync commands.

If an rsync command has been flagged (applies to Gather and Scatter/Move operations), unBALANCE will not delete the source folders/files.

This allows you to check the issue in detail and take any action deemed necessary.

Once you've done that, you can delete the source folders/files through the UI, if you want.

History

Settings

Settings

These are pretty much straigthforward.

A word of caution with the custom rsync flags: it's for power users only.

unBALANCE is optimized to work with the default flags, you must be VERY knowledgeable in rsync if you want to add any flag.

Log

Log

Credits

This app uses the diskmv script (check the forum thread for additional information).

The icon was graciously created by hernandito (fellow Unraid forums member)

It was built with:

License

MIT

You can’t perform that action at this time.