If you own a large farm with hundreds or thousands of GPU rigs and you are planning to migrate to Hive OS, Hive OS Deploy PXE can significantly reduce migration time and gain complete control over the deployment process. Hive OS Deploy uses PXE Network Boot technology to deploy Hive OS to your rigs.
System and hardware requirements:
You must set up a DHCP server by adding
next-server option to CLONEDEPLOYSERVERIP (static IP address of host where you install Hive OS Deploy PXE). Read more in “Network infrastructure configuration” section.
Depending on the configuration of your local network, the clients in your network receive IP addresses and other necessary information either dynamically using DHCP or configured statically on each client.
This is the default case or when you plan to setup a DHCP server anywhere in your network. Please note you should provide a set of dhcp-options:
NOTE: you must specify
next-server with your CloneDeployServer IP address. It’s the only option that you must define if you have a DHCP-server already running.
By default, most routers have predefined dhcp options and the ability to change them, so you must specify next-server option only.
In case of STATIC network: you must configure dhcp-server and tftp-server anywhere in your network to use PXE technology. For example, you could use dnsmasq - lightweight DNS, DHCP and TFTP server.
See examples of configuration files in the examples/ folder
All installation commands and scripts in shell must be executed with root credentials by using
apt update && apt install wget zip unzip -y cd /opt && wget https://download.hiveos.farm/hivedeploy.zip && unzip hivedeploy.zip && cd cd_package
It will start the installation procedure by downloading and installing the necessary packages. During the installation, you should answer some questions. Follow these steps:
3.1. Enter the Deploy server’s IP address in prompt window
Let’s assume that our host has IP address 192.168.1.2 then you will see:
3.2. Prompt default DB connection string with pressing “Enter”
Default settings will be used if no custom DB is given.
3.3. Wait until mysql-server sets up, then prompt default root password by empty string (Press Enter). This screen can appear several times during this step.
3.4. Enter SMB passwords for read-only and read-write roles: password
3.5. Download and update Hive OS image The latest stable Hive OS image will be downloaded and extracted by default.
3.6. Wait until the installation finishes the setup and then confirm reboot in the prompt window by entering “y”.
Browse to http://<server_ip>/clonedeploy for example if your server has ip address 192.168.1.2 then type in browser with http://192.168.1.2/clonedeploy and you will see the login screen:
Login with default credentials:
Change the following fields:
Note: Make sure the checkboxes near these fields are enabled.
and click on the “Update Properties” button
Now the server part installation is over.
Deploy server contains several packages including dhcp proxy, apache2, mysql and tftpd-hpa. Apache2 and MySQL - used for the web interface and tftpd-hpa used for TFTP server. So if you want to check the installation and make sure these services are running properly, use the following commands:
for DHCP Proxy:
service cd_proxy status
service apache2 status
for MySQL server:
service mysql status
for TFTP server:
service tftpd-hpa status
You can organize your network according to certain rules.
You can import a prepared rigs list. Go to “Computers”
and then click the “Upload” button
File format is: rig-001 08:00:27:4A:29:BB 192.168.1.19
Check imported rigs
Then “Click Computer Task” -> Start Computer Task -> select workers for Deploy
and press “Deploy Selected”.
Deploy process rig side
Progress can be followed through the browser
After downloading the necessary files, Hive OS Deploy will flash the Hive image to the storage device
After the flashing process, the rig will reboot automatically followed by a boot menu with default target “Boot To Local Machine” which will boot your rig after a 5 second delay
When the boot process is done, we’ll be able to see our rig on the Hive Dashboard
install-ubuntu.sh- script for install Hive OS Deploy PXE script options
download.sh- script for upload new images to Hive OS Deploy PXE