FreeSBC:Baremetal:Installation A

From TBwiki
(Difference between revisions)
Jump to: navigation, search
m (Added a warning not to reboot before the webportal is accessible)
 
(34 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:TSBC-SW:Baremetal:Installation}}
+
{{DISPLAYTITLE:SBC:Baremetal:Installation}}
  
 
== Requirements ==
 
== Requirements ==
 
Minimal server requirements:
 
Minimal server requirements:
* 64 bits server
+
* 64-bit server
* Quad core Intel CPU 2GHz
+
* Optical disk drive (or USB key)
* Optical disk drive
+
* One or more SBC (LAN/WAN) ethernet interfaces. Must be in the [[Supported_NICs|List of supported NICs]]
* 80GB hard drive
+
* 8G RAM
+
 
* One management Ethernet
 
* One management Ethernet
* Data Ethernet adapters
+
* Two ethernet interfaces, if a 1+1 configuration is required
** 5,000 sessions or less: one 1Gbps interface
+
** 10,000 sessions or less: two 1Gbps interface
+
** 60,000 sessions: two 10Gbps interfaces
+
** See list of supported Network Interface Cards (NICs) here: [[Supported_NICs|List of supported NICs]]
+
 
* Console access through serial port or keyboard/monitor ports
 
* Console access through serial port or keyboard/monitor ports
* BIOS setup for maximum performance (i.e. no dynamic CPU throttling)
+
* Must support BIOS (and not UEFI)
 +
* BIOS setup for maximum performance (no dynamic CPU throttling)
  
For better performance (see [[TSBC-SW:Baremetal:Optimizations|optimization]] section)
+
{| cellpadding="5" border="1" class="wikitable"
* NUMA tuning
+
|-
* PCIe tuning
+
! width="150" style="background: none repeat scroll 0% 0% rgb(239, 239, 239); -moz-background-inline-policy: continuous;" | Sessions
 +
! width="100" style="background: none repeat scroll 0% 0% rgb(239, 239, 239); -moz-background-inline-policy: continuous;" | CPU cores
 +
! width="100" style="background: none repeat scroll 0% 0% rgb(239, 239, 239); -moz-background-inline-policy: continuous;" | RAM
 +
! width="100" style="background: none repeat scroll 0% 0% rgb(239, 239, 239); -moz-background-inline-policy: continuous;" | Disk Space (SSD)
 +
! width="200" style="background: none repeat scroll 0% 0% rgb(239, 239, 239); -moz-background-inline-policy: continuous;" | LAN/WAN SBC Ethernet ports***
 +
|-
 +
| valign="top" |
 +
Up to 5,000
 +
| valign="top" |
 +
2
 +
| valign="top" |
 +
4 Gb
 +
| valign="top" |
 +
40 Gb
 +
| valign="top" |
 +
1 Gbps
 +
|-
 +
| valign="top" |
 +
5,000-20,000
 +
| valign="top" |
 +
4
 +
| valign="top" |
 +
8 Gb
 +
| valign="top" |
 +
60 Gb
 +
| valign="top" |
 +
4 X 1 Gbps or
 +
1 X 10 Gbps
 +
|-
 +
| valign="top" |
 +
20,000-50,000
 +
| valign="top" |
 +
4**
 +
| valign="top" |
 +
16 Gb
 +
| valign="top" |
 +
80 Gb
 +
| valign="top" |
 +
1 X 10 Gbps
 +
|-
 +
| valign="top" |
 +
Above 50,000
 +
| valign="top" |
 +
6**
 +
| valign="top" |
 +
24+ Gb
 +
| valign="top" |
 +
100 Gb
 +
| valign="top" |
 +
Multiple 10 Gbps
 +
|}
 +
<nowiki>**</nowiki> The CPU number is based on Dell R630 with Intel Xeon E5-2643. Double the CPUs number if your server is from an earlier generation.
 +
 
 +
<nowiki>***</nowiki> See list of supported Network Interface Cards (NICs) here: [[Supported_NICs|List of supported NICs]]
 +
 
 +
 
 +
More details on HW/CPU/NIC requirements can be found here: [[FreeSBC:RequirementsMatrix|Requirements Matrix]] <br>
 +
Check here for a list of certified hardware platforms: [[SBC:CertifiedHardware|SBC Certified Hardware]]
 +
 
 +
 
 +
In most cases, a standard configuration will provide sufficient performance. To get maximum performance from a system, please contact [mailto:support@telcobridges.com support@telcobridges.com] .
  
 
== Getting the ISO ==
 
== Getting the ISO ==
Please contact our [mailto:sales@telcobridges.com sales team] to get a copy of the latest TBSC-SW ISO.
+
Please go to our [http://www2.telcobridges.com/ProSBCDownload ProSBC Download site] to get a copy of the latest SBC ISO.
  
 
== Installing the ISO ==
 
== Installing the ISO ==
Line 28: Line 83:
  
 
=== Installing using the ISO burned onto a bootable USB flash drive ===
 
=== Installing using the ISO burned onto a bootable USB flash drive ===
Use a software application to burn the ISO onto a USB flash drive. On Windows, [[https://rufus.akeo.ie/ |Rufus ]] is known to work with the TSBC-SW ISO.
+
Use a software application to burn the ISO onto a USB flash drive. On Windows, [https://rufus.akeo.ie/ Rufus] is known to work with the SBC ISO.
But generally any similar application should work. Make sure to set the volume label to "CENTOS 7 X8" and to format the drive in the FAT32 file system format.  
+
But generally any similar application should work. Make sure to set the volume label to "'''CENTOS 7 X8'''" and to format the drive in the FAT32 file system format.
  
 
=== Physical installation steps ===
 
=== Physical installation steps ===
# Identify which Ethernet networks you need and connect them to your server.  Refer to [[TSBC-SW:Networking]] for more information
+
# Identify which Ethernet networks you need and connect them to your server.  Refer to [[TSBC-SW:Networking|Networking]] for more information. For ProSBC Transcoding and associated network setup, please also refer to [[FreeSBC:Transcoding and Network Setup|ProSBC:Transcoding and Network Setup]].
 
# Burn the ISO onto a DVD or a USB flash drive
 
# Burn the ISO onto a DVD or a USB flash drive
# Get an access to the console of the server.  Usually, this is achieved by connecting a keyboard and screen to the server.
+
# Get access to the console of the server.  Usually, this is achieved by connecting a keyboard and screen to the server.
 
# Insert the DVD in the optical drive of your server and boot from the DVD drive.
 
# Insert the DVD in the optical drive of your server and boot from the DVD drive.
 
#* Alternatively, plug in your USB flash drive and boot from that drive.
 
#* Alternatively, plug in your USB flash drive and boot from that drive.
# You should get the to the "Virtual Appliance Installer" menu on your display: <br /> [[File:ISO_install_prompt.jpg|350px]]
+
# The "Virtual Appliance Installer" menu should be displayed: <br /> [[File:ISO_install_prompt.jpg|600px]]
# Hit 'R' key, then 'ENTER' key to start the installation<br /> [[File:ISO_installing.jpg|350px]]
+
# Press the 'R' key followed by the 'ENTER' key to start the installation<br /> [[File:ISO_installing.jpg|600px]]
# Wait for the installation process to complete.  When installation is complete, the server will reboot itself.
+
# Wait for the installation process to complete.  When the installation is complete, the server will automatically reboot.
 
#*  Important: Make sure to remove the DVD from the drive while the server is rebooting.  If you get back to "Virtual Appliance Installer", just eject the CD or remove the USB flash drive and reboot again.
 
#*  Important: Make sure to remove the DVD from the drive while the server is rebooting.  If you get back to "Virtual Appliance Installer", just eject the CD or remove the USB flash drive and reboot again.
#  It may take a couple of minutes for the system to be brought up after the first reboot.  Until the WebPortal is accessible, you must '''not''' reboot the newly created machine to allow the installation to complete properly.
+
#  It may take a couple of minutes for the system to be brought up after the first reboot.  Until the Web Portal is accessible, you must '''not''' reboot the newly created machine to allow the installation to complete properly.
 
+
=== Changing the root password  ===
+
# Use the console to login into the server
+
## user: root
+
## password: root
+
# Change the password to something stronger than root:
+
# passwd
+
New password: ........
+
Retype new password: ........
+
passwd: all authentication tokens updated successfully.
+
  
 
=== Assigning IP address ===
 
=== Assigning IP address ===
By default, all detect network interfaces will have DHCP enabled.  Thus, the server might already have an IP address assigned if the network has a DHCP server running.  In such case, you can display and use it to access the web portal configuration panel.
+
By default, all detected network interfaces will have DHCP enabled.  This means, the server might already have an IP address assigned, if the network has a DHCP server running.  In this case, you can display and use it to access the web portal configuration panel.
  
 
# Retrieve an IP address assigned by DHCP
 
# Retrieve an IP address assigned by DHCP
 
   # ifconfig
 
   # ifconfig
  
If there is no IP assigned, you will need to configure one manually.
+
If you want to assign a static IP address, or there is no DHCP on your network, you will need to configure it manually.
  
# Assign a IP address to the Ethernet interface having network connectivity.  Example if the NIC's name would be eth0:
+
# Use the '''tbchangeip''' shell command and answer the questions to change your Ethernet interface address:
   # ip link set eth0 up
+
   # tbchangeip
  # ip addresss add 192.168.178.30/24 dev eth0
+
  
=== Accessing the TSBC-SW web portal ===
+
=== Accessing the SBC web portal ===
 
# Open a web browser to the IP of your server, on port 12358.  Example if your server address is 192.168.178.30, the URL would be: <br/> http://192.168.178.30:12358
 
# Open a web browser to the IP of your server, on port 12358.  Example if your server address is 192.168.178.30, the URL would be: <br/> http://192.168.178.30:12358
# You should get to the TSBC Configuration Wizard <br/> [[File:TSBC_WebPortal_Configuration_wizard.jpg|350px]]
+
# The SBC Configuration Wizard is displayed<br/> [[File:TSBC_WebPortal_Configuration_wizard.jpg|350px]]
  
 
From here, you can go to [[TSBC-SW:WebPortal:Initial Configuration|Web Portal Initial Configuration Guide]] to continue the installation, and/or [[TSBC-SW:Baremetal:Optimizations|optimize ]] your server to get the maximum out of your server.
 
From here, you can go to [[TSBC-SW:WebPortal:Initial Configuration|Web Portal Initial Configuration Guide]] to continue the installation, and/or [[TSBC-SW:Baremetal:Optimizations|optimize ]] your server to get the maximum out of your server.
Line 73: Line 117:
 
== Web Portal Initial Configuration ==
 
== Web Portal Initial Configuration ==
 
Click on the following link to pursue installation from the web portal:
 
Click on the following link to pursue installation from the web portal:
[[TSBC-SW:WebPortal:Initial Configuration]]
+
[[TSBC-SW:WebPortal:Initial Configuration|Web Portal Initial Configuration]]
 
+
== Optimizations ==
+
Click on the following link for baremetal server optimizations:
+
[[TSBC-SW:Baremetal:Optimizations]]
+

Latest revision as of 12:53, 26 April 2021


Contents

Requirements

Minimal server requirements:

  • 64-bit server
  • Optical disk drive (or USB key)
  • One or more SBC (LAN/WAN) ethernet interfaces. Must be in the List of supported NICs
  • One management Ethernet
  • Two ethernet interfaces, if a 1+1 configuration is required
  • Console access through serial port or keyboard/monitor ports
  • Must support BIOS (and not UEFI)
  • BIOS setup for maximum performance (no dynamic CPU throttling)
Sessions CPU cores RAM Disk Space (SSD) LAN/WAN SBC Ethernet ports***

Up to 5,000

2

4 Gb

40 Gb

1 Gbps

5,000-20,000

4

8 Gb

60 Gb

4 X 1 Gbps or 1 X 10 Gbps

20,000-50,000

4**

16 Gb

80 Gb

1 X 10 Gbps

Above 50,000

6**

24+ Gb

100 Gb

Multiple 10 Gbps

** The CPU number is based on Dell R630 with Intel Xeon E5-2643. Double the CPUs number if your server is from an earlier generation.

*** See list of supported Network Interface Cards (NICs) here: List of supported NICs


More details on HW/CPU/NIC requirements can be found here: Requirements Matrix
Check here for a list of certified hardware platforms: SBC Certified Hardware


In most cases, a standard configuration will provide sufficient performance. To get maximum performance from a system, please contact support@telcobridges.com .

Getting the ISO

Please go to our ProSBC Download site to get a copy of the latest SBC ISO.

Installing the ISO

The installation process will reformat the server's disks and install all the necessary software.

Installing using the ISO burned onto a bootable USB flash drive

Use a software application to burn the ISO onto a USB flash drive. On Windows, Rufus is known to work with the SBC ISO. But generally any similar application should work. Make sure to set the volume label to "CENTOS 7 X8" and to format the drive in the FAT32 file system format.

Physical installation steps

  1. Identify which Ethernet networks you need and connect them to your server. Refer to Networking for more information. For ProSBC Transcoding and associated network setup, please also refer to ProSBC:Transcoding and Network Setup.
  2. Burn the ISO onto a DVD or a USB flash drive
  3. Get access to the console of the server. Usually, this is achieved by connecting a keyboard and screen to the server.
  4. Insert the DVD in the optical drive of your server and boot from the DVD drive.
    • Alternatively, plug in your USB flash drive and boot from that drive.
  5. The "Virtual Appliance Installer" menu should be displayed:
    ISO install prompt.jpg
  6. Press the 'R' key followed by the 'ENTER' key to start the installation
    ISO installing.jpg
  7. Wait for the installation process to complete. When the installation is complete, the server will automatically reboot.
    • Important: Make sure to remove the DVD from the drive while the server is rebooting. If you get back to "Virtual Appliance Installer", just eject the CD or remove the USB flash drive and reboot again.
  8. It may take a couple of minutes for the system to be brought up after the first reboot. Until the Web Portal is accessible, you must not reboot the newly created machine to allow the installation to complete properly.

Assigning IP address

By default, all detected network interfaces will have DHCP enabled. This means, the server might already have an IP address assigned, if the network has a DHCP server running. In this case, you can display and use it to access the web portal configuration panel.

  1. Retrieve an IP address assigned by DHCP
 # ifconfig

If you want to assign a static IP address, or there is no DHCP on your network, you will need to configure it manually.

  1. Use the tbchangeip shell command and answer the questions to change your Ethernet interface address:
 # tbchangeip

Accessing the SBC web portal

  1. Open a web browser to the IP of your server, on port 12358. Example if your server address is 192.168.178.30, the URL would be:
    http://192.168.178.30:12358
  2. The SBC Configuration Wizard is displayed
    TSBC WebPortal Configuration wizard.jpg

From here, you can go to Web Portal Initial Configuration Guide to continue the installation, and/or optimize your server to get the maximum out of your server.

Web Portal Initial Configuration

Click on the following link to pursue installation from the web portal: Web Portal Initial Configuration

Personal tools