KILOVIEW Server Intercom Server Pro Instructions
- September 13, 2024
- KILOVIEW
Table of Contents
KILOVIEW Server Intercom Server Pro
KiloLink Server Pro
Seamless Management, Unlimited Streaming
Install deployment documentation v1.0
Rapid Deployment KiloLink Server Pro
If you have purchased and configured a cloud server with 4 cores, 8GB RAM, and 64GB storage space, running a 64-bit Linux operating system (such as Ubuntu 18.04+ or Debian 9+), and Docker is installed and running correctly, along with the curl tool installed in the system, you can connect to the server with sudo privileges and execute the following command to deploy KiloLink Server Pro:
- /bin/bash <( curl -fsSL https://github.com/kiloview/klnk-server/raw/main/install.sh )
The command will download and execute the installation script stored in the
cloud. Follow the prompts to complete the deployment process. Once done,
KiloLink Server Pro will run successfully on your cloud server.
If you encounter any issues, please refer to this document or send an email to
Kiloview technical support at
support@kiloview.com. Our engineers will assist
you in resolving any problems you may have.
Server Environment Preparation
The server you are using needs to have internet access. We recommend using a
cloud server purchased from cloud service providers such as Amazon Web
Services, Microsoft Azure, Google Cloud Platform, Alibaba Cloud, IBM Cloud,
Oracle Cloud, Tencent Cloud, Huawei Cloud, Salesforce, or DigitalOcean.
The recommended cloud server configuration is as follows:
Configuration Item | Description |
---|---|
Processor | 4-core CPU or higher |
Memory | 8GB RAM or higher |
Storage Capacity | 64GB HDD or higher |
Operating System
| Choose your desired cloud server operating system, recommended Linux 64-bit (Ubuntu 18.04+ / Debian 9+)
Public IP
| The cloud service provider will assign a public IP address; you can adjust public bandwidth as needed;
Public Bandwidth Calculation
| Planned based on network conditions. For example, if your aggregate device has a working bandwidth of 6Mbps/unit, and centralized management platform consumes 125kbps/line, if you purchase one aggregate device and four devices requiring centralized management, bandwidth calculation formula would be 16+0.1254=7Mbps, minimum recommended configuration 8Mbps.
Accessing Linux servers
To remotely connect to a Linux server, there are several common methods:
-
Using SSH
Connect to the remote server by running SSH commands。 -
Using the Cloud Service Provider’s Management Console
Most cloud service providers (such as AWS, Azure, Google Cloud, Alibaba Cloud, etc.) offer web-based management consoles. You can access and manage servers directly through a web browser.
Using Third-Party Tools
You can also utilize third-party tools to manage cloud servers, such as:
- PuTTY(Windows):Used for SSH connections.
- MobaXterm(Windows):A versatile terminal that supports SSH, SFTP, and other connections.
Docker Environment
- To update the package manager’s index, fetching the latest package information from the configured software source lists. Enter the command: sudo apt update
- To install the Docker, enter the command: sudo apt install docker.io -y
- After installation, start the Docker service and enable auto-start on boot:
- Enter the command to start: sudo systemctl start docker
- Enter the command to enable: sudo systemctl enable docker
Deployment Process
The one-click deployment command for the KiloLink Server Pro server retrieves and runs an installation script from the cloud to deploy the KiloLink Server Pro platform on your server. You can execute the following command to deploy the KiloLink Server Pro platform:
(Note: A stable internet connection is required to ensure smooth deployment.)
/bin/bash <( curl -fsSL https://github.com/kiloview/klnk- server/raw/main/install.sh )
Please note the following:
-
The installation process requires sudo permission, so you need to check if the current user has Docker execution permission:
-
Enter the command: docker ps
-
Check the result:
If the command successfully executes and displays a list of running Docker containers, it means the current user already has Docker execution permission and can proceed to the next step.
If you encounter a permission error, you need to enter the following commands: -
sudo usermod -aG sudo $USER
-
newgrp sudo
-
sudo gpasswd -a $USER docker
-
newgrp docker
By following these steps, you should be able to grant Docker execution permission to the current user. After completing these operations, run docker ps again to confirm that the permissions have been correctly set.
-
-
If your system does not have the curl tool installed, you need to enter the command:
- Ubuntu/Debian: sudo apt-get install curl
- CentOS/Fedora: sudo snap install curl
- After installing the curl tool, execute the KiloLink Server Pro deployment command again.
- After entering the deployment command, we officially begin the deployment process of the KiloLink Server Pro platform.
Firstly, you need to read and understand the license agreement for Kiloview®
KiloLink Server (KLS). Compliance with the software license agreement is not
only a legal requirement but also a respect for the developers’ efforts. If
you have any questions about the terms of the license agreement, we recommend
contacting us for consultation.
You can enter [y/Y] to indicate agreement and proceed with the installation,
or enter [n/N] to indicate disagreement and terminate the deployment.
Step 1: Image Download
After you have read and agreed to the license agreement for Kiloview® KiloLink
Server (KLS), the KiloLink Server Pro image will automatically be loaded from
the Docker image repository, as shown below:
Step 2: Installation Path Selection
If you are a new user of KiloLink Server Pro, enter the installation path you
prefer. If you do not specify an installation path, KiloLink Server Pro will
be installed in the subdirectory ‘kilolink-server’ under the default user
directory.
If you have previously used an older version of the KiloLink Server container, you need to first check the storage path of the data from the old version.
Enter the command: docker inspect “container_name”
This command will allow you to view the historical storage directory. If you are unsure about the name of the old version KiloLink Server container, you can check it using docker ps.
Example:
Enter the command: docker inspect kilolinkserver to view the storage directory of the old version KiloLink Server container, which is /data. This corresponds to the mounted directory on the server as /home/ubuntu/update_test
You can specify the mounted directory /home/ubuntu/update_test as the installation path. We will endeavor to preserve your historical device information, user information, etc. Additionally, we recommend that you back up historical platform data before installing by following these steps.
Example:
To back up historical data under the mounted directory
/home/ubuntu/update_test use the command:
cp /home/ubuntu/update_test /home/ubuntu/update_test_back -rf
Step 3: Removing the Old KiloLink Server Container
If an old version of KiloLink Server is detected, it will be indicated in
parentheses as shown below. According to the prompts, proceed to delete the
previously installed old version of KiloLink Server container. Considering
that a server supports only one instance of KiloLink Server container, we
recommend removing the old version of the KiloLink Server container.
Step 4: Port Configuration
- Configure Web Port: The Web port is used to access the management console via HTTP, with the default port being 80. Due to varying national regulations regarding network ports, you may need to manually change the Web port.
- Configure Connection Port: The connection port is used for device management and aggregation services. The connection port must be an even number, and the system will occupy both [link_port] and [link_port+1] ports simultaneously. For example, if the connection port is set to 50000, the system will use ports 50000 and 50001.
- Public IP: Since the platform cannot directly obtain your external public IP address for access, you need to manually specify the public IP address. You can obtain the assigned public IP address from your cloud service provider’s management panel.
Step 5: NDI Discovery Service Usage Notice
The system automatically checks if the Linux system service named “avahi- daemon” is installed on the server. This service is used for NDI’s automatic discovery service. If you require NDI|HX output functionality while using KiloLink Server Pro, you will need to manually install the “avahi-daemon” system service by using the following commands, accordingly to your Linux distribution:
- Ubuntu/Debian: sudo apt install avahi-deamon
- CentOS/Fedora: sudo yum avahi-deamon
Step 6: Confirmation of Information
At this point, you have successfully installed the KiloLink Server Pro.
Below are some important access details and configuration recommendations
provided for you:
- Access Points Includes:
- Web management interface for managing and configuring the KiloLink Server Pro
- Connection port for binding and managing devices
- Docker container name
- Notes and Firewall Configuration
- Please note that not installing the Avahi Daemon service will disable NDI discovery functionality. If NDI discovery functionality is required, you may need to install and configure the Avahi Daemon service.
- Firewall Configuration: Ensure the following ports are configured in your firewall to allow external access:
- UDP ports: 50000, 50001, 5353 (if NDI|HX functionality is enabled)
- TCP ports: 83, 5961-5962 (maintain at least 4*N ports open if NDI|HX functionality is enabled) srt, rtsp, webrtc port range: [30000, 30300]
Login Verification
- Open your browser: It is recommended to use Google Chrome browser, compatible with other browsers such as Firefox, Edge, etc.
- Enter the address: In the browser’s address bar, enter http://IPaddress:Port. Replace “IPaddress” with the public IP address of your KiloLink Server Pro and replace “Port” with the server’s port number. For example, if the server IP is 192.168.1.100 and the port is 83, enter http://192.168.1.100:83
- Press Enter: Press the Enter key, and the browser will attempt to connect to the specified server and port.
- Display the login interface: Upon successful connection, you should see the login interface of KiloLink Server Pro.
- Enter login information: If you are a new user of KiloLink Server Pro, the default login credentials are: Username: admin Password: Kiloview001. After logging in, the platform will prompt you to change the password. If you have used the old version of KiloLink Server before, you can continue using the same login credentials.
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>