Browse code
Fixed some broken links
Change-Id: I17d694780598d9ee0e46d7c579552b65ddc21e9f
Reviewed-on: http://photon-jenkins.eng.vmware.com:8082/5930
Reviewed-by: Stuart Clements <sclements@vmware.com>
Tested-by: Stuart Clements <sclements@vmware.com>
Vidya Vasudevan authored on 2018/10/17 15:05:29Showing 6 changed files
- docs/Photon-RPM-OSTree-5-Host-updating-operations.md
- docs/Photon-RPM-OSTree-6-Installing-a-server.md
- docs/Photon-RPM-OSTree-a-simple-guide.md
- docs/README.md
- docs/SUMMARY.md
- docs/admin-guides.md
| ... | ... |
@@ -1,6 +1,6 @@ |
| 1 | 1 |
# Host Updating Operations |
| 2 | 2 |
|
| 3 |
-## 5.1 Is it an update or an upgrade? |
|
| 3 |
+## 5.1 Is it an update or an upgrade? |
|
| 4 | 4 |
If you've used yum, dnf (and now tdnf for Photon) in RPM systems or apt-get in Debian based Unix, you understand what "install" is for packages and the subtle difference between "update" and "upgrade". |
| 5 | 5 |
|
| 6 | 6 |
OSTree and RPM-OSTree don't distringuish between them and the term "upgrade" has a slightly different meaning - to bring the system in sync with the remote repo, to the top of the Refspec (branch), just like in Git, by pulling the latest changes. |
| ... | ... |
@@ -12,7 +12,7 @@ The reverse operation of an upgrade is a "rollback" and fortunately it's not nam |
| 12 | 12 |
As we'll see in a future chapter, a jump to a different Refspec (branch) is also supported and it's named "rebase". |
| 13 | 13 |
|
| 14 | 14 |
|
| 15 |
-## 5.2 Incremental upgrade |
|
| 15 |
+## 5.2 Incremental upgrade |
|
| 16 | 16 |
To check if there are any updates available, one would execute: |
| 17 | 17 |
``` |
| 18 | 18 |
root@photon-host-def [ ~ ]# rpm-ostree upgrade |
| ... | ... |
@@ -504,5 +504,3 @@ commit 2940e10c4d90ce6da572cbaeeff7b511cab4a64c280bd5969333dd2fca57cfa8 |
| 504 | 504 |
Date: 2015-08-20 22:27:43 +0000 |
| 505 | 505 |
Version: 1.0_minimal |
| 506 | 506 |
``` |
| 507 |
- |
|
| 508 |
-[[Back to main page|Photon-RPM-OSTree:-a-simple-guide]] | [[Previous page|Photon-RPM-OSTree:-4-Querying-for-commit,-file-and-package-metadata]] | [[ Next page >|Photon-RPM-OSTree:-6-Installing-a-server]] |
|
| 509 | 507 |
\ No newline at end of file |
| ... | ... |
@@ -12,7 +12,7 @@ Installation steps are the same to all Photon OS versions, except that under the |
| 12 | 12 |
* Photon 2.0 does not set up a file tree, so there are several steps needed post-install to have a completely functional server that host can deploy from; they will be explained in detail in Chapter 8 and 9, but a quick setup is provided for you later in this chapter. |
| 13 | 13 |
|
| 14 | 14 |
## 6.1 Manual install of a server |
| 15 |
-First, create a new VM in Fusion, Workstation or ESXi box, and go through the [steps common to all installation profiles](Running-Project-Photon-on-Fusion), then select the "Photon OSTree Server" option. |
|
| 15 |
+First, create a new VM in Fusion, Workstation or ESXi box, and go through the [steps common to all installation profiles](Running-Project-Photon-on-Fusion.md), then select the "Photon OSTree Server" option. |
|
| 16 | 16 |
|
| 17 | 17 |
 |
| 18 | 18 |
|
| ... | ... |
@@ -30,7 +30,7 @@ You may ask your network administrator for a static IP, registered to your compa |
| 30 | 30 |
|
| 31 | 31 |
Having the server configured, you may advance to next chapter to [install your own host from this server's repository](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md). That's a way to verify right away that all components (server, network) are running correctly and test the 'minimal' server filetree image by downloading and installing it at the host. |
| 32 | 32 |
|
| 33 |
-## 6.2 Composing your first OSTree repo |
|
| 33 |
+## 6.2 Composing your first OSTree repo |
|
| 34 | 34 |
If you've installed Photon 2.0 OSTree server, the server did not setup a tree as part of an installation, but configuration files for starter 'base', 'minimal' and 'full' tree are there for you. To create a 'minimal' tree, you only need two commands - one to initialize a new repo, the other one to compose it. |
| 35 | 35 |
``` |
| 36 | 36 |
root [ ~ ]# cd /srv/rpm-ostree |
| ... | ... |
@@ -39,7 +39,7 @@ root [ /srv/rpm-ostree ]# rpm-ostree compose tree --repo=repo photon-base.json |
| 39 | 39 |
``` |
| 40 | 40 |
You are now ready to deploy a host, explained in next chapter. Skip to [Chapter 8: File oriented server operations](Photon-RPM-OStree-8-File-oriented-server-operations.md) and [Chapter 9: Package oriented server operations](Photon-RPM-OSTree-9-Package-oriented-server-operations.md) to learn create your own customized file tree. |
| 41 | 41 |
|
| 42 |
-## 6.2 Automated install of a server via kickstart |
|
| 42 |
+## 6.3 Automated install of a server via kickstart |
|
| 43 | 43 |
All Photon OS versions support unattended install, in other words installer will display its progress, but will not prompt for any keys to be clicked, and will boot at the end of installation. This will create an identical server as installing via UI. |
| 44 | 44 |
|
| 45 | 45 |
If not familiar with the way kickstart works, visit [Kickstart Support in Photon OS](kickstart.md). The kickstart json config for OSTree is similar to minimal or full, except for this setting: |
| ... | ... |
@@ -10,8 +10,8 @@ |
| 10 | 10 |
1. [Photon with RPM-OSTree installation profiles](Photon-RPM-OSTree-1-Introduction.md#13-photon-with-rpm-ostree-installation-profiles) |
| 11 | 11 |
1. [Terminology](Photon-RPM-OSTree-1-Introduction.md#14-terminology) |
| 12 | 12 |
1. [Sample code](Photon-RPM-OSTree-1-Introduction.md#15-sample-code) |
| 13 |
- 1. [How to read this book](Photon-RPM-OSTree:-1-Introduction#16-how-to-read-this-book) |
|
| 14 |
- 1. [RPM-OSTree in Photon OS 2.0](Photon-RPM-OSTree:-1-Introduction#17-rpm-ostree-in-photon-os-20) |
|
| 13 |
+ 1. [How to read this book](Photon-RPM-OSTree-1-Introduction.md#16-how-to-read-this-book) |
|
| 14 |
+ 1. [RPM-OSTree in Photon OS 2.0](Photon-RPM-OSTree-1-Introduction.md#17-rpm-ostree-in-photon-os-20) |
|
| 15 | 15 |
2. [Installing a Photon RPM-OSTree host against default server repository](Photon-RPM-OSTree-2-Installing-a-host-against-default-server-repository.md) |
| 16 | 16 |
1. [Who is this for?](Photon-RPM-OSTree-2-Installing-a-host-against-default-server-repository.md#21-who-is-this-for) |
| 17 | 17 |
1. [Installing the ISO, step by step](Photon-RPM-OSTree-2-Installing-a-host-against-default-server-repository.md#22-installing-the-iso-step-by-step) |
| ... | ... |
@@ -32,14 +32,17 @@ |
| 32 | 32 |
5. [Host updating operations](Photon-RPM-OSTree-5-Host-updating-operations.md) |
| 33 | 33 |
1. [Is it an update or an upgrade?](Photon-RPM-OSTree-5-Host-updating-operations.md#51-is-it-an-update-or-an-upgrade) |
| 34 | 34 |
1. [Incremental upgrade](Photon-RPM-OSTree-5-Host-updating-operations.md#52-incremental-upgrade) |
| 35 |
- 1. [Listing file differences](Photon-RPM-OSTree-5-Host-updating-operations.md#52-listing-file-differences) |
|
| 36 |
- 1. [Listing package differences](Photon-RPM-OSTree-5-Host-updating-operations.md#52-listing-package-differences) |
|
| 35 |
+ 1. [Listing file differences](Photon-RPM-OSTree-5-Host-updating-operations.md#53-listing-file-differences) |
|
| 36 |
+ 1. [Listing package differences](Photon-RPM-OSTree-5-Host-updating-operations.md#54-listing-package-differences) |
|
| 37 | 37 |
1. [Rollback](Photon-RPM-OSTree-5-Host-updating-operations.md#55-rollback) |
| 38 | 38 |
1. [Deleting a deployed filetree](Photon-RPM-OSTree-5-Host-updating-operations.md#56-deleting-a-deployed-filetree) |
| 39 | 39 |
1. [Version skipping upgrade](Photon-RPM-OSTree-5-Host-updating-operations.md#57-version-skipping-upgrade) |
| 40 | 40 |
1. [Tracking parent commits](Photon-RPM-OSTree-5-Host-updating-operations.md#58-tracking-parent-commits) |
| 41 | 41 |
1. [Resetting a branch to a previous commit](Photon-RPM-OSTree-5-Host-updating-operations.md#59-resetting-a-branch-to-a-previous-commit) |
| 42 | 42 |
6. [Installing a Photon RPM-OSTree server](Photon-RPM-OSTree-6-Installing-a-server.md) |
| 43 |
+ 1. [Manual install of a server](Photon-RPM-OSTree-6-Installing-a-server.md#61-manual-install-of-a-server) |
|
| 44 |
+ 1. [Composing your first OSTree repo](Photon-RPM-OSTree-6-Installing-a-server.md#62-composing-your-first-ostree-repo) |
|
| 45 |
+ 1. [Automated install of a server via kickstart](Photon-RPM-OSTree-6-Installing-a-server.md#63-automated-install-of-a-server-via-kickstart) |
|
| 43 | 46 |
7. [Installing a Photon RPM-OStree host against a custom server repository](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md) |
| 44 | 47 |
1. [Manual install of a custom host](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md#71-manual-install-of-a-custom-host) |
| 45 | 48 |
1. [Automated install of a custom host via kickstart](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md#72-automated-install-of-a-custom-host-via-kickstart) |
| ... | ... |
@@ -56,8 +59,7 @@ |
| 56 | 56 |
1. [Composing a tree](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#94-composing-a-tree) |
| 57 | 57 |
1. [Automatic version prefix](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#95-automatic-version-prefix) |
| 58 | 58 |
1. [Installing package updates](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#96-installing-package-updates) |
| 59 |
- 1. [Creating server metadata](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#97-creating-server-metadata) |
|
| 60 |
- 1. [Starting a fresh OSTree repo](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#98-starting-a-fresh-ostree-repo) |
|
| 59 |
+ 1. [Composing for a different branch](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#97-composing-for-a-different-branch) |
|
| 61 | 60 |
10. [Remotes](Photon-RPM-OSTree-10-Remotes.md) |
| 62 | 61 |
1. [Listing remotes](Photon-RPM-OSTree-10-Remotes.md#101-listing-remotes) |
| 63 | 62 |
1. [GPG signature verification](Photon-RPM-OSTree-10-Remotes.md#102-gpg-signature-verification) |
| ... | ... |
@@ -14,10 +14,10 @@ This information is intended for Photon OS administrators and developers. |
| 14 | 14 |
|
| 15 | 15 |
---------- |
| 16 | 16 |
|
| 17 |
-Copyright © 2016-2018 VMware, Inc. All rights reserved. [Copyright and trademark information](http://pubs.vmware.com/copyright-trademark.html). Any feedback you provide to VMware is subject to the terms at [www.vmware.com/community_terms.html](http://www.vmware.com/community_terms.html). |
|
| 17 |
+Copyright © 2016-2018 VMware, Inc. All rights reserved. [Copyright and trademark information](http://pubs.vmware.com/copyright-trademark.html). Any feedback you provide to VMware is subject to the terms at [www.vmware.com/community_terms.html](https://www.vmware.com/community_terms.html). |
|
| 18 | 18 |
|
| 19 | 19 |
**VMware, Inc.**<br> |
| 20 | 20 |
3401 Hillview Ave.<br> |
| 21 | 21 |
Palo Alto, CA 94304 |
| 22 | 22 |
|
| 23 |
-[www.vmware.com](http://www.vmware.com) |
|
| 23 |
+[www.vmware.com](https://www.vmware.com) |
| ... | ... |
@@ -33,8 +33,9 @@ |
| 33 | 33 |
1. [Photon with RPM-OSTree installation profiles](Photon-RPM-OSTree-1-Introduction.md#13-photon-with-rpm-ostree-installation-profiles) |
| 34 | 34 |
1. [Terminology](Photon-RPM-OSTree-1-Introduction.md#14-terminology) |
| 35 | 35 |
1. [Sample code](Photon-RPM-OSTree-1-Introduction.md#15-sample-code) |
| 36 |
- 1. [How to read this book](Photon-RPM-OSTree:-1-Introduction#16-how-to-read-this-book) |
|
| 37 |
- 1. [RPM-OSTree in Photon OS 2.0](Photon-RPM-OSTree:-1-Introduction#17-rpm-ostree-in-photon-os-20) |
|
| 36 |
+ 1. [How to read this book](Photon-RPM-OSTree-1-Introduction.md#16-how-to-read-this-book) |
|
| 37 |
+ 1. [Difference between versions |
|
| 38 |
+](Photon-RPM-OSTree-1-Introduction.md#17-difference-between-versions) |
|
| 38 | 39 |
2. [Installing a Photon RPM-OSTree host against default server repository](Photon-RPM-OSTree-2-Installing-a-host-against-default-server-repository.md) |
| 39 | 40 |
1. [Who is this for?](Photon-RPM-OSTree-2-Installing-a-host-against-default-server-repository.md#21-who-is-this-for) |
| 40 | 41 |
1. [Installing the ISO, step by step](Photon-RPM-OSTree-2-Installing-a-host-against-default-server-repository.md#22-installing-the-iso-step-by-step) |
| ... | ... |
@@ -55,14 +56,17 @@ |
| 55 | 55 |
5. [Host updating operations](Photon-RPM-OSTree-5-Host-updating-operations.md) |
| 56 | 56 |
1. [Is it an update or an upgrade?](Photon-RPM-OSTree-5-Host-updating-operations.md#51-is-it-an-update-or-an-upgrade) |
| 57 | 57 |
1. [Incremental upgrade](Photon-RPM-OSTree-5-Host-updating-operations.md#52-incremental-upgrade) |
| 58 |
- 1. [Listing file differences](Photon-RPM-OSTree-5-Host-updating-operations.md#52-listing-file-differences) |
|
| 59 |
- 1. [Listing package differences](Photon-RPM-OSTree-5-Host-updating-operations.md#52-listing-package-differences) |
|
| 58 |
+ 1. [Listing file differences](Photon-RPM-OSTree-5-Host-updating-operations.md#53-listing-file-differences) |
|
| 59 |
+ 1. [Listing package differences](Photon-RPM-OSTree-5-Host-updating-operations.md#54-listing-package-differences) |
|
| 60 | 60 |
1. [Rollback](Photon-RPM-OSTree-5-Host-updating-operations.md#55-rollback) |
| 61 | 61 |
1. [Deleting a deployed filetree](Photon-RPM-OSTree-5-Host-updating-operations.md#56-deleting-a-deployed-filetree) |
| 62 | 62 |
1. [Version skipping upgrade](Photon-RPM-OSTree-5-Host-updating-operations.md#57-version-skipping-upgrade) |
| 63 | 63 |
1. [Tracking parent commits](Photon-RPM-OSTree-5-Host-updating-operations.md#58-tracking-parent-commits) |
| 64 | 64 |
1. [Resetting a branch to a previous commit](Photon-RPM-OSTree-5-Host-updating-operations.md#59-resetting-a-branch-to-a-previous-commit) |
| 65 | 65 |
6. [Installing a Photon RPM-OSTree server](Photon-RPM-OSTree-6-Installing-a-server.md) |
| 66 |
+ 1. [Manual install of a server](Photon-RPM-OSTree-6-Installing-a-server.md#61-manual-install-of-a-server) |
|
| 67 |
+ 1. [Composing your first OSTree repo](Photon-RPM-OSTree-6-Installing-a-server.md#62-composing-your-first-ostree-repo) |
|
| 68 |
+ 1. [Automated install of a server via kickstart](Photon-RPM-OSTree-6-Installing-a-server.md#63-automated-install-of-a-server-via-kickstart) |
|
| 66 | 69 |
7. [Installing a Photon RPM-OStree host against a custom server repository](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md) |
| 67 | 70 |
1. [Manual install of a custom host](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md#71-manual-install-of-a-custom-host) |
| 68 | 71 |
1. [Automated install of a custom host via kickstart](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md#72-automated-install-of-a-custom-host-via-kickstart) |
| ... | ... |
@@ -79,8 +83,7 @@ |
| 79 | 79 |
1. [Composing a tree](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#94-composing-a-tree) |
| 80 | 80 |
1. [Automatic version prefix](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#95-automatic-version-prefix) |
| 81 | 81 |
1. [Installing package updates](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#96-installing-package-updates) |
| 82 |
- 1. [Creating server metadata](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#97-creating-server-metadata) |
|
| 83 |
- 1. [Starting a fresh OSTree repo](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#98-starting-a-fresh-ostree-repo) |
|
| 82 |
+ 1. [Composing for a different branch](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#97-composing-for-a-different-branch) |
|
| 84 | 83 |
10. [Remotes](Photon-RPM-OSTree-10-Remotes.md) |
| 85 | 84 |
1. [Listing remotes](Photon-RPM-OSTree-10-Remotes.md#101-listing-remotes) |
| 86 | 85 |
1. [GPG signature verification](Photon-RPM-OSTree-10-Remotes.md#102-gpg-signature-verification) |
| ... | ... |
@@ -36,14 +36,17 @@ |
| 36 | 36 |
5. [Host updating operations](Photon-RPM-OSTree-5-Host-updating-operations.md) |
| 37 | 37 |
1. [Is it an update or an upgrade?](Photon-RPM-OSTree-5-Host-updating-operations.md#51-is-it-an-update-or-an-upgrade) |
| 38 | 38 |
1. [Incremental upgrade](Photon-RPM-OSTree-5-Host-updating-operations.md#52-incremental-upgrade) |
| 39 |
- 1. [Listing file differences](Photon-RPM-OSTree-5-Host-updating-operations.md#52-listing-file-differences) |
|
| 40 |
- 1. [Listing package differences](Photon-RPM-OSTree-5-Host-updating-operations.md#52-listing-package-differences) |
|
| 39 |
+ 1. [Listing file differences](Photon-RPM-OSTree-5-Host-updating-operations.md#53-listing-file-differences) |
|
| 40 |
+ 1. [Listing package differences](Photon-RPM-OSTree-5-Host-updating-operations.md#54-listing-package-differences) |
|
| 41 | 41 |
1. [Rollback](Photon-RPM-OSTree-5-Host-updating-operations.md#55-rollback) |
| 42 | 42 |
1. [Deleting a deployed filetree](Photon-RPM-OSTree-5-Host-updating-operations.md#56-deleting-a-deployed-filetree) |
| 43 | 43 |
1. [Version skipping upgrade](Photon-RPM-OSTree-5-Host-updating-operations.md#57-version-skipping-upgrade) |
| 44 | 44 |
1. [Tracking parent commits](Photon-RPM-OSTree-5-Host-updating-operations.md#58-tracking-parent-commits) |
| 45 | 45 |
1. [Resetting a branch to a previous commit](Photon-RPM-OSTree-5-Host-updating-operations.md#59-resetting-a-branch-to-a-previous-commit) |
| 46 | 46 |
6. [Installing a Photon RPM-OSTree server](Photon-RPM-OSTree-6-Installing-a-server.md) |
| 47 |
+ 1. [Manual install of a server](Photon-RPM-OSTree-6-Installing-a-server.md#61-manual-install-of-a-server) |
|
| 48 |
+ 1. [Composing your first OSTree repo](Photon-RPM-OSTree-6-Installing-a-server.md#62-composing-your-first-ostree-repo) |
|
| 49 |
+ 1. [Automated install of a server via kickstart](Photon-RPM-OSTree-6-Installing-a-server.md#63-automated-install-of-a-server-via-kickstart) |
|
| 47 | 50 |
7. [Installing a Photon RPM-OStree host against a custom server repository](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md) |
| 48 | 51 |
1. [Manual install of a custom host](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md#71-manual-install-of-a-custom-host) |
| 49 | 52 |
1. [Automated install of a custom host via kickstart](Photon-RPM-OSTree-7-Installing-a-host-against-a-custom-server-repository.md#72-automated-install-of-a-custom-host-via-kickstart) |
| ... | ... |
@@ -60,8 +63,7 @@ |
| 60 | 60 |
1. [Composing a tree](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#94-composing-a-tree) |
| 61 | 61 |
1. [Automatic version prefix](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#95-automatic-version-prefix) |
| 62 | 62 |
1. [Installing package updates](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#96-installing-package-updates) |
| 63 |
- 1. [Creating server metadata](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#97-creating-server-metadata) |
|
| 64 |
- 1. [Starting a fresh OSTree repo](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#98-starting-a-fresh-ostree-repo) |
|
| 63 |
+ 1. [Composing for a different branch](Photon-RPM-OSTree-9-Package-oriented-server-operations.md#97-composing-for-a-different-branch) |
|
| 65 | 64 |
9. [Remotes](Photon-RPM-OSTree-10-Remotes.md) |
| 66 | 65 |
1. [Listing remotes](Photon-RPM-OSTree-10-Remotes.md#101-listing-remotes) |
| 67 | 66 |
1. [GPG signature verification](Photon-RPM-OSTree-10-Remotes.md#102-gpg-signature-verification) |