Workstation setup

Working with ISPsystem software products requires a PC or a mobile device with connectivity to:

• the product's web interface;
• the server with the product via SSH.

Connecting to the web interface

Stable operation of the web interface is supported in the latest versions of browsers:

• Google Chrome;
• Mozilla Firefox;
• Safari.

Operation of the web-interface in other browsers with Chromium engine (Opera, Microsoft Edge, etc.) is supported but not guaranteed.

For details on supported versions, see the documentation of the frameworks used:

• Angular;
• Stencil.

For correct operation of the web interface, enable JavaScript support in your browser settings and allow the use of cookies.

Connecting via SSH

SSH is a network protocol for remote connection to a server. SSH uses traffic encryption algorithms, so the SSH connection is secure.

Connection is made under a superuser account on the remote server. Usually, this is the root account. 

Password or SSH keys are used for authentication.

The software for SSH operation consists of two parts:

• server — a part of the OS on a remote server;
• client — installed at the workstation.

Installing client software

For PCs with Unix family operating systems (Ubuntu, Debian, AlmaLinux, macOS, etc.) installation of additional software is not required. 

For Windows 10 and later devices, install the OpenSSH Client component. Read more in Microsoft's official documentation.

For mobile devices, install any SSH client.

Connection using login and password

1. Open a terminal window or console.

2. Enter the command:

   ssh <user>@<host>

   BASH
    Comments to the command

   <user> — account with superuser permissions

   <host> — IP address or domain name of the remote server

3. Enter the password for the account.

Connecting with SSH keys

SSH keys are a pair — a private key and a public key. The private key is secret information that is stored by the user. The public key must be stored on the server to be accessed via SSH.

1. Generate a key:
   
   1. Open a terminal window or console.

   2. Enter the command:
      

      ssh-keygen

      CODE
   3. Specify the file name and path for the SSH keys. If these parameters are not specified, the private key will be stored in the id_rsa file and the public key will be stored in id_rsa.pub in the directories:
      
      • Windows OS — C:\Users\<username>\.ssh\;
      • Unix family OS — /home/<username>/.ssh/.

2. Copy the contents of the public key to the /<superuser_name>/.ssh/authorized_keys file on the server. On Unix systems, you can use the following command to do this:

   ssh-copy-id -i <path_to_key> <user>@<host>

   BASH
    Comments to the command

   <path_to_key> — path to the file with public SSH key

   <user> — account with superuser permissions

   <host> — IP address or domain name of the remote server

3. Connect to the server:

   1. Open a terminal window or console.

   2. Enter the command:

      ssh <user>@<host>

      BASH
       Comments to the command

      <user> — account with superuser permissions

      <host> — IP address or domain name of the remote server

Copying files

You can copy files from a workstation to the remote server and back using the scp utility. To do this:

1. Open the terminal window or the console.

2. Enter the command:

   Copy a file from workstation to server

   scp <path_to_local_file> <user>@<host>:<path_to_remote_file>

   BASH

   Copy a file from server to workstation

   scp <user>@<host>:<path_to_remote_file> <path_to_local_file> 

   BASH
    Comments to the commands

   <path_to_local_file> — path to the file on the workstation

   <user> — account with superuser permissions

   <host> — IP address or domain name of the remote server

   <path_to_remote_file> — path to the file on the remote server

   Example command:

   scp my_local_file.txt root@192.0.2.1:/root/my_dir/my_remote_file.txt

   BASH