You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/upgrading.md
+39-28Lines changed: 39 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,47 +3,47 @@ id: upgrading
3
3
title: Upgrading
4
4
---
5
5
6
-
Here is basic tutorial how to perform upgrades since 2.04 version. This version can update database automatically from any previous LHC version. Since 3.30v we require `composer` dependencies to be installed if you are installing from source code.
6
+
This is a basic tutorial on how to perform upgrades since version 2.04. This version can automatically update the database from any previous LHC version. Since version 3.30, we require `composer` dependencies to be installed if you are installing from source code.
7
7
8
-
If you are upgrading from older version to any version 3.30v and higher you have to install composer dependencies.
8
+
If you are upgrading from an older version to any version 3.30 or higher, you must install composer dependencies.
9
9
```
10
10
cd lhc_web
11
11
composer.phar install
12
12
```
13
13
14
-
If you don't have `composer.phar` you can download it from https://getcomposer.org/download/
14
+
If you don't have `composer.phar`, you can download it from https://getcomposer.org/download/.
15
15
16
-
* You can download version with dependencies included https://github.com/LiveHelperChat/livehelperchat/releases look for newest file name`*.**v-with-dependencies.tgz`**8.2 PHP** version is required.
16
+
* You can download a version with dependencies included from https://github.com/LiveHelperChat/livehelperchat/releases. Look for the newest file named`*.**v-with-dependencies.tgz`.**PHP version 8.2** is required.
17
17
18
-
It has a folder `lib/vendor` in it so you don't need to install composer thing yourself. Copy it to `lib/vendor`
18
+
This file includes a folder `lib/vendor`, so you don't need to install composer yourself. Just copy it to `lib/vendor`.
19
19
20
-
1. Read the new version announcement article for any possible changes in settings/settings.ini.php. If the article does not mention anything, you do not have to do anything.
20
+
1. Read the new version announcement article for any possible changes in `settings/settings.ini.php`. If the article does not mention anything, you do not have to do anything.
21
21
2. Go to "System" -> "Update information" and check if LHC finds any differences in the database. If it does, click on "Update database." You may not see differences if your server does not allow making requests to remote URLs.
22
-
* You need to run these commands from the root folder (where index.php is located)
22
+
* You need to run these commands from the root folder (where `index.php` is located).
23
23
*`php cron.php -s site_admin -c cron/util/update_database` tries to update the database from a remote URL. If this does not work, run:
24
24
*`php cron.php -s site_admin -c cron/util/update_database -p local` after replacing all files.
25
-
3. If you accidentally override files before updating the database, you can:
26
-
1.[Update the database from the local definition](system/command.md#updates-live-helper-chat-database-directly-from-console)
27
-
2. Copy `doc/shell/upgrade.php`to the root folder, the same folder where `index.php` exists.
25
+
3. If you accidentally overwrite files before updating the database, you can:
26
+
1.[Update the database from the local definition](system/command.md#updates-live-helper-chat-database-directly-from-console).
27
+
2. Copy `doc/shell/upgrade.php` to the root folder, the same folder where `index.php` exists.
28
28
1. In your browser, enter `https://example.com/upgrade.php` to update the database directly.
29
29
4. Log out from LHC.
30
-
5.[Download the most recent LHC version](http://livehelperchat.com/article/static/5) Overwrite `doc`,`ezcomponents`,`lib`,`modules`,`pos`,`translations`,`design` folders. Also, overwrite `index.php` and `cron.php` files with the new version.
31
-
1.https://github.com/remdex/livehelperchat/archive/master.zip - latest master branch zip without composer denpendencies
30
+
5.[Download the most recent LHC version](http://livehelperchat.com/article/static/5). Overwrite the following folders: `doc`,`ezcomponents`,`lib`,`modules`,`pos`,`translations`, and `design`. Also, overwrite `index.php` and `cron.php` files with the new version.
31
+
1.https://github.com/remdex/livehelperchat/archive/master.zip - latest master branch zip without composer dependencies.
32
32
2.https://github.com/LiveHelperChat/livehelperchat/releases - latest release with composer dependencies.
33
33
6. Overwrite `composer.json` and `composer.lock` files and run `composer.phar install` or `composer.phar update` command.
34
-
7. Disable [cache in settings.ini.php](debug.md#disabling-cache)
35
-
8. Log in to LHC again and go to `"System configuration" -> "Clear Cache" and click Clear Cache`
36
-
1. You can also clear the cache by executing this command from the command line: `php cron.php -s site_admin -c cron/util/clear_cache`
37
-
9. Now you can re-enable the cache in your `settings.ini.php`
38
-
10. If you still encounter errors, then [Enable debug output](debug.md)
34
+
7. Disable [cache in `settings.ini.php`](debug.md#disabling-cache).
35
+
8. Log in to LHC again and go to `"System configuration" -> "Clear Cache"` and click "Clear Cache."
36
+
1. You can also clear the cache by executing this command from the command line: `php cron.php -s site_admin -c cron/util/clear_cache`.
37
+
9. Now you can re-enable the cache in your `settings.ini.php`.
38
+
10. If you still encounter errors, then [Enable debug output](debug.md).
39
39
40
40
If you are updating from any older version, you can follow this pattern, which can also be applied to new versions:
41
41
42
-
1.[Download the most recent LHC version](http://livehelperchat.com/article/static/5) Overwrite the following folders `doc`,`ezcomponents`,`lib`,`modules`,`pos`,`translations`,`design` folders. Also, overwrite `index.php` and `cron.php` files with the new version.
43
-
2. Install composer dependencies as described above. You can just download most recent https://github.com/LiveHelperChat/livehelperchat/releases`*.**v-with-dependencies.tgz` file and copy `lhc_web/lib/vendor` to your existing installation. This folder should be non existing if you are upgrading from older version than 4.29v
44
-
3. Copy from doc/shell/upgrade.php file to the root folder of LHC.
45
-
4. In your browser, type chatfolder/upgrade.php. It will update the database to the most recent version and clear the cache automatically.
46
-
5. Delete upgrade.php from the root folder.
42
+
1.[Download the most recent LHC version](http://livehelperchat.com/article/static/5). Overwrite the following folders:`doc`,`ezcomponents`,`lib`,`modules`,`pos`,`translations`, and `design`. Also, overwrite `index.php` and `cron.php` files with the new version.
43
+
2. Install composer dependencies as described above. You can just download the most recent `*.**v-with-dependencies.tgz` file from https://github.com/LiveHelperChat/livehelperchat/releasesand copy `lhc_web/lib/vendor` to your existing installation. This folder should not exist if you are upgrading from a version older than 4.29.
44
+
3. Copy `doc/shell/upgrade.php` to the root folder of LHC.
45
+
4. In your browser, type `chatfolder/upgrade.php`. It will update the database to the most recent version and clear the cache automatically.
46
+
5. Delete `upgrade.php` from the root folder.
47
47
48
48
In all cases, I suggest making a backup.
49
49
@@ -52,21 +52,32 @@ In all cases, I suggest making a backup.
0 commit comments