If what you are looking for is not listed here, please visit our Documentation Wiki.
Download and installation
You can clone the latest (and stable) 2.x source tree from the git repository:
$ git clone http://git.rapiddisk.org/rxdsk-2.x.git
You can clone the latest (and stable) 1.x source tree from the git repository:
$ git clone http://git.rapiddisk.org/rxdsk-1.x.git
If you already have an older copy of the source code previously cloned from the
git repository, you can simply update it with the
git pull command. You can also download the latest tarball release from the RapidDisk Sourceforge page. NOTE – If you wish to download only the administration utilities, you can find and download the latest tarball(s) here.
Change into the directory and run the
Makefile to build the management utility and kernel module:
$ cd rxdsk-1.x
NOTE – To build the
rxadm management utility, you will need to have the
zlib libraries and
zlib development files installed on your host system. As of 1.3, the build links to
zlib for compressed archiving and decompressed restoration of
NOTE – While it will still install without it, in order to utilize the
pyRxAdm graphical wrapper (introduced in 2.2), you are required to have both the Python programming language and the pyGTK module installed.
NOTE – To build the kernel module, you are required to having either the full kernel source or the kernel headers installed for your current kernel revision.
And install the management utility, kernel module, and man page (management utility is installed in
$ sudo make install
To insert the
$ sudo modprobe rxdsk
To remove the
$ sudo modprobe -r rxdsk
To insert the
$ sudo modprobe rxcache
To remove the
$ sudo modprobe -r rxcache
Installing modules with DKMS
This is only supported as of release 2.9.1 and later. To build:
$ sudo make dkms
Installing / uninstalling the administration utilities
This is only supported as of release 2.9.1 and later.
$ sudo make tools-install
$ sudo make tools-uninstall
Any and all patches for RapidDisk can be found at here. To install the patches intended for the module, copy it to the module/drivers/block path of the package and type the following to apply:
$ patch -p0< patchname.patch
Note that each patch name will be descriptive enough to know which version of RapidDisk it applies to.
The majority of data integrity testing and benchmarking was accomplished using the fio test utility. Also byte level drive contents were closely examined via the native
hexdump utility and invoked:
$ hexdump -Cv /dev/rxd0|less.
Located in the
test/ subdirectory of the source code is a small collection of very quick tests to run on a RapidDisk attached RAM disk raw block device. The
rxio program tests a few basic block device functions which include getting the volume size, reading, writing, to even seeking, the
rxioctl program tests the kernel module’s
ioctl and the
rxflush program sends the BLKFLSBUF
ioctl command to flush the block device’s buffer cache.
Building & executing the test tools
$ gcc rxio.c -o rxio
$ gcc rxioctl.c -o rxioctl
$ gcc rxflush.c -o rxflush
To execute in place (make sure you create an rxd0 RapidDisk volume prior to executing):
Note – The applications will only test the node named
/dev/rxd0. You can change this in the code if necessary and recompile.