From dbe1031b24e856e9d7e3cffa641f99525d3ed91f Mon Sep 17 00:00:00 2001 From: Zhangbaowen-Hashdata Date: Fri, 13 Oct 2023 15:22:38 +0800 Subject: [PATCH] Drop: Delete Windows development documentation We have decided to suspend development for the Windows platform due to its long development cycle and high level of difficulty. As a result, we have removed the Windows README.md document to avoid any potential confusion or misinformation for users. --- readmes/README.Windows.md | 153 -------------------------------------- readmes/README.md | 3 - 2 files changed, 156 deletions(-) delete mode 100644 readmes/README.Windows.md diff --git a/readmes/README.Windows.md b/readmes/README.Windows.md deleted file mode 100644 index 30898f39ea6..00000000000 --- a/readmes/README.Windows.md +++ /dev/null @@ -1,153 +0,0 @@ -# Building CBDB client tools on Windows - -We only support building 64-bit client tools on Windows using Visual Studio 2017. Building backend is not supported. - -If not specified, all commands in this readme should be executed in x64 Native Tools Command Prompt. - -# Components of client tools - -- Command line client: psql, pg_dump, pg_dumpall -- Script tools: createdb, createuser, dropdb, dropuser, clusterdb, vacuumdb -- Loaders: gpfdist, gpload - -# Prerequisite - -## Tools - -Install following tools and add them to PATH, make sure you can invoke them from cmd. - -1. Visual Studio build tools - -[Download](https://visualstudio.microsoft.com/downloads/) and install "Visual C++ Build tools" - -2. CMake - -[Download](https://cmake.org/download/) and install latest Windows win64-x64 Installer. - -3. Git - -[Download](https://git-scm.com/download/win) and install. - -4. Flex and Bison via MSYS2 - -[Download](https://www.msys2.org/) and install latest x86_64 package. - -After installation, open MSYS2 command line, run ```pacman -S flex bison```. Add ```\usr\bin``` to PATH. - -5. Perl - -[Download](https://www.activestate.com/activeperl/downloads) 64-bit and install. - -6. Python 3 - -[Download](https://www.python.org/downloads/) Windows x86-64 MSI installer and install. - -## Required dependencies of gpfdist - -We will install all dependencies to C:\dep. If you want another location, -make sure you've changed C:\dep in the following scripts. - -1. zlib -``` -git clone --branch v1.2.11 --depth 1 https://github.com/madler/zlib.git -cd zlib - -mkdir build -cd build -cmake -DCMAKE_INSTALL_PREFIX:PATH=C:\dep -G "Visual Studio 15 2017 Win64" .. -cmake --build . --config Release --target ALL_BUILD -cmake --build . --config Release --target INSTALL -copy C:\dep\lib\zlibstatic.lib C:\dep\lib\zdll.lib -``` - -2. libapr -``` -git clone --branch 1.6.5 --depth 1 https://github.com/apache/apr.git -cd apr -mkdir build2 -cd build2 -cmake -DCMAKE_INSTALL_PREFIX:PATH=C:\dep -G "Visual Studio 15 2017 Win64" .. -cmake --build . --config Release --target ALL_BUILD -cmake --build . --config Release --target INSTALL -``` - -3. libevent -``` -git clone --branch release-2.1.8-stable --depth 1 https://github.com/libevent/libevent.git -cd libevent -mkdir build -cd build -cmake -DEVENT__DISABLE_OPENSSL=ON -DCMAKE_INSTALL_PREFIX:PATH=C:\dep -G "Visual Studio 15 2017 Win64" .. -cmake --build . --config Release --target ALL_BUILD -cmake --build . --config Release --target INSTALL -``` - -## Optional dependencies - -We will install all dependencies to C:\dep. If you want another location, -make sure you've changed C:\dep in the following scripts. - -1. OpenSSL 1.0.2 - -``` -git clone --branch OpenSSL_1_0_2r --depth 1 https://github.com/openssl/openssl -cd openssl -perl Configure --prefix=C:\dep VC-WIN64A -ms\do_win64a -nmake -f ms\ntdll.mak -nmake -f ms\ntdll.mak install -``` - -2. Kerberos -``` -git clone --branch krb5-1.17-final --depth 1 https://github.com/krb5/krb5.git -cd krb5 -set NO_LEASH=1 -set PATH=%PATH%;"%WindowsSdkVerBinPath%"\x86 -set KRB_INSTALL_DIR=C:\dep -cd src -nmake -f Makefile.in prep-windows -nmake NODEBUG=1 -nmake install NODEBUG=1 -``` - -# Build steps - -Replace with real location of your cbdb source code. Make sure you have -also cloned the submodule at gpMgmt\bin\pythonSrc\ext. - -We will install client package to C:\cloudberry-db-devel. If you want another location, -make sure you've replaced C:\cloudberry-db-devel in the following scripts. - - -1. Create config.pl at src/tools/msvc. If you don't build with these supports, it's ok to skip this step. -``` -cd \src\tools\msvc -echo print "our \$config = {gss => 'c:/dep', openssl => 'c:/dep', zlib => 'c:/dep'};" | perl >config.pl -``` - -2. Build postgres clients and scripts -``` -cd \src\tools\msvc -build client -install C:\cloudberry-db-devel client -``` - -3. Build gpfdist -``` -cd \src\bin\gpfdist -cd build -cmake -DCMAKE_PREFIX_PATH:PATH=C:\ext -DCMAKE_INSTALL_PREFIX:PATH=C:\cloudberry-db-devel -G "Visual Studio 15 2017 Win64" .. -cmake --build . --config Release --target ALL_BUILD -cmake --build . --config Release --target INSTALL -``` - -4. Build pygresql, needed by gpload -``` -cd \gpMgmt\bin\pythonSrc\PyGreSQL -mkdir build -cd build -cmake -DCMAKE_PREFIX_PATH=C:\cloudberry-db-devel -DCMAKE_INSTALL_PREFIX:PATH=C:\cloudberry-db-devel -G "Visual Studio 15 2017 Win64" .. -cmake --build . --config Release --target ALL_BUILD -cmake --build . --config Release --target INSTALL -``` diff --git a/readmes/README.md b/readmes/README.md index a0ea25ef296..7e552342415 100644 --- a/readmes/README.md +++ b/readmes/README.md @@ -121,9 +121,6 @@ Cloudberry Database supports Python3 with plpython3u UDF See [how to enable Python3](../src/pl/plpython/README.md) for details. -## Building Cloudberry Database client tools on Windows - -See [Building CBDB client tools on Windows](README.Windows.md) for details. # Development with Vagrant