Update docs for upgrading (#4009)

This commit is contained in:
Marc Bernard 2020-10-11 04:38:27 -04:00 committed by GitHub
parent c27a0c0b38
commit 47a47c55a2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -5,12 +5,28 @@ order: 20
---
### Manually
Upload the code from [zabapgit.abap](https://raw.githubusercontent.com/abapGit/build/master/zabapgit.abap) into the ZABAPGIT_FULL report.
## Standalone Version
To update to the current version, upload the code from [zabapgit.abap](https://raw.githubusercontent.com/abapGit/build/master/zabapgit.abap) into the ZABAPGIT_STANDALONE report (formerly ZABAPGIT_FULL) and activate the program.
## Developer Version
If you have installed the abapGit developer version (in a separate package like $ABAPGIT), the you can update the code automatically.
### Online project
If the abapGit report is installed in a separate package(eg. $ABAPGIT), a online project can be created. Which will help updating the abapGit code, a "pull" link will appear under the project when there are updates to abapGit.
If your system is connected to the Internet, create an online repository for your abapGit package. When you view the repository and update are available, a "Pull" link will appear in the menu. When you select "Pull", the system will download and install the latest version of the code.
### Offline project
If the abapGit report is installed in a separate package(eg. $ABAPGIT), a offline project can be created.
Download the zip file from [https://github.com/abapGit/abapGit/archive/master.zip](https://github.com/abapGit/abapGit/archive/master.zip), and click "Import Zip" under the project.
If your system is not connected to the Internet, create an offline repository. To update abapGit download the zip file from [https://github.com/abapGit/abapGit/archive/master.zip](https://github.com/abapGit/abapGit/archive/master.zip), and select "Import Zip" in your abapGit repository.
### Troubleshooting
Updates to abapGit can on occasion be quite significant and cause issues like inactive objects, diffs, or even dumps. If you run into such issues, please proceed as follow:
1. Install and activate the latest standalone version (see above).
2. Run the standalone version to update the abapGit developer version.
3. If the update does not complete, delete any inactive objects or objects with diffs completely (like inactive classes in SE24).
4. Restart the standalone version and perform a new "Pull" or "Import Zip".
5. If this does not resolve the problem, open an issue on [GitHub](https://github.com/abapGit/abapGit/issues).