{"type":"doc","content":[{"type":"paragraph","content":[{"text":"You can configure Platform to support multi-subnet architectures, in which each subnet uses its own PXE boot server. This is performed by installing Platform Server for the first subnet, then installing additional MaaS rack servers for each additional subnet. These additional rack servers register with the primary Platform Server, which is used for all normal operations.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"e63948dc-69fb-421d-9e17-b1e69afd4456"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"fc6d0fb4-02a4-4378-9abb-79ce9991866b"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Components","type":"text"}]},{"type":"paragraph","content":[{"text":"For a multi-subnet scenario, there are the following components and roles:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1 Region Server","type":"text","marks":[{"type":"strong"}]},{"text":" (your ","type":"text"},{"text":"Primary server","type":"text","marks":[{"type":"strong"}]},{"text":") which is a normal installation of the Platform Server.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This service is responsible for all configuration and management.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This server provides all services: DNS, HTTP Proxy, NTP, Syslog, etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Platform Server may or may not manage its own storage subnet with storage nodes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"em"}]},{"text":": It must be reachable by all rack servers and all storage nodes, regardless of which subnet they live on.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1+ Rack Servers","type":"text","marks":[{"type":"strong"}]},{"text":" to provide DHCP/PXE capabilities for the respective subnet.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The rack server does not provide any services except two:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DHCP/PXE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a service that provides cluster config to storage nodes when they boot","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The storage config service does not contain any local config: it reads the config that is stored on the primary region server.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Versions","type":"text","marks":[{"type":"strong"}]},{"text":" — Verify packages with these 10.0 versions or higher are obtained:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CaringoPlatformServer10.0*.ova","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CaringoPlatformRackServer10.0*.ova","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"caringo-platform-10.0*.zip","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Networking ","type":"text","marks":[{"type":"strong"}]},{"text":"— Neither the primary region server nor any secondary rack servers participate in network routing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installing the Rack Server","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow the method for your installation method:","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Required","type":"text"}]},{"type":"paragraph","content":[{"text":"Before installing a rack server, complete ","type":"text"},{"text":"Platform Installation","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/public/pages/2443827854"}}]},{"text":" of your Primary Region Server through the bootstrap step, at minimum.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Bare Metal","type":"text"}]},{"type":"paragraph","content":[{"text":"To install a rack server, you proceed as if for a primary region server with one change: When running the ","type":"text"},{"text":"installplatform.sh","type":"text","marks":[{"type":"code"}]},{"text":" script, you must include an extra flag (","type":"text"},{"text":"-r","type":"text","marks":[{"type":"code"}]},{"text":") that indicates the IP of the primary region server. The IP given ","type":"text"},{"text":"must ","type":"text","marks":[{"type":"em"}]},{"text":"be reachable by both the rack server and its associated storage nodes.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the script with the ","type":"text"},{"text":"-r","type":"text","marks":[{"type":"code"}]},{"text":" flag:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo ./installplatform.sh -i INTERFACE -r PRIMARY·SERVER·IP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once this is completes, the CLI is installed on the rack server, and is automatically configured to point to the primary server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the rack server, use this command to see the new subnets that are managed by the rack server: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"platform list subnets --all","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"OVA","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Complete all necessary hostname and network configuration. ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Multiple rack servers

If you have more than one rack server, change the hostname before doing anything else, to avoid name collision. To change the host name for the server,

Edit the hosts file: /etc/hostname and /etc/hosts
Reboot.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Multiple rack servers","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have more than one rack server, change the hostname before doing anything else, to avoid name collision. To change the host name for the server,","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the hosts file:","type":"text"},{"text":" /etc/hostname","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"/etc/hosts","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reboot.","type":"text"}]}]}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify the OVA specific to the rack server is being used (which differs from the one for the primary region server), and import it. ","type":"text"},{"type":"hardBreak"},{"text":"Mac Addresses:","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Verify the OVA import process regenerates MAC addresses for any NICs if multiple subnets are used so no two rack servers have ","type":"text"},{"text":"any","type":"text","marks":[{"type":"em"}]},{"text":" MAC addresses in common.","type":"text"},{"type":"hardBreak"},{"text":"It is critical virtual environments generate new MAC addresses for the interfaces when the OVA (or equivalent) is imported. The installation stops if the installation detects another server with the same MAC address for any interface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the following script:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo /opt/reinitrack.sh -i PRIMARY·SERVER·IP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use the ","type":"text"},{"text":"list subnets","type":"text","marks":[{"type":"code"}]},{"text":" command to view the new subnet that is managed by the current rack server in the list:","type":"text"}]},{"type":"codeBlock","content":[{"text":"platform list subnets --all","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setting up the Rack Server","type":"text"}]},{"type":"paragraph","content":[{"text":"After installation on a rack server, complete its setup:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use the CLI to configure the new rack server to manage the new subnet. This is similar to the bootstrap command: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"platform add dhcp -t SUBNET -a STARTING·DYNAMIC·IP -z ENDING·DYNAMIC·IP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unless you have a non-standard DNS setup, point DNS back to the Primary server: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"platform add dns -t SUBNET·FROM·ABOVE --dns PRIMARY·SERVER·IP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Gateway for this secondary subnet is probably also provided by something else on the subnet. If so, set the Gateway for this subnet to point to that service: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"platform add gateway -t SUBNET·FROM·ABOVE --gateway GATEWAY·IP","type":"text"}]}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"9611eae1-b640-45f1-ab77-9e8a2d7c141f"},"schemaVersion":{"value":"2"},"title":"Children Display"}},"localId":"9f57f98d-35bf-4d63-a134-850c93eb5613"}}],"version":1}

Browser not supported