Repository files navigation

FlashAlloc is a novel interfacee for flash storage,which is used to the logical address ranges of objects to the underlying flash deviceand thus to enlighten the device to stream writes by objects. See deatil in our paper

[1] Jonghyeok Park, Soyee Choi, Gihwan Oh, Soojun Im, Moon-Wook Oh, Sang-Won Lee, "FlashAlloc: Dedicating Flash Blocks By Objects". VLDB 2023

First, you will need the Cosmos+ Board with hynix NAND firmware version.You can get more accurate information atCRZ Technology

FPGA: Xilinx XC7Z045-3FFG900 Zynq-7000- Dual ARM Cortex-A9 1GHz Core- NEON DSP co-processor for each core- 350K LCs1GB DDR3 NAND Modules1 SD CARD SlotDual PCIe Gen2 x8 End-Points (Cabled PCIe Interface)1 Gigabit Ethernet Interface1 USB 2.0 (configurable to Host or Device)JTAG and Debug Interface

Second, You need the software tools and files

• Xilinx ISE design suite 19.1 system editionLink
• UART terminal emulator software (Xilinx Software Development Kit(SDK) includes UART terminal)
• Download theUSB-to-UART driver
• Check details atOpenSSD Project hompage

• Flashalloc is Cosmos+ OpenSSD firmware source code which implements the Flashalloc interface for flash storages
• Multistream is multi-stream prototype for Cosmos+ OpenSSD supporting eight stream-ids
• host incorporates the implementation of both RocksDB and MySQL, utilized for evaluation in our paper.It also includes a simple host application example to test the flashalloc command.
• More details are illustrated in our paper.

Please refer to Cosmos+ OpenSSD build guidedocument

TL;DR

1. Prepare Cosmos+ Open SSD, Window and Linux PC
2. Connect the Cosmos+ OpenSSD to Window PC (JTAG dilegent module and USB cable for UART) and install the PCIe to connect btw Cosmos+ OpenSSD and Linux PC
3. Open the FlashAlloc projecct in Xilinx SDK
4. Right click on project, andRun As > 1. Launch on Hardware (GDB)
5. Click the firmware to execute, andclick OK > wait UART message
6. Press X to make bad block table (you should do this for the first time)
7. Wait and Turn-on (or reboot) the Linux PC
8. You can check the Cosmos+ OpenSSD usingnvme-cli orlspci command (check thenvme0nXXXXX in the device list)
9. Bon appétit! :)

cd hostmake -jsudo ./playground /dev/nvmeXXX 0 32

• playground host application name
• /dev/nvmeXXX Comsmos+ OpenSSD device path
• 0 start LBA (4KiB-based offset)
• 32 LBA length

1. Build

• Build the RocksDB database engine for both flashalloc or multi-streame ssd version
• You can also build the vanilla version of Rocksdb usingbash ./scripts/build.sh command

cd host/RocksDB/rocksdb-{flashalloc | msssd}bash ./scripts/build.sh cosmos

2. Configure File system

• You can mount either EXT4 or F2FS filesystem with TRIM support on top of Cosmos+ OpenSSD

# EXT4 Filesystembash ./scripts/setup-ext4-trim.sh# F2FS Filesystembash ./scripts/setup-f2fs-trim.sh

3. Rundb_bench wiht 4 tenants

# FlashAlloc versionbash ./scripts/run_flashalloc.sh# Vanilla versionbash ./scripts/run_vanilla.sh# Multi-stream SSD versionbash ./scripts/run_msssd.sh

4. Rundb_bench wiht single tenants

# FlashAlloc versionbash ./scripts/falloc-single.sh# Multi-stream SSD versionbash ./scripts/msssd-single.sh

1. Build

cd hsot/MySQLbash ./build.sh

2. Initialize data directory

bash init.sh

3. Run MySQL server

bash ./run.sh

4. Run TPC-C Benchmark

• You can also modify the configuration for TPC-C Benchmark (e.g., # of clients, wrapup time, duration, and etc)
• To run the either vanilla or multi-stream ssd version, you can executerun.sh script.

cd host/tpcc-mysqlbash ./run-flashalloc.sh

• In this experiment, you can evaluate the multi-tenant configuration.

# configure the filesystem and data directory for TPC-C and db_benchbash ./setup-multi.sh# run multi-tenant experimentsbash run-multi.sh

All guide document for Cosmos+ OpenSSD is provided byCosmos Open SSD Project.