diff --git a/manual/build_seafile/server.md b/manual/build_seafile/server.md index fa6ff610..0f499c75 100644 --- a/manual/build_seafile/server.md +++ b/manual/build_seafile/server.md @@ -1,393 +1,197 @@ -# Server +This is the document for deploying Seafile open source development environment in Ubuntu 1804 docker container. -## Preparation - -The following list is all the libraries you need to install on your machine. **You should install all of them before you build seafile**. - -Package names are according to Ubuntu 12.04. For other Linux distros, please find their corresponding names yourself. - -* libevent-dev (2.0 or later ) -* libcurl4-openssl-dev (1.0.0 or later) -* libglib2.0-dev (2.28 or later) -* uuid-dev -* intltool (0.40 or later) -* libsqlite3-dev (3.8 or later) -* libmysqlclient-dev (5.5 or later) -* libarchive-dev -* libtool -* libjansson-dev -* valac -* libfuse-dev - -Also, python 2.7 is required since seafile server 5.1.0. - -The following libraries need to be compiled from source. - -### Notes about MySQL client library - -You can also use MariaDB's LGPL Connector/C library. Download the latest stable version of the library on then compile and install the library. +## Run a container ``` -cmake . -make -sudo make install - +docker run -it -p 8000:8000 -p 8082:8082 --name seafile-ce-env ubuntu:18.04  bash ``` -By default the library will be installed under `/usr/local/lib/mariadb`. Add this path to your `LD_LIBRARY_PATH` environment variable so the loader can find this library. +Note, the following commands are all executed in the seafile-ce-env docker container. + +## Update Source and Install Dependencies. ``` -export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib/mariadb +apt-get update && apt-get upgrade -y +apt-get install -y ssh libevent-dev libcurl4-openssl-dev libglib2.0-dev uuid-dev intltool libsqlite3-dev libmysqlclient-dev libarchive-dev libtool libjansson-dev valac libfuse-dev python-dateutil cmake re2c flex sqlite3 python-pip python-simplejson git libssl-dev libldap2-dev libonig-dev vim vim-scripts wget cmake gcc autoconf automake mysql-client librados-dev libxml2-dev curl sudo telnet netcat unzip netbase ca-certificates apt-transport-https build-essential libxslt1-dev libffi-dev libpcre3-dev libz-dev xz-utils nginx pkg-config poppler-utils libmemcached-dev sudo + +curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash - +apt-get install -y nodejs + +apt-get install -y python3-pip python3.6 python3.6-dev + +python3.6 -m pip install --upgrade pip + +rm /usr/bin/python +rm /usr/bin/python3 +ln -s /usr/bin/python3.6 /usr/bin/python +ln -s /usr/bin/python3.6 /usr/bin/python3 + +rm /usr/bin/pip +rm /usr/bin/pip3 +ln -s /usr/local/bin/pip3.6 /usr/bin/pip +ln -s /usr/local/bin/pip3.6 /usr/bin/pip3 + +pip install python-cas djangosaml2 cffi sqlalchemy pymysql pillow pycryptodome configparser pylibmc django-pylibmc elasticsearch==5.5.0 elasticsearch-dsl==5.4.0 Django==2.2.14 future captcha django-statici18n django-post_office==3.3.0 django-webpack_loader gunicorn mysqlclient django-picklefield==2.1.1 openpyxl qrcode django-formtools django-simple-captcha djangorestframework==3.11.1 python-dateutil requests pillow pyjwt pycryptodome requests_oauthlib mock nose exam splinter pytest pytest-django ``` -### libevhtp - -* Download [libevhtp](https://github.com/ellzey/libevhtp/archive/1.1.6.tar.gz). -* Build libevhtp by: - +## Install MariaDB and Create Databases ``` +apt-get install -y mariadb-server +service mysql start +mysqladmin -u root password 123456 +``` + +sql for create databases + +``` +create database ccnet charset utf8; +create database seafile charset utf8; +create database seahub charset utf8; +``` + +## Download Source Code + +``` +cd ~/ +mkdir -p ~/dev/source-code +cd ~/dev/source-code + +git clone https://github.com/haiwen/libevhtp.git +git clone https://github.com/haiwen/libsearpc.git +git clone https://github.com/haiwen/seafobj.git +git clone https://github.com/haiwen/seafile-server.git +git clone https://github.com/haiwen/seahub.git + +cd libsearpc/ +git fetch origin 8.0:8.0 +git checkout 8.0 + +cd ../seafile-server +git checkout tags/v8.0.0-server -b tag-v8.0.0-server + +cd ../seahub +git checkout tags/v8.0.0-server -b tag-v8.0.0-server + +cd ../seafobj +git checkout tags/v8.0.0-server -b tag-v8.0.0-server +``` + +## Compile and Install seaf-server + +``` +cd ../libevhtp cmake -DEVHTP_DISABLE_SSL=ON -DEVHTP_BUILD_SHARED=OFF . make -sudo make install +make install +ldconfig -``` - -### Seahub dependencies - -**Seahub** is the web front end of Seafile. It's written in the [django](http://djangoproject.com) framework. Seahub requires Python 2.6(or 2.7) installed on your server, and it needs the following python libraries: - -* Django 1.8 -* pytz -* django-statici18n -* djangorestframework -* django_compressor -* django-post_office -* [django-constance](https://github.com/haiwen/django-constance/) (install it by `pip install https://github.com/haiwen/django-constance/archive/bde7f7c.zip`) -* gunicorn -* flup -* chardet -* python-dateutil -* six -* openpyxl - -Before continue, make sure you have all the above libraries available in your system. - -### Prepare the directory layout - -In the following sections, you'll be guided to build and setup the seafile server step by step. Seafile server is consisted of several components. In order for them to function correctly, you must: - -* Follow our instructions step by step -* Make sure your directory layout is exactly the same with the guide in each step. - -First create the top level directory. In the following sections, we'll use "/data/haiwen" as the top level directory. - -``` -mkdir /data/haiwen/ -cd /data/haiwen/ -mkdir seafile-server -cd seafile-server - -``` - -The currently layout is: - -``` -haiwen/ -└── seafile-server - -``` - -### Get the source - -First you should get the latest source of libsearpc/ccnet-server/seafile-server/seahub - -Download the source tarball of the latest tag from - -* -* -* -* - -For example, if the latest released seafile server is 6.0.1, then just use the **v6.0.1-server** tags of the projects (except for libsearpc, which uses the **v3.0-latest** tag). You should get four tarballs: - -* libsearpc-3.0-latest.tar.gz -* ccnet-server-6.0.1-server.tar.gz -* seafile-server-6.0.1-server.tar.gz -* seahub-6.0.1-server.tar.gz - -Create a folder `haiwen/src`, and uncompress libsearpc/ccnet/seafile source to it. - -``` -cd haiwen/seafile-server -mkdir src -cd src -tar xf /path/to/libsearpc-3.0-latest.tar.gz -tar xf /path/to/ccnet-server-6.0.1-server.tar.gz -tar xf /path/to/seafile-server-6.0.1-server.tar.gz - -``` - -And uncompress seahub tarball to `haiwen/seafile-server`: - -``` -cd haiwen/seafile-server -tar xf /path/to/seahub-6.0.1-server.tar.gz -mv seahub-6.0.1-server seahub - -``` - -So far, The current directory layout is: - -``` -haiwen/ -└── seafile-server - └── seahub - └── src - ├── libsearpc-6.0.1-server - ├── ccnet-server-6.0.1-server - ├── seafile-server-6.0.1-server - ├── ... (other files) - -``` - -### Building - -To build seafile server, you need first build **libsearpc** and **ccnet-server**. - -##### libsearpc - -``` -cd libsearpc-${version} +cd ../libsearpc ./autogen.sh ./configure make make install +ldconfig -``` - -##### ccnet-server - -``` -cd ccnet-server-${version} +cd ../seafile-server ./autogen.sh -./configure # `export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig` if libsearpc is not found +./configure --disable-fuse make make install - +ldconfig ``` -By default, `configure` tries to find MySQL and Postgresql client libraries in the system. If you do not want to support MySQL or Postgresql, use the following configure options: +## Create Conf Files ``` -./configure --without-mysql --without-postgresql +mkdir ~/dev/conf +cd ~/dev/conf +cat > ccnet.conf < seahub_settings.py < seafile.conf < to use Seafile. -After configuration successfully created, run **seafile-admin start** in the top directory to start the all components of Seafile. ( **You should always run the seafile-admin script in the top directory** ). +## The Final Directory Structure -``` -cd /data/haiwen # go to the top level directory -seafile-admin start - -``` - -At this moment, all the components should be running and seahub can be visited at - -**Note** You may want to deploy seahub with nginx or apache. In this case, follow the instructions on Deploy Seafile Web With [Nginx](../deploy/deploy_with_nginx.md)/[Apache](../deploy/deploy_with_apache.md). - -### Stop the Seafile Server - -To stop seafile server, run **seafile-admin stop**. - -``` -cd /data/haiwen # go to the top level directory -seafile-admin stop - -``` - -## Upgrade the Seafile Server - -When you want to upgrade to a new vesrion of seafile server, you need to: - -* Stop the seafile server if it's running - - -``` -cd /data/haiwen -seafile-admin stop - -``` - -* Get and latest source code and build libsearpc/ccnet/seafile, just as what you do in a fresh setup. -* Run the upgrade script. The upgrade script mainly updates database used by seafile for you. For example, create a new database table that is used in the latest seafile server but not in the previous version. - -### Get and compile the latest libsearpc/ccnet/seafile - -See the **Building** section above. - -### Get the new seahub tarball and uncompress it - -``` -cd haiwen/seafile-server -mv seahub/ seahub-old # move away the old seahub folder -tar xf /path/to/new/seahub-x.x.x-server.tar.gz -mv seahub-x.x.x-server seahub - -``` - -### Do the upgrade - -* copy the scripts/upgrade/ subdir outside - -The upgrade scripts is distributed in the `scripts/upgrade` subdir of seafile source code, we need to copy it to **seafile-server** directory before run the scripts. - -``` -cd /data/haiwen/seafile-server -cp -rf seafile-{version}/scripts/upgrade . - -``` - -#### Continuous Upgrade (like from 1.1 to 1.2) - -Continuous upgrade means to upgrade from one version of seafile server to the next version. For example, upgrading from 1.1.0 to 1.2.0 is a continuous upgrade. - -**Note:** Minor upgrade, like upgrade from 1.3.0 to 1.3.1, is documented in a separate section below. - -Say you are upgrading from 1.1.0 to 1.2.0, you should run the script **upgrade_1.1_1.2.sh** in `seafile-server` directory. - -``` -cd /data/haiwen/seafile-server -./upgrade/upgrade_1.1_1.2.sh - -``` - -#### Non-continous version upgrade(like from 1.1 to 1.3) - -If you upgrade a few versions at once, e.g. from 1.1.0 to 1.3.0. The procedure is: - -* upgrade from 1.1.0 to 1.2.0 -* upgrade from 1.2.0 to 1.3.0 - -Just run the upgrade scripts in sequence. - -#### Minor Upgrade (like from 1.3.0 to 1.3.1) - -Minor upgrade Minor upgrade is like an upgrade from 1.3.0 to 1.3.1. For this type of upgrade, you only need to update the avatar link: - -``` -cd /data/haiwen/seafile-server/seahub/media -cp -rf avatars/* ../../../seahub-data/avatars/ -rm -rf avatars -ln -s ../../../seahub-data/avatars - -``` - -## Problems Report - -If you encounter any problem when building/deploying Seafile, please leave us a message or [open an issue](https://github.com/haiwen/seafile/issues). +![Directory Structure](../images/build_seafile_server_directory_structure.jpg)