diff --git a/Installation.md b/Installation.md new file mode 100644 index 0000000..e629485 --- /dev/null +++ b/Installation.md @@ -0,0 +1,44 @@ +YBDB relies heavily on accurate time calculations. + +Make sure you have installed time support for mysql or mariadb as explained [here](https://dev.mysql.com/doc/refman/5.7/en/time-zone-support.html). In GNU/Linux you run the mysql_tzinfo_to_sql program from the commandline: + +`mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysql` + +It is recommended that you install this software with Docker. + +Dockerfile may be found at [https://github.com/fspc/ybdb](https://github.com/fspc/ybdb), or you may pull the repository (updated infrequently). + +``` +docker pull bikebike/ybdb +``` + +## Run the docker container + +Publish the container's port to the host: + +>format: ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort + + +``` +docker run -d -p 81:80 --name="ybdb" bikebike/ybdb +``` + +## How to test/develop inside the running container process + +``` +sudo docker exec -it ybdb /bin/bash +``` + +If it produces this error: + +``` +rpc error: code = 13 desc = invalid header field value "oci runtime error: exec failed: container_linux.go:247: starting container process caused \"process_linux.go:75: starting setns process caused \\\"fork/exec /proc/self/exe: no such file or directory\\\"\"\n" +``` + +then do this before attempting again: + + +``` +docker stop ybdb +docker start ybdb +``` \ No newline at end of file