Table of Contents

Executive Summary

Required Time: 45 Minutes

Description: Installation of the ggRock Server Application is a process which is mostly automated for ease of installation. The process involves running scripts, executing some terminal commands, and editing some text files. Before following this guide, ensure that you have followed the "Install the Debian OS on Your Server" guide.

Access Server Console

1. Access the server console via a direct keyboard/mouse/monitor connection to the server, SSH, or via Debian Control Panel.

2. Log in with the root user, or another administrative user on the system. This is the password set in the "Set Up Users and Passwords" section of the "Install the Debian OS on Your Server" guide. Once logged in successfully, you should see "root@ggrock:~#" which is the root prompt.

NOTE:

Make sure that CAPS lock is turned off when entering your password if login fails.

ggRock Automated Install Script

3. From the root prompt, initiate installation of ggRock via the automated install script by typing the following command and pressing "Enter" on the keyboard.

wget -O - ggrock.com/install.sh | bash -

NOTE:

All whitespace characters in the above string are mandatory.

The 'O' is a capital letter 'o', not the number zero '0'.

If you are Accessing Debian Control Panel or connecting to your server via SSH, you may copy and paste the above command.

ggRock Linux Configuration Utility

4. From the "Welcome" screen of the ggRock Linux Configuration Utility, highlight the

"< Yes >" button and press the "Enter" key on your keyboard.

NOTE:

The ggRock Linux Configuration Utility may be run from the terminal at any time by executing the "ggrock-linux-configurator" command.

5. From the "Install packages" screen, highlight the "< Yes >" button and press the "Enter" key on your keyboard to permit adding the "contrib" repository for required dependent packages necessary for proper functionality of the ggRock Server Application.

6. From the "Enable repositories" screen, highlight the "< Yes >" button and press the "Enter" key on your keyboard to enable the postgresql and grafana 3rd-party repositories which are necessary for proper functionality of the ggRock Server Application.

7. From the "IP address" screen, highlight the IP address of your server that is on the same VLAN, subnet, or network segment as the Machines in your center and press the "Enter" key on your keyboard to accept the changes. This address is the one your Machines will use for network (PXE) boot functionality.

8. From the "Bridge configuration" screen, highlight the "< Yes >" button and press the "Enter" key on your keyboard to permit configuration of the network bridge which is required for Virtual Machine and Seamless Boot functionality.

9. From the "IP forwarding" screen, highlight the "< Yes >" button and press the "Enter" key on your keyboard to enable IP forwarding, which is necessary for network (PXE) boot functionality.

Automated Installation Continues

10. Observe the automated installation process of the ggRock Server Application and dependencies, which will take between 10 and 30 minutes to complete depending on server and network speed. This is a great time to grab a cup of coffee.

11. Once installation has completed successfully, you will see the following message:

ggRock has been installed.  Open it in your web browser:
http://your.server.ip.address.here/

NOTE:

The string your.server.ip.address.here is unique to your server setup and is the local address you will utilize to access the ggRock Web UI from this point forward.

12. Reboot your server by entering the "reboot" command and pressing the "Enter" key on your keyboard.

Network Configuration Modification

13. Access the server console via a direct keyboard/mouse/monitor connection to the server, SSH, or via Debian Control Panel.

14. Log in with the root user, or another administrative user on the system. This is the password set in the "Set Up Users and Passwords" section of the "Install the Debian OS on Your Server" guide. Once logged in successfully, you should see "root@ggrock:~#" which is the root prompt.Step 15. Backup network config

15. Back up the /etc/network/interfaces network configuration file by entering the following command, then pressing the "Enter" key on your keyboard:

cp /etc/network/interfaces /etc/network/interfaces.bak 

16. Open the /etc/network/interfaces network configuration file in the "nano" text editor by entering the following command, then pressing the "Enter" key on your keyboard:

nano /etc/network/interfaces

NOTE:

The initial content of the /etc/network/interfaces network configuration file is unique and will likely be different for your server setup and configuration.

17. Modify the /etc/network/interfaces network configuration file, making sure to utilize the values that are specific to your LAN configuration.

Replace the following two lines of /etc/network/interfaces

auto vmbr0
iface vmbr0 inet dhcp

With the following five lines:

auto vmbr0
iface vmbr0 inet static
address SERVERIP
netmask NETMASK
gateway GATEWAY

NOTE:

  • SERVERIP is the IP address you selected in Step 7 of this guide.

  • NETMASK is likely 255.255.255.0, though this is dependent on network configuration - please contact your network administrator if you are unsure.

  • GATEWAY is typically the IP address of your router, or the closest network hop to your server - please contact your network administrator if you are unsure.

  • The whitespace character before the address, netmask, and gateway keywords are single presses of the "Tab" key on the keyboard.

The final /etc/network/interfaces network configuration file should look similar to the following:

auto lo
iface lo inet loopback

auto vmbr0
iface vmbr0 inet static
address SERVERIP
netmask NETMASK
gateway GATEWAY
bridge_ports ens33
bridge_fd 0
bridge_stp off

iface ens33 inet manual

NOTE:

The text ens33 is unique and will likely be different for your server setup and configuration.

18. Save the /etc/network/interfaces network configuration file by pressing

"CTRL + X" on the keyboard, then typing the letter 'Y', then pressing the "Enter" key on the keyboard.

DNS Configuration Modification

19. Back up the /etc/resolv.conf DNS configuration file by entering the following command, then pressing the "Enter" key on your keyboard:

cp /etc/resolv.conf /etc/resolv.conf.bak

20. Open the /etc/resolv.conf DNS configuration file in the "nano" text editor by entering the following command, then pressing the "Enter" key on your keyboard:

nano /etc/resolv.conf

NOTE:

This file will be unique to your server setup and configuration, so your initial copy of /etc/resolv.conf will not exactly match the below screen shot.

21. Modify the /etc/resolv.conf DNS configuration file.

Replace the following line of /etc/resolv.conf

nameserver 192.168.1.1

With the following two lines:

nameserver 8.8.8.8
nameserver 8.8.4.4

22. Save the /etc/resolv.conf DNS configuration file by pressing "CTRL + X" on the keyboard, then typing the letter 'Y', then pressing the "Enter" key on the keyboard.

23. Reboot the server by typing the reboot command and pressing the "Enter" key on your keyboard.

Re-Run ggRock Linux Configurator

24. Access the server console via a direct keyboard/mouse/monitor connection to the server, SSH, or via Debian Control Panel.

25. Log in with the root user, or another administrative user on the system. This is the password set in the "Set Up Users and Passwords" section of the "Install the Debian OS on Your Server" guide. Once logged in successfully, you should see "root@ggrock:~#" which is the root prompt.

NOTE:

Make sure that CAPS lock is turned off when entering your password if login fails.

26. From the root prompt, enter the ggrock-linux-configurator command, then press the "Enter" key on your keyboard.

27. From the "Welcome" screen of the ggRock Linux Configuration Utility, highlight the "< Yes >" button and press the "Enter" key on your keyboard.

28. From the "Install packages" screen, highlight the "< Yes >" button and press the "Enter" key on your keyboard to permit adding the "contrib" repository for required dependent packages necessary for proper functionality of the ggRock Server Application.

29. From the "Enable repositories" screen, highlight the "< Yes >" button and press the "Enter" key on your keyboard to enable the postgresql and grafana 3rd-party repositories which are necessary for proper functionality of the ggRock Server Application.

30. From the "IP address" screen, highlight the IP address of your server that is on the same VLAN, subnet, or network segment as the Machines in your center and press the "Enter" key on your keyboard to accept the changes. This address is the one your Machines will use for network (PXE) boot functionality.

31. From the "Bridge configuration" screen, highlight the "< Yes >" button and press the "Enter" key on your keyboard to permit configuration of the network bridge which is required for Virtual Machine and Seamless Boot functionality.

32. From the "IP forwarding" screen, highlight the "< Yes >" button and press the "Enter" key on your keyboard to enable IP forwarding, which is necessary for network (PXE) boot functionality.

Note:

At this point, you may elect to administer your ggRock server remotely by following the optional instructions in the Access Debian Control Panel Article.

You may now proceed with the "First-Time Setup and Accessing the ggRock Server Application" guide.

Did this answer your question?