Node and farmer migration to grid 2.0 documentation

[andhartl]

we have 66 farmers and 600 plus nodes which need to be migrated to grid 2.0.
the main topics are:

• migrate farmers from iyo to 3bot auth
• Zero OS v1.x to Zero OS 2.0
• Zero Tier to Zero Network

Need to prep documentation which farmers can use to migrate

Tasks:

• Farm network documentation
  • How does a farm need to look network wise for 0-OS to behave properly
  • Do and don't
  • Explanation about difference between and public and an hidden node
  • IPv6 getting started for farmer
• Nodes migration
  • test migration from v1 to a v2

[zaibon]

Documentation wise I want us to have the following topic covered for farmers:

• Farm network documentation
  • How does a farm need to look network wise for 0-OS to behave properly
  • Do and don't
  • Explanation about difference between and public and an hidden node
  • IPv6 getting started for farmer

Zero Tier to Zero Network

@andhartl : This is not really a farmer specific topic. This concern more the users. Or did I miss the point ?

migrate farmers from iyo to 3bot auth

This is going to be covered in the cockpit. A migration procedure will be available there.

[andhartl]

@zaibon for me 100% farmer topic.

[andhartl]

@zaibon what do you mean with a hidden node?

[zaibon]

@zaibon for me 100% farmer topic.

can you elaborate. Cause in the current version farmer doesn't have to deal with zerotier network at all. So I must be missing the point.

@zaibon what do you mean with a hidden node?

That is also what farmer will ask, thus the documentation about this concept :-)

[andhartl]

@zaibon mean here the network in the datacenter and ho two set up a datacenter farm. not zero network.

[zaibon]

@andhartl ok got it. So this fall into the first point I made about networks. So we're round. cool :-)

[zaibon]

We have just merged the first documentation regarding the network setup: https://github.com/threefoldtech/zos/tree/master/docs/network

Specifically some documentation on how a farm network should look like: https://github.com/threefoldtech/zos/blob/master/docs/network/setup_farm_network.md

[andhartl]

got the point on network config home versus multi node farm.

not sure if the following questions belong to this repo but they have definitely to do with migration:

• how do we migrate a farmers iyo identity to 3bot authentication?
  I mean not automated migration but rules on which naming to use etc.
  -how do we match node ids (farm organization name in iyo) in previous and new grid version?
  this is needed to check how many month the node is still farming (60 - x). Or are there other ways to do this?

[zaibon]

got the point on network config home versus multi node farm.

👍

how do we migrate a farmers iyo identity to 3bot authentication?

This is not covert in this documentation. I'm working on a more high level document about how to create a farm on the new grid. There I'll cover these question. Here we focus on the hardware only.