--- title: "Installing Nodegrid with iPXE on VirtualBox" slug: "installing-nodegrid-with-ipxe-on-virtualbox" tags: ["Nodegrid 6.0"] updated: 2024-08-13T10:53:50Z published: 2024-08-13T10:53:50Z canonical: "docs.zpesystems.com/installing-nodegrid-with-ipxe-on-virtualbox" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.zpesystems.com/llms.txt > Use this file to discover all available pages before exploring further. # Installing Nodegrid with iPXE on XSR This article provides guidelines for installing Nodegrid on Equinix. ## **Pre-requisites** Ensure that the following prerequisites are met before you start installing Nodegrid with iPXE on XSR: - - A public **HTTP Server** is available - You have the following Files provided by the HTTP Server: - Extracted Nodegrid Netboot Image. To get the Nodegrid Netboot image, contact the ZPE Support team. - IPXE script: This is the iPXE script template file. You must only change lines 4,5, and 6: ```actionscript 1 #!ipxe 2 3 #### Edit the values below #### 4 set PROTOCOL https 5 set HTTP_SERVER 6 set NETBOOT_PATH 7 #### Do not change the lines below #### 8 dhcp 9 set BASE_URL ${PROTOCOL}://${HTTP_SERVER}/${NETBOOT_PATH} 10 kernel ${BASE_URL}/vmlinuz LABEL=pxeboot NET_PROTO=${PROTOCOL} IPV4_ADDR=${netX/ip} GW=${netX/gateway} NET_MASK=${netX/netmask} MAC_ADDR=${netX/mac} TFTP_SERVER=${HTTP_SERVER} TFTP_DIR=${NETBOOT_PATH} console=ttyS1,115200n8 11 initrd ${BASE_URL}/initrd 12 boot ``` 1. Create a file called ***ng.ipxe*** with the content above. 2. Edit this file by replacing **** with the HTTP server IP address. 3. Edit this file by replacing **** with the path to the Nodegrid Netboot uncompressed files into the HTTP server. The files inside this path are: **vmlinuz**, **initrd**, **rootfs_main.img.gz** **Example** for the URL =**https://203.0.113.0/datastore/nodegrid-5.8.9** ```actionscript set PROTOCOL https set HTTP_SERVER 203.0.113.0 set NETBOOT_PATH datastore/nodegrid-5.8.9 ``` **Note: If the HTTP server supports Basic authentication, the credentials can be set by adding user/pass at the beginning of the address using the separators ':' and “@“. Example: set HTTP_SERVER :@** ## **Installing Nodegrid on Equinix** Perform the following actions to install the Nodegrid on Equinx server: 1. ### **Create a New Server on Equinix** 1. On the Equinix console, go to the **Manage Servers** page under the **Bare Metal Servers** category and click the **New Server** button. Note: Creating a new server and converting it to a reserved server is recommended. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701168269034.png) On the **On Demand Servers** page, the server will be configured. 2. In the **Choose a Metro** section, use the default option. 3. In the **Choose You Server** section, select **c3.medium.x86**. (it should work with any other server type). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701168391492.png) 4. In the **Choose Your Operating System** section, select **custom_ipxe** and add the URL of the iPXE script on the text field. Do **NOT**enable **Always PXE**. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701168408642.png) 5. You can create up to 5 servers with this configuration and choose the hostname of each one of them. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701168438149.png) 6. In the **Optional Settings** section, configure the active IP of the server. Note that Public IPV4 is required for remote access to the device, so it needs to be enabled. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701168598312.png) 7. Click on the **Deploy Now** button and wait for the server to be created. 2. ### **Configure SSH key on Equinix** 1. To access the console of the servers created on Equinix, it is necessary to register your public SSH key within Equinix. 2. Get your public SSH key. 3. On Windows OS, type in the following commands on Command Prompt (CMD). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701169203352.png) ript 4. On a Unix-like OS, type the following commands in the Terminal. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701169280256.png) 5. Go to **Project Settings** and click **SSH Keys**. In **Project SSH Keys**, click the **Add New Key** button. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701095799593.png) 6. Add a name for the key, enter your public key, and select all servers you want to access. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701169344039.png) 7. Click the **Add SSH Key** button. 3. ### Access the console 1. On **Manage Servers**, click on the icon for *Out-of-Band*. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701169461857.png) 2. Copy the SSH command shown. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701169499194.png) Newer versions of some operating systems will return an error: *no matching host key type found. Their offer: ssh-rsa*when trying to SSH into the serial console, even if you have valid SSH keys. To fix this, you will need to allow ssh-rsa by adding *-o PubkeyAcceptedAlgorithms=+ssh-rsa -o HostKeyAlgorithms=+ssh-rsa* to the SSH command. For Example *ssh -o PubkeyAcceptedAlgorithms=+ssh-rsa -o HostKeyAlgorithms=+ssh-rsa c0288469-1be7-4134-9cfd-8084ad5a9b8b@sos.dc13.platformequinix.com* 3. Connect using a terminal. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1701234842771.png)