Skip to content

Commit e49b1d0

Browse files
authored
"Preparing OCLP for macOS" update segment and app ver check
1 parent e4838d3 commit e49b1d0

File tree

2 files changed

+47
-19
lines changed

2 files changed

+47
-19
lines changed

docs/UPDATE.md

Lines changed: 47 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,28 @@
1-
# Updating OpenCore and Patches
1+
# Updating
22

33
This guide explains how to get fully up to date application, bootloader and patches.
44

5-
## Updating the application
5+
## Updating the application, OpenCore and patches
66

77
Latest versions of OCLP can download updates by themselves, you will get notified of a new update with the changelog.
88

99
[You can also manually download the latest release here.](https://github.com/dortania/OpenCore-Legacy-Patcher/releases)
1010

11-
12-
<div align="left">
13-
<img src="./images/OCLP_Update_Available.png" alt="Update Avaialble" />
14-
</div>
15-
16-
17-
## Updating patches
18-
1911
After the update, the application asks if you want to update OpenCore and root patches.
2012

2113
If you do not need to change any settings, you can click "Yes" and follow the procedure. If you want to change settings, select "No" from here and do your settings, then manually build and install OpenCore to update to the latest version of the bootloader.
2214

2315
Finally install new root patches to ensure you're running on the latest fixes for on-disk patches.
2416

2517

26-
<div align="left">
27-
<img src="./images/OCLP_Update_Successful.png" alt="Update Successful" />
28-
</div>
18+
| Update available | Update successful |
19+
| :--- | :--- |
20+
| <img src="./images/OCLP_Update_Available.png" alt="Update Available" width="500" /> | <img src="./images/OCLP_Update_Successful.png" alt="Update Successful" width="400" /> |
21+
2922

30-
## Checking OCLP and OpenCore versions
23+
#### Checking OCLP and OpenCore versions
3124

32-
To check what version of OpenCore bootloader and the Patcher you're currently running, you can run the following in the terminal:
25+
To check what version of OpenCore bootloader and the Patcher you're currently running, open the OCLP application and navigate to `Settings -> App` and look for "Booted Information". Alternatively you can check the version from Terminal using the following commands.
3326

3427
```bash
3528
# OpenCore Version
@@ -38,8 +31,43 @@ nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version
3831
nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version
3932
```
4033

41-
<div align="left">
42-
<img src="./images/oclp-version.png" alt="OCLP version" width="600" />
43-
</div>
4434

45-
From this, we can see that we're running a RELEASE version of OpenCore 0.9.0 built on January 1st, 2023 with Patcher Version 0.6.0!
35+
| Version in app | Version in Terminal |
36+
| :--- | :--- |
37+
| <img src="./images/OCLP_Booted_Version.png" alt="Build start" width="600" /> | <img src="./images/oclp-version.png" alt="OCLP version" width="900" /> |
38+
39+
40+
## Preparing OCLP for macOS update
41+
42+
It is usually recommended to be on the latest OCLP version for macOS updates. This part details how to prepare OCLP for latest update.
43+
44+
### Major upgrades
45+
46+
This part is for major upgrades, such as `Sonoma (14)` -> `Sequoia (15)`
47+
48+
1. Make sure the OCLP app is up to date.
49+
2. After app has updated, rebuild OpenCore to the internal disk to update the bootloader.
50+
* You can also update root patches but this part is optional in this stage, as they will be wiped by the update.
51+
2. Download the macOS version you want and create an installer USB drive using OCLP as detailed in the original [Creating macOS Installers](http://localhost:8080/OpenCore-Legacy-Patcher/INSTALLER.html) then follow the [Booting OpenCore and macOS](https://dortania.github.io/OpenCore-Legacy-Patcher/BOOT.html) guide boot to into the installer on your USB drive.
52+
3. Start macOS installation and follow the process, do not use Disk Utility if you don't want to wipe your disk.
53+
4. After installation, reinstall [root patches](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#applying-post-install-volume-patches).
54+
55+
**Note:** Major upgrades may work using System Settings but this is not recommended.
56+
57+
### Minor updates
58+
59+
This part is for minor updates, which are also called the "dot updates". Such as `12.x`, `13.x` etc.
60+
61+
1. Make sure the OCLP app is up to date.
62+
2. Rebuild OpenCore to the internal disk to update the bootloader.
63+
* You can also update root patches but this part is optional in this stage, as they will be wiped by the update.
64+
3. Start update from System Settings.
65+
4. Once installed, go into OCLP app and reinstall [root patches](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#applying-post-install-volume-patches).
66+
67+
::: warning Important
68+
69+
If your system requires [KDKSupportPkg](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#kdk-kernel-debug-kit), OCLP will react to it automatically during an update installation.
70+
71+
Additionally, some systems on Sequoia require [MetallibSupportPkg](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#metallibsupportpkg) during root patching, which requires internet connection to download. If OCLP doesn't see internet connection, it will first offer a patch for WiFi only. You will have to reboot, connect to the internet and rerun root patching for the rest of the patches.
72+
73+
:::
632 KB
Loading

0 commit comments

Comments
 (0)