Skip to content

Commit 88294e2

Browse files
committed
update: Upgrade Section & Extensions
This is a partial rewrite of 6365. This moves the Upgrade section to the `UPGRADING.txt` file and updates the verbiage to link to the Upgrade Guide in the docs as well as the `UPGRADING.txt` file. In addition this updates the recommended extensions for PHP to reflect what's shown in Admin Panel > Dashboard > Information. Lastly, this updates various links in the `README.md` and `UPGRADING.txt` files.
1 parent 555c4a7 commit 88294e2

File tree

2 files changed

+36
-31
lines changed

2 files changed

+36
-31
lines changed

README.md

Lines changed: 6 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,9 @@ Requirements
2727
* MySQL database version 5.5 (or greater)
2828

2929
### Recommendations
30-
* gd, gettext, imap, json, mbstring, and xml extensions for PHP
31-
* APC module enabled and configured for PHP
30+
* fileinfo, gd, gettext, imap, intl, json, mbstring, Zend OPcache, phar,
31+
xml, xml-dom, and zip extensions for PHP
32+
* APCu module enabled and configured for PHP
3233

3334
Deployment
3435
----------
@@ -58,33 +59,9 @@ Upgrading
5859
---------
5960
osTicket supports upgrading from 1.6-rc1 and later versions. As with any
6061
upgrade, strongly consider a backup of your attachment files, database, and
61-
osTicket codebase before embarking on an upgrade.
62-
63-
To trigger the update process, fetch the osTicket tarball from either
64-
the osTicket [github](http://github.com/osTicket/osTicket/releases) page
65-
or from the [osTicket website](https://osticket.com). Extract the tarball
66-
into the folder of your osTicket codebase. This can also be accomplished
67-
with the zip file, and a FTP client can of course be used to upload the new
68-
source code to your server.
69-
70-
Any way you choose your adventure, when you have your codebase upgraded to
71-
osTicket-1.7, visit the /scp page of you ticketing system. The upgrader will
72-
be presented and will walk you through the rest of the process. (The couple
73-
clicks needed to go through the process are pretty boring to describe).
74-
75-
### Upgrading from v1.6
76-
**WARNING**: If you are upgrading from osTicket 1.6, please ensure that all
77-
your files in your upload folder are both readable and writable to your
78-
http server software. Unreadable files will not be migrated to the
79-
database during the upgrade and will be effectively lost.
80-
81-
After upgrading, we recommend migrating your attachments to the database or
82-
to the new filesystem plugin. Use the `file` command-line applet to perform
83-
the migration.
84-
85-
php manage.php file migrate --backend=6 --to=D
86-
87-
View the UPGRADING.txt file for other todo items to complete your upgrade.
62+
osTicket codebase before embarking on an upgrade. Please review our [Upgrade
63+
Guide](https://docs.osticket.com/en/latest/Getting%20Started/Upgrade%20and%20Migration.html)
64+
or the [UPGRADING.txt file](UPGRADING.txt) for upgrade instructions.
8865

8966
Help
9067
----

UPGRADING.txt

Lines changed: 30 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,33 @@
1-
Welcome to osTicket 1.7
2-
=======================
1+
Upgrading osTicket
2+
==================
3+
osTicket supports upgrading from 1.6-rc1 and later versions. As with any
4+
upgrade, strongly consider a backup of your attachment files, database, and
5+
osTicket codebase before embarking on an upgrade.
6+
7+
To trigger the update process, fetch the osTicket tarball from either
8+
the osTicket [GitHub](https://github.com/osTicket/osTicket/releases) page
9+
or from the [osTicket website](https://osticket.com/download). Extract the tarball
10+
into the folder of your osTicket codebase. This can also be accomplished
11+
with the zip file, and a FTP client can of course be used to upload the new
12+
source code to your server.
13+
14+
Any way you choose your adventure, when you have your codebase upgraded,
15+
visit the /scp page of you ticketing system. The upgrader will
16+
be presented and will walk you through the rest of the process. (The couple
17+
clicks needed to go through the process are pretty boring to describe).
18+
19+
### Upgrading from v1.6
20+
**WARNING**: If you are upgrading from osTicket 1.6, please ensure that all
21+
your files in your upload folder are both readable and writable to your
22+
http server software. Unreadable files will not be migrated to the
23+
database during the upgrade and will be effectively lost.
24+
25+
After upgrading, we recommend migrating your attachments to the database or
26+
to the new filesystem plugin. Use the `file` command-line applet to perform
27+
the migration.
28+
29+
php manage.php file migrate --backend=6 --to=D
30+
331
Some tasks are better left to a system administrator rather than a mindless
432
upgrade script. These are those remaining things that we'd rather you take
533
care of:

0 commit comments

Comments
 (0)