1
0
Fork 0
mirror of https://we.phorge.it/source/phorge.git synced 2024-11-08 16:02:40 +01:00

Update install and upgrade documentation for libphutil

Summary:
Ref T13395. Libphutil has merged into Arcanist and no longer needs to be installed or upgraded. Additionally:

  - The minimum PHP version is now PHP 5.5.
  - Although older versions of PHP should still install APC, modern versions come with Opcache and do not need APC. Setup issues guide administrators thorugh the correct install procedure now.

Test Plan: Read documentation.

Maniphest Tasks: T13395

Differential Revision: https://secure.phabricator.com/D21550
This commit is contained in:
epriestley 2021-02-08 09:42:49 -08:00
parent 67cf80b377
commit 3e38579fee
4 changed files with 10 additions and 59 deletions

View file

@ -117,13 +117,6 @@ fi
confirm confirm
if [[ ! -e libphutil ]]
then
git clone https://github.com/phacility/libphutil.git
else
(cd libphutil && git pull --rebase)
fi
if [[ ! -e arcanist ]] if [[ ! -e arcanist ]]
then then
git clone https://github.com/phacility/arcanist.git git clone https://github.com/phacility/arcanist.git

View file

@ -93,12 +93,6 @@ sudo a2enmod rewrite || failed
echo "Downloading Phabricator and dependencies..." echo "Downloading Phabricator and dependencies..."
echo echo
if [ ! -e libphutil ]
then
git clone https://github.com/phacility/libphutil.git
else
(cd libphutil && git pull --rebase)
fi
if [ ! -e arcanist ] if [ ! -e arcanist ]
then then

View file

@ -64,13 +64,14 @@ Beyond an operating system, you will need **a webserver**.
works fine. works fine.
- **Other**: Other webservers which can run PHP are also likely to work fine, - **Other**: Other webservers which can run PHP are also likely to work fine,
although these installation instructions will not cover how to set them up. although these installation instructions will not cover how to set them up.
- **PHP Builtin Server**: You can use the builtin PHP webserver for - **PHP Builtin Server**: Phabricator will not work with the builtin
development or testing, although it should not be used in production. webserver because Phabricator depends on making requests to itself on some
workflows, and the builtin webserver is single-threaded.
You will also need: You will also need:
- **MySQL**: You need MySQL. We strongly recommend MySQL 5.5 or newer. - **MySQL**: You need MySQL. We strongly recommend MySQL 5.5 or newer.
- **PHP**: You need PHP 5.2 or newer. - **PHP**: You need PHP 5.5 or newer.
You'll probably also need a **domain name**. In particular, you should read this You'll probably also need a **domain name**. In particular, you should read this
note: note:
@ -124,9 +125,7 @@ Otherwise, here's a general description of what you need to install:
- PHP (usually "php") - PHP (usually "php")
- Required PHP extensions: mbstring, iconv, mysql (or mysqli), curl, pcntl - Required PHP extensions: mbstring, iconv, mysql (or mysqli), curl, pcntl
(these might be something like "php-mysql" or "php5-mysqlnd") (these might be something like "php-mysql" or "php5-mysqlnd")
- Optional PHP extensions: gd, apc (special instructions for APC are available - Optional PHP extensions: gd
below if you have difficulty installing it), xhprof (instructions below,
you only need this if you are developing Phabricator)
If you already have LAMP setup, you've probably already got everything you need. If you already have LAMP setup, you've probably already got everything you need.
It may also be helpful to refer to the install scripts above, even if they don't It may also be helpful to refer to the install scripts above, even if they don't
@ -136,41 +135,11 @@ Now that you have all that stuff installed, grab Phabricator and its
dependencies: dependencies:
$ cd somewhere/ # pick some install directory $ cd somewhere/ # pick some install directory
somewhere/ $ git clone https://github.com/phacility/libphutil.git
somewhere/ $ git clone https://github.com/phacility/arcanist.git somewhere/ $ git clone https://github.com/phacility/arcanist.git
somewhere/ $ git clone https://github.com/phacility/phabricator.git somewhere/ $ git clone https://github.com/phacility/phabricator.git
= Installing APC (Optional) = Next Steps
==========
Like everything else written in PHP, Phabricator will run much faster with APC
installed. You likely need to install "pcre-devel" first:
sudo yum install pcre-devel
Then you have two options. Either install via PECL (try this first):
sudo yum install php-pear
sudo pecl install apc
**If that doesn't work**, grab the package from PECL directly and follow the
build instructions there:
http://pecl.php.net/package/APC
Installing APC is optional but **strongly recommended**, especially on
production hosts.
Once APC is installed, test that it is available by running:
php -i | grep apc
If it doesn't show up, add:
extension=apc.so
..to "/etc/php.d/apc.ini" or the "php.ini" file indicated by "php -i".
= Next Steps =
Continue by: Continue by:

View file

@ -43,7 +43,6 @@ To switch to `stable`, check the branch out in each working copy:
phabricator/ $ git checkout stable phabricator/ $ git checkout stable
arcanist/ $ git checkout stable arcanist/ $ git checkout stable
libphutil/ $ git checkout stable
You can now follow the upgrade process normally. You can now follow the upgrade process normally.
@ -54,8 +53,7 @@ Upgrade Process
IMPORTANT: You **MUST** restart Phabricator after upgrading. For help, see IMPORTANT: You **MUST** restart Phabricator after upgrading. For help, see
@{article:Restarting Phabricator}. @{article:Restarting Phabricator}.
IMPORTANT: You **MUST** upgrade `libphutil`, `arcanist` and `phabricator` at IMPORTANT: You **MUST** upgrade `arcanist` and `phabricator` at the same time.
the same time.
Phabricator runs on many different systems, with many different webservers. Phabricator runs on many different systems, with many different webservers.
Given this diversity, we don't currently maintain a comprehensive upgrade Given this diversity, we don't currently maintain a comprehensive upgrade
@ -64,7 +62,7 @@ on every system:
- Stop the webserver (including `php-fpm`, if you use it). - Stop the webserver (including `php-fpm`, if you use it).
- Stop the daemons, with `phabricator/bin/phd stop`. - Stop the daemons, with `phabricator/bin/phd stop`.
- Run `git pull` in `libphutil/`, `arcanist/` and `phabricator/`. - Run `git pull` in `arcanist/` and `phabricator/`.
- Run `phabricator/bin/storage upgrade`. - Run `phabricator/bin/storage upgrade`.
- Start the daemons, with `phabricator/bin/phd start`. - Start the daemons, with `phabricator/bin/phd start`.
- Restart the webserver (and `php-fpm`, if you stopped it earlier). - Restart the webserver (and `php-fpm`, if you stopped it earlier).
@ -86,7 +84,7 @@ set -x
# to work without modifications. # to work without modifications.
# NOTE: This script assumes you are running it from a directory which contains # NOTE: This script assumes you are running it from a directory which contains
# arcanist/, libphutil/, and phabricator/. # arcanist/, and phabricator/.
ROOT=`pwd` # You can hard-code the path here instead. ROOT=`pwd` # You can hard-code the path here instead.
@ -107,9 +105,6 @@ sudo /etc/init.d/httpd stop
### UPDATE WORKING COPIES ###################################################### ### UPDATE WORKING COPIES ######################################################
cd $ROOT/libphutil
git pull
cd $ROOT/arcanist cd $ROOT/arcanist
git pull git pull