Skip to content

πŸͺ– Add CDN & DNS Server

πŸ“ Overview

Upon Fresh installation of Load Proxy instance, you need to manually add the Load Proxy Node to the EdgeHit Controller Dashboard. You can add Load Proxy Either as CDN Server or DNS Server to EdgeHit Controller.

The installation process and Syncing Authentication Credential are done Automatically by installasion bash script. But the process of adding Load Proxy to EdgeHit Controller Web Dashboard need to be done manually.


Below are several important file to take note for each component

EdgeHit Controller

  • /usr/local/edgehit/EdgeHit-Controller/ directory stores the file below

    • install-info.txt to find Dashboard URL and Default Admin Credential

Load Proxy

  • /usr/local/edgehit/loadproxy/ directory stores the file below

    • .server to find Server UUID and Server Role
    • .env to find Secret Values

  • /etc/anycast-checker/ directory stores monitoring script used by healthcheck service

    • /etc/bird/ directory stores BIRD config generated by installation script

Reminder

  • Make sure that you had changed [ $status -eq 999 ] in http-healthcheck.sh is changed into [ $status -eq 400 ]

  • If your setup does not need BGP password, remove the coresponding line in bird.conf


πŸ› οΈ Add EdgeHit as CDN Server

  1. Login As Admin into the EdgeHit Controller Dashboard

  2. Go to the CDN > Data Center section

  3. Define A new =Data Center== wil proper description
    Pic

  4. Repeat the same process over CDN > Server Cluster and CDN > Server Group for Server Cluster and Server Group settings

    Pic

    Pic

    Note

    Only Server Group is Applied to A User Plan and effects other configuration. Data Center and Server Cluster only apply as a tag for resource organization


  5. Go to IP Adress > IP Adress Group section, and add a proper IP Address Group with type Static or Anycast depending the setting on the coresponding load proxy node.

    Abstract

    Although the setting up of Load Proxy as CDN Edge Node uses manual defined IP instead of selecting from predefined list of IP , It is recommended that the IP address of Load Proxy is added to IP list as certain config that expect value from IP list instead of manual input will be using that IP Address.

    Pic

  6. Go to the IP Adress > IP Adress Block section. Map IP Address Block to the desired IP Address Group , then define the CIDR IP address block

    Pic

  7. After Defining IP adress block, on the same page, click on More Options > Add IP Address and select the number of IP address to be added under the CIDR block.

    Pic

    Note

    Only the IP Group setting is a tag that can be assigned to resources. IP block is just to make the IP Address available under IP list to be assigned configured as IP for certain resource.

    • The numbering selects a range of IP in acending order.

      • For example, if i want to add 192.168.0.255 i would need to add 256 ip under the CIDR block 192.168.0.0 as i need ip from 0-255 which count as 256 IP

      Tip

      if you do not want to add so many IP , you can define a /32 CIDR block and add 1 IP under it which coresponds to your Load Proxy IP.


  8. Go to CDN > Server section

    Pic

  9. Fill in the Value that coresponds to the Load Proxy node such as Hostname, IP Address. Select relavance tag for the 4 group settings. Server UUID can be found in the .server file. Once done. Click on save changes
    Pic

  10. You can also add in extra configuration such as Asset Tag, Server Location,etc. Below Shows the available config.

    clearification

    The Country Label in CDN Server Defination is NOT for GeoIP Based Traffic control. Instead, it only act as a reosource tag for logging and management purpose.

    Note

    When debug mode enabled, information level logs are written to the service logs.

    Pic

    Field Label Description
    Select Asset Tags Select from dropdown list to assign predefined Tag Value
    Enabled Toggle switch to enable or disable the Server.
    Debug Mode Toggle switch to activate debug mode.
    Country Dropdown to select the country
    State Input field to enter the state or province.
    City Input field to specify the city.
    Longitude Input field for the geographic longitude
    Latitude Input field for the geographic latitude
    Description Text field to provide additional details


  11. After Submitting the Settings, wait around 1 minutes and view details of the created CDN Server. click on Edge Server Status and you should able to see version detail of EdgeHit Server without any error prompted. Pic

    Warning

    If the Edge Version is not shown in the Edge Server Status and an Error Message is prompted. This means EdgeHit Controller is unable to connect to EdgeHit Server stated in the Settings.

    • Ensure that EdgeHit Controller can reach the EdgeHit Server without any Firewall rule blocking and proper redis MTLS setting is present on both side


βš’οΈ Add EdgeHit DNS as DNS Server

  1. Login As Admin into the EdgeHit Controller Dashboard

  2. Go to DNS > Server Group section , select .Add button to define a new group Pic

  3. Define A DNS Group with appropriate Name and Description. Then Click on Add Record Pic

  4. Define the Iniatial Zone Record for the DNS Server Such As NS Record and SOA Record. Each DNS Group Must have one SOA record and AT LEAST one NS record

    Note

    The Initial Record of A DNS Group Applies to all Domain That is registered under the DNS Group. These record are usually NS record(s) that point to IP Address of one or more Load Proxy Node.

    Tip

    • if you plan to add multiple DNS Server into the same DNS GROUP, ensure that NS record that map to IP Address of each individual DNS Servers are present in the DNS Record Initialization of the server group
    • ensure that initial NS record is also present on Upstream DNS Authoritative Server by adding the record in DNS Provider such as Dynadot, GoDaddy, etc.

    Pic

  5. Continue to add in the Initial DNS Record. Once Done, Click on Save Changes . An example configuration will be similiar as below:

    Important Note

    If you plan to put Mutliple Load 53 instance under the same DNS Group, Make sure that NS records pointing to all instance are present under the DNS Group

    Pic

    Note

    If your Load Proxy node is already defined as a CDN Server, you can skip step 6-8 as ip address list is alraedy defined for the Server's IP


  6. Go to IP Adress > IP Adress Group section, and add a proper IP Address Group with type Static or Anycast depending the setting on the coresponding load proxy node.

    Abstract

    Although the setting up of Load Proxy as CDN Edge Node uses manual defined IP instead of selecting from predefined list of IP , It is recommended that the IP address of Load Proxy is added to IP list as certain config that expect value from IP list instead of manual input will be using that IP Address.

    Pic

  7. Go to the IP Adress > IP Adress Block section. Map the IP Address Block to the desired IP Address Group , then define the CIDR IP address block

    Pic


  8. After Defining IP adress block, on the same page, click on More Options> Add IP Address and select the number of IP address to be added under the CIDR block.

    Pic

    Note

    Only the IP Group setting is a tag that can be assigned to resources. IP block is just to make the IP Address available under IP list to be assigned configured as IP for certain resource.

    • The numbering selects a range of IP in acending order.

      • For example, if i want to add 192.168.0.255 i would need to add 256 ip under the CIDR block 192.168.0.0 as i need ip from 0-255 which count as 256 IP

      Tip

      if you do not want to add so many IP , you can define a /32 CIDR block and add 1 IP under it which coresponds to your Load Proxy IP.


  9. Nativate to DNS > Server section on the side bar. , select Add button to define a new group
    Pic

  10. Key in the proper Hostname and IP Address pointing to the target load proxy instance. Select the Proper IP Address Group and Server Group.

    Note

    In certain setup, the hostname of Load 53 nodes are resolved by itself and will not work before setting up Domain Zone. It is fine to place the hostname in the server setting first as the actual delivery of setting from CP to load 53 uses IP address.

    Pic


  11. You can also add in extra configuration such as Asset Tag, Server Location,etc. Below Shows the available config.

    clearification

    The Country Label in DNS Server Defination is NOT for GeoIP Based Traffic control. Instead, it only act as a reosource tag for logging and management purpose.

    Note

    When debug mode enabled, information level logs are written to the docker logs.

    Pic

    Field Label Description
    Select Asset Tags Select from dropdown list to assign predefined Tag Value
    Enabled Toggle switch to enable or disable the Server.
    Debug Mode Toggle switch to activate debug mode.
    Country Dropdown to select the country
    State Input field to enter the state or province.
    City Input field to specify the city.
    Longitude Input field for the geographic longitude
    Latitude Input field for the geographic latitude
    Description Text field to provide additional details