Page MenuHomestyx hydra
Files F271441

No OneTemporary
Actions

View Options

diff --git a/scripts/install/update_phabricator.sh b/scripts/install/update_phabricator.sh
new file mode 100755
index 0000000000..207650d108
--- /dev/null
+++ b/scripts/install/update_phabricator.sh
@@ -0,0 +1,62 @@
+#!/bin/sh
+
+set -e
+set -x
+
+# This is an example script for updating Phabricator, similar to the one used to
+# update <https://secure.phabricator.com/>. It might not work perfectly on your
+# system, but hopefully it should be easy to adapt.
+
+# NOTE: This script assumes you are running it from a directory which contains
+# arcanist/, libphutil/, phabricator/, and possibly diviner/.
+
+ROOT=`pwd` # You can hard-code the path here instead.
+
+
+### UPDATE WORKING COPIES ######################################################
+
+if [ -e $ROOT/diviner ]
+then
+ (cd $ROOT/diviner && git pull)
+fi
+
+(cd $ROOT/libphutil && git pull)
+(cd $ROOT/arcanist && git pull)
+(cd $ROOT/phabricator && git pull && git submodule update --init)
+
+
+### GENERATE DOCUMENTATION #####################################################
+
+# This generates documentation if you have diviner/ checked out. You generally
+# don't need to do this unless you're contributing to Phabricator and want to
+# preview some of the amazing documentation you've just written.
+if [ -e $ROOT/diviner ]
+then
+ (cd $ROOT/diviner && $ROOT/diviner/bin/diviner .)
+ (cd $ROOT/libphutil && $ROOT/diviner/bin/diviner .)
+ (cd $ROOT/arcanist && $ROOT/diviner/bin/diviner .)
+ (cd $ROOT/phabricator && $ROOT/diviner/bin/diviner .)
+fi
+
+### CYCLE APACHE AND DAEMONS ###################################################
+
+# Stop Apache. Depening on what system you're running, you may need to use
+# 'apachectl' or something else to cycle apache.
+sudo /etc/init.d/httpd stop
+
+# Stop daemons.
+$ROOT/phabricator/bin/phd stop
+
+# Upgrade the database schema.
+$ROOT/phabricator/scripts/sql/upgrade_schema.php -f
+
+# Restart apache.
+sudo /etc/init.d/httpd start
+
+# Restart daemons. Customize this to start whatever daemons you're running on
+# your system.
+
+# $ROOT/phabricator/bin/phd repository-launch-master
+# $ROOT/phabricator/bin/phd launch metamta
+# $ROOT/phabricator/bin/phd launch 4 taskmaster
+# $ROOT/phabricator/bin/phd launch ircbot /config/bot.json
diff --git a/src/docs/installation_guide.diviner b/src/docs/installation_guide.diviner
index a10ebe062b..449ea71bd2 100644
--- a/src/docs/installation_guide.diviner
+++ b/src/docs/installation_guide.diviner
@@ -1,109 +1,116 @@
@title Installation Guide
@group intro
This document contains basic install instructions to get Phabricator up and
running.
= Installation Requirements =
Phabricator is a LAMP application suite, so you basically need LAMP:
- **Linux**: Some flavor of Linux is required. Mac OS X is an acceptable
flavor of Linux. Windows is not an acceptable flavor of Linux. Phabricator
will not install or work properly on Windows. (If you want it to, send
patches.) Phabricator has active contributors running it on Mac OS X, Amazon
Linux, Ubuntu, RHEL and CentOS; if you run into issues on other flavors,
send patches or complaints.
- **Apache**: You need Apache. You might be able to use something else, but
you're on your own.
- **MySQL**: You need MySQL.
- **PHP**: You need PHP 5.2 or newer.
You'll probably also need a **domain name** and you'll certainly need
**a computer** with a connection to **the internet**.
= Installing Required Components =
If you are installing on Ubuntu or an RedHat derivative, there are install
scripts available which should handle most of the things discussed in this
document for you:
- **RedHat Derivatives**: <http://phabricator.com/rsrc/install/install_rhel-derivs.sh>
- **Ubuntu**: <http://phabricator.com/rsrc/install/install_ubuntu.sh>
If those work for you, you can skip directly to the
@{article:Configuration Guide}. These scripts are also available in the
##scripts/install## directory in the project itself.
Otherwise, here's a general description of what you need to install:
- git (usually called "git" in package management systems)
- Apache (usually "httpd" or "apache2")
- MySQL Server (usually "mysqld" or "mysql-server")
- PHP (usually "php")
- Required PHP extensions: mysql, curl, pcntl (these might be something like
"php-mysql" or "php5-mysql")
- Optional PHP extensions: gd, apc (special instructions for APC are available
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.
It may also be helpful to refer to the install scripts above, even if they don't
work for your system.
Now that you have all that stuff installed, grab Phabricator and its
dependencies:
$ cd somewhere/ # pick some install directory
somewhere/ $ git clone git://github.com/facebook/libphutil.git
somewhere/ $ git clone git://github.com/facebook/arcanist.git
somewhere/ $ git clone git://github.com/facebook/phabricator.git
somewhere/ $ cd phabricator
somewhere/phabricator/ $ git submodule update --init
= Installing APC (Optional) =
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".
= Installing XHProf (Optional) =
XHProf is a PHP profiling tool. You don't need to install it unless you are
developing Phabricator and making performance changes.
You can find installation instructions for xhprof here:
http://mirror.facebook.net/facebook/xhprof/doc.html#installation
You only need to install the PHP extension, not any of the library.
+= Updating Phabricator =
+
+Since Phabricator is under active development, you should update frequently.
+You can use a script similar to this one to automate the process:
+
+ http://phabricator.com/rsrc/install/update_phabricator.sh
+
= Next Steps =
Continue by:
- configuring Phabricator with the @{article:Configuration Guide}.

File Metadata

Mime Type
text/x-diff
Expires
Thu, Aug 14, 4:08 AM (3 d, 10 h ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
202178
Default Alt Text
(6 KB)

Event Timeline

styx copyright 2020 sirocyl / ellie (kymkdd) / ncommander / styx contributors
Use of other names and brands is not intended to reflect a claim of, or right to, use the name or brand.
styx is an operating system using the Linux kernel and components, and "styx Linux" as a phrase does not reflect the inclusion of the Linux brand or trademark in the styx project.
Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.
Terms and Conditions (TODO: fix this!)