Run
requirement: installed TubeDB
TubeDB is managed by shell scripts.
Note: Only one instance of TubeDB may open the database. So you can start TubeDB as server or for data import or as local GUI etc. but only one at a time. If you run TubeDB as background server make sure to shutdown the server before you initiate a data import etc.
Linux (Ubuntu)Permalink
./server.shPermalink
Start (web)server. Open a browser and type http://localhost:8080 (default). Terminate the server with key ctrl-c.
./explorer.shPermalink
Open desktop GUI for time series and meta data inspection.
./clear_import.shPermalink
Clear all time series and import from data files (see configuration/import) and load masks from config (see configuration/project, mask.csv).
./import.shPermalink
import time series data from files (see configuration/import) and load masks from config (see configuration/project, mask.csv). Does not clear previous time series.
./clear_load_masks.shPermalink
Clear all time series masks and load from config (see configuration/project, mask.csv). Does not clear time series data.
./interactive.sh (for advanced usage)Permalink
Open TubeDB shell.
./tsdb.sh (for advanced usage)Permalink
Run command in TubeDB (tsdb.sh [COMMAND]). This is the entry point for other scripts to execute commands on TubeDB.
Background ServerPermalink
For operation in background TubeDB uses screen. You may need to install screen sudo apt-get install screen
Following scripts manage TubeDB in background mode with screen.
start_server_background.shPermalink
Start TubeDB (web)server in background.
shutdown_server.shPermalink
Send shutdown request to background TubeDB (web)server to terminate.
stop_server_background.shPermalink
Directly terminate background TubeDB (web)server.
check_server_background.shPermalink
Check if background TubeDB (web)server is running.
Advanced UsagePermalink
If you are experienced with screen you can operate with the TubeDB background session. The screen session name is tubedb. It is recommended to first become familiar with screen workflow.
Check if screen session is running screen -ls
Open running screen session screen -r tubedb or screen -d -r tubedb (if session is attached)
Leave opened screen session, session continues to run in background ctrl-a d
Leave and terminate opened screen session ctrl-a \
Automated OperationPermalink
backup_cron.shPermalink
Create Backup of TubeDB. It is recommended to shutdown TubeDB before backup.
cronjob.shPermalink
Shutdown server, create backup, clear database, import time series files, start server. Creates log file and calls cronjob_internal.sh.
cronjob_internal.sh (for internal usage)Permalink
Intended to be used as internal skript for cronjob.sh. Shutdown server, create backup, clear database, import time series files, start server: shutdown_server.sh, backup_cron.sh, clear_import.sh, start_server_background.sh
cronjob_wrapper.sh (cron job target)Permalink
Helper script for cronjob.sh to execute in correct working directory if called from outside of working directory (e.g. as cron job). Use this script as linux cron job entry. You need to change absolute path to correct TubeDB working directory.
WindowsPermalink
server.cmdPermalink
Start (web)server. Open a browser and type http://localhost:8080 (default). Terminate the server with key ctrl-c.
explorer.cmdPermalink
Open desktop GUI for time series and meta data inspection.
clear_import.cmdPermalink
Clear all time series and import from data files (see configuration/import) and load masks from config (see configuration/project, mask.csv).
import.cmdPermalink
import time series data from files (see configuration/import) and load masks from config (see configuration/project, mask.csv). Does not clear previous time series.
clear_load_masks.cmdPermalink
Clear all time series masks and load from config (see configuration/project, mask.csv). Does not clear time series data.
interactive.cmd (for advanced usage)Permalink
Open TubeDB shell.
tsdb.cmd (for advanced usage)Permalink
Run command in TubeDB (tsdb.cmd [COMMAND]). This is the entry point for other scripts to execute commands on TubeDB.