This chapter describes the initial steps of configuring syslog-ng Store Box (SSB). Before completing the steps below, unpack, assemble, and power on the hardware. Connect at least the external network interface to the local network, or directly to the computer from which SSB will be configured.
For details on unpacking and assembling the hardware, see "syslog-ng Store Box Hardware Installation Guide" in the Installation Guide. For details on how to create a high availability SSB cluster, see "Installing two SSB units in HA mode" in the Installation Guide.
The syslog-ng Store Box (SSB) application can be connected from a client machine using any modern web browser.
For details on supported browsers, see Supported web browsers
SSB can be accessed from the local network. SSB attempts to receive an IP address automatically via DHCP. If it fails to obtain an automatic IP address, it starts listening for HTTPS connections on the 192.168.1.1 IP address. Note that certain switch configurations and security settings can interfere with SSB receiving an IP address via DHCP. SSB accepts connections via its external interface (EXT, for details on the network interfaces, see Network interfaces).
The SSB console displays the IP address the external interface is listening on.
If SSB is listening on the 192.168.1.1 address, note that the 192.168.1.0/24 subnet must be accessible from the client. If the client machine is in a different subnet (for example its IP address is 192.168.10.X), but in the same network segment, the easiest way is to assign an alias IP address to the client machine. Creating an alias IP on the client machine virtually puts both the client and SSB into the same subnet, so that they can communicate. To create an alias IP complete the following steps.
For details on creating an alias IP on Microsoft Windows, see Creating an alias IP address (Microsoft Windows).
For details on creating an alias IP on Linux, see Creating an alias IP address (Linux).
If configuring an alias interface is not an option for some reason, you can modify the IP address of SSB. For details, see Modifying the IP address of SSB.
The Welcome Wizard can be accessed only using the external network interface of SSB, as the management interface is not configured yet.
Open the page https://192.168.1.1 from your browser and accept the certificate shown. The Welcome Wizard of SSB appears.
This procedure describes how to assign an alias IP address to a network interface on Microsoft Windows platforms.
To assign an alias IP address to a network interface on Microsoft Windows platforms
Navigate to Start menu > Settings > Network Connections.
Double-click the Local Area Connection and then click Properties.
Select the Internet Protocol (TCP/IP) component in the list and click Properties.
To display the Advanced TCP/IP Settings window, click Advanced.
Select the IP Settings tab and in the IP Addresses section, click Add.
Into the IP Address field, enter 192.168.1.2. Into the Netmask field, enter 255.255.255.0.
If your internal network uses the 192.168.1.0/24 IP range, the 192.168.1.1 and 192.168.1.2 addresses might already be in use. In this case, disconnect syslog-ng Store Box (SSB) from the network, and connect directly a computer to its external interface using a standard cross-link cable.
To complete the procedure, click Add.
This procedure describes how to assign an alias IP address to a network interface on Linux platforms.
To assign an alias IP address to a network interface on Linux platforms
Start a terminal console (for example gnome-terminal, konsole, xterm, and so on).
Issue the following command as root:
ifconfig <ethX>:0 192.168.1.2
where <ethX> is the ID of the network interface of the client, usually eth0 or eth1.
Issue the ifconfig command. The <ethX>:0 interface appears in the output, having inet addr:192.168.1.2.
Issue the ping -c 3 192.168.1.1 command to verify that syslog-ng Store Box (SSB) is accessible. A similar result is displayed:
user@computer:~$ ping -c 3 192.168.1.1 PING 192.168.1.1 (192.168.1.1) 56(84) bytes of data. 64 bytes from 192.168.1.1: icmp-seq=1 ttl=63 time=0.357 ms 64 bytes from 192.168.1.1: icmp-seq=2 ttl=63 time=0.306 ms 64 bytes from 192.168.1.1: icmp-seq=3 ttl=63 time=0.314 ms --- 192.168.1.1 ping statistics --- 3 packets transmitted, 3 received, 0% packet loss, time 2013ms rtt min/avg/max/mdev = 0.306/0.325/0.357/0.030 ms