netmaker/docs/upgrades.rst

=====================================
Upgrades
=====================================

Introduction
===============

As of 0.10.0, upgrading Netmaker is a manual process. This is expected to be automated in the future, but for now is still a relatively straightforward process. 

Critical Notes for 0.10.0
=============================================

At the time of this writing, an upgrade process has not been defined for 0.10.0. DO NOT follow this documentation to upgrade from a prior version to 0.10.0. An upgrade process will be defined shortly. For now, if you seek to upgrade to 0.10.0, you must clear your server entirely (docker-compose down --volumes), uninstall your netclients, and re-install netmaker + netclients.

Upgrade the Server (prior to 0.10.0)
======================================

To upgrade the server, you only need to change the docker image versions:

1. `ssh root@my-server-ip`
2. `docker-compose down`
3. `vi docker-compose.yml`
4. Change gravitl/netmaker:<version> and gravitl/netmaker-ui:<version> to the new version.
5. Save and close the file
6. `docker-compose up -d`

Upgrade the Clients (prior to 0.10.0)
======================================

To upgrade the client, you must get the new client binary and place it in /etc/netclient. Depending on the new vs. old version, there may be minor incompatibilities (discussed below).

1. Vists https://github.com/gravitl/netmaker/releases/
2. Find the appropriate binary for your machine.
3. Download. E.x.: `wget https://github.com/gravitl/netmaker/releases/download/vX.X.X/netclient-myversion`
4. Rename binary to `netclient` and move to folder. E.x.: `mv netclient-myversion /etc/netclient/netclient`
5. `netclient --version` (confirm it's the correct version)
6. `netclient pull`

This last step helps ensure any newly added fields are now present. You may run into a "panic" based on missing fields and your version mismatch. In such cases, you can either:

1. Add the missing field to /etc/netclient/config/netconfig-yournetwork and then run "netclient checkin"

or

2. Leave and rejoin the network
updated docs 2022-01-14 06:55:54 +08:00			`=====================================`
			`Upgrades`
			`=====================================`

			`Introduction`
			`===============`

updating docs 2022-02-09 22:11:01 +08:00			`As of 0.10.0, upgrading Netmaker is a manual process. This is expected to be automated in the future, but for now is still a relatively straightforward process.`
updated docs 2022-01-14 06:55:54 +08:00
updating docs 2022-02-09 22:11:01 +08:00			`Critical Notes for 0.10.0`
			`=============================================`

			`At the time of this writing, an upgrade process has not been defined for 0.10.0. DO NOT follow this documentation to upgrade from a prior version to 0.10.0. An upgrade process will be defined shortly. For now, if you seek to upgrade to 0.10.0, you must clear your server entirely (docker-compose down --volumes), uninstall your netclients, and re-install netmaker + netclients.`

			`Upgrade the Server (prior to 0.10.0)`
			`======================================`
updated docs 2022-01-14 06:55:54 +08:00
0.9.4 docs 2022-01-16 23:09:19 +08:00			`To upgrade the server, you only need to change the docker image versions:`
updated docs 2022-01-14 06:55:54 +08:00
0.9.4 docs 2022-01-16 23:09:19 +08:00			1. `ssh root@my-server-ip`
minor fix 2022-01-23 01:57:59 +08:00			2. `docker-compose down`
0.9.4 docs 2022-01-16 23:09:19 +08:00			3. `vi docker-compose.yml`
			`4. Change gravitl/netmaker:<version> and gravitl/netmaker-ui:<version> to the new version.`
			`5. Save and close the file`
			6. `docker-compose up -d`
updated docs 2022-01-14 06:55:54 +08:00
updating docs 2022-02-09 22:11:01 +08:00			`Upgrade the Clients (prior to 0.10.0)`
			`======================================`
updated docs 2022-01-14 06:55:54 +08:00
0.9.4 docs 2022-01-16 23:09:19 +08:00			`To upgrade the client, you must get the new client binary and place it in /etc/netclient. Depending on the new vs. old version, there may be minor incompatibilities (discussed below).`
updated docs 2022-01-14 06:55:54 +08:00
0.9.4 docs 2022-01-16 23:09:19 +08:00			`1. Vists https://github.com/gravitl/netmaker/releases/`
			`2. Find the appropriate binary for your machine.`
			3. Download. E.x.: `wget https://github.com/gravitl/netmaker/releases/download/vX.X.X/netclient-myversion`
			4. Rename binary to `netclient` and move to folder. E.x.: `mv netclient-myversion /etc/netclient/netclient`
			5. `netclient --version` (confirm it's the correct version)
			6. `netclient pull`
updated docs 2022-01-14 06:55:54 +08:00
0.9.4 docs 2022-01-16 23:09:19 +08:00			`This last step helps ensure any newly added fields are now present. You may run into a "panic" based on missing fields and your version mismatch. In such cases, you can either:`
updated docs 2022-01-14 06:55:54 +08:00
0.9.4 docs 2022-01-16 23:09:19 +08:00			`1. Add the missing field to /etc/netclient/config/netconfig-yournetwork and then run "netclient checkin"`
updated docs 2022-01-14 06:55:54 +08:00
0.9.4 docs 2022-01-16 23:09:19 +08:00			`or`
updated docs 2022-01-14 06:55:54 +08:00
0.9.4 docs 2022-01-16 23:09:19 +08:00			`2. Leave and rejoin the network`