Something went wrong. Try again.
@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.) hq.recaptime.dev/wiki/Phorge
phorge phabricator
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129@title Upgrading Phorge@group introThis document contains instructions for keeping Phorge up to date.Overview========Phorge is under active development, and releases are published regularly.Staying up to date will keep your install secure.We recommend installs upgrade regularly. Upgrades usually gosmoothly and complete in a few minutes. If you put off upgrades for a longtime, it may take a lot more work to bring things up to date if you want accessto a useful new feature or an important security change.Staying On Top of Changes=========================We release a [[https://we.phorge.it/w/changelog | Changelog]],which describes changes over time. You can look at the changelogsfor an idea of what new features are available, upcoming changes, securityinformation, and warnings about compatibility issues or migrations.Stable Branch=============You can either run the `master` or `stable` branch of Phorge. The `stable`branch is a little more stable than `master`, and may be helpful if youadministrate a larger install.We promote `master` to `stable` regularly, then publish the changelog.To switch to `stable`, check the branch out in each working copy: phorge/ $ git checkout stable arcanist/ $ git checkout stableYou can now follow the upgrade process normally.Upgrade Process===============IMPORTANT: You **MUST** restart Phorge after upgrading. For help, see@{article:Restarting Phorge}.IMPORTANT: You **MUST** upgrade `arcanist` and `phorge` at the same time.Phorge runs on many different systems, with many different webservers.Given this diversity, we don't currently maintain a comprehensive upgradescript which can work on any system. However, the general steps are the sameon every system: - Stop the webserver (including `php-fpm`, if you use it). - Stop the daemons with `phorge/bin/phd stop` or `systemctl stop phorge-phd`. - Run `git pull` in `arcanist/` and `phorge/`. - Run `phorge/bin/storage upgrade`. - If using systemd, `systemctl daemon-reload`. - Start the daemons, with `phorge/bin/phd start` or `systemctl start phorge-phd`. - Restart the webserver (and `php-fpm`, if you stopped it earlier).For some more discussion details, see @{article:Configuration Guide}.This template script roughly outlines the steps required to upgrade Phorge.You'll need to adjust paths and commands a bit for your particular system:```lang=sh#!/bin/shset -eset -x# This is an example script for updating Phorge, similar to the one used to# update <https://we.phorge.it/>. It might not work perfectly on your# system, but hopefully it should be easy to adapt. This script is not intended# to work without modifications.# NOTE: This script assumes you are running it from a directory which contains# arcanist/, and phorge/.ROOT=`pwd` # You can hard-code the path here instead.### STOP WEB SERVER AND DAEMONS ################################################ Stop daemons.$ROOT/phorge/bin/phd stop# If using systemd to manage the daemons:# systemctl stop phorge-phd# If running the notification server, stop it.# $ROOT/phorge/bin/aphlict stop# Stop the webserver (apache, nginx, lighttpd, etc). This command will differ# depending on which system and webserver you are running: replace it with an# appropriate command for your system.# NOTE: If you're running php-fpm, you should stop it here too.sudo /etc/init.d/httpd stop### UPDATE WORKING COPIES ######################################################cd $ROOT/arcanistgit pullcd $ROOT/phorgegit pull# Upgrade the database schema. You may want to add the "--force" flag to allow# this script to run noninteractively.$ROOT/phorge/bin/storage upgrade# Restart the webserver. As above, this depends on your system and webserver.# NOTE: If you're running php-fpm, restart it here too.sudo /etc/init.d/httpd start# Restart daemons.# If using systemd, you may need to pick up changes to the phorge-phd unit:# systemctl daemon-reload# systemctl start phorge-phd$ROOT/phorge/bin/phd start# If running the notification server, start it.# $ROOT/phorge/bin/aphlict start```