šŸš€ Introducing our new product: opHA Message Bus 5.0 - Real-time event management! Learn More

01 September 2020

Getting Started, Configuring the Appliance

Getting Started, Configuring the Appliance

Out of the box, the Opmantek VM requires no configuration changes to work, however you may wish to make changes so it complements your particular network environment. Items such as using HTTPS, setting the hostname or configuring the IP stack are all configurable.

 

Secure Access with https (optional)

The VM ships with support for secure https access enabled, and you can use https instead of http in any of the URLs mentioned.

However, the included certificate-key pair is the same for all VM downloads, and it is a self-signed certificate (for ā€œopmantek.localā€). This will cause your browser to display security warnings.

If you want to use https access operationally it isĀ highly recommendedĀ that you replace this shared default key-certificate pair with your own (or use an automated certification authority likeĀ letsencrypt/Ā for example).

Debian ā€“ Customizing Network Settings (optional)

The Debian team has an excellent wiki page dedicated to customizing the network configuration; this page is available in several languages:

Debian Network Configuration

CentOS ā€“ Set a custom IP Address and DNS (optional)

At this point the VM has DHCP enabled, and therefore it will receive a dynamic IP address suitable for your environment. The easiest way to access the VM at that point is from the virtualization software terminal. So go ahead and boot the VM. After the VM is finished booting you will be welcomed by a login prompt. First, log in using theĀ default credentials.

If itā€™s desirable to customize the network settings we offer the following options:

  • Option #1 ā€“ Manual configuration
    The VM appliance is a normal CentOS 7 system, hence all the mechanisms for network configuration in CentOS are available.
    Most specifically youā€™ll be interested in theĀ  files:
    /etc/hosts/etc/sysconfig/network

    /etc/sysconfig/iptables

    /etc/sysconfig/network-scripts/<interface_name>

  • Option #2 ā€“ Use our example network configuration files
    Rootā€™s home directory contains 2 example network configurations, one for static IPā€™s and one for DHCP. Ā Copy the one you require toĀ /etc/sysconfig/network-scripts/Ā and edit it to suit:
    <codeā€>cp ifcfg-ens192.staticĀ /etc/sysconfig/network-scripts/ <interface_name></codeā€>

Be sure to verify the following settings:

  • IPADDR
  • NETMASK
  • BROADCAST
  • GATEWAY
  • NAME; the interface name as found with the ip address command
  • DEVICE; the interface name as found with the ip address command
  • DNS;

Next restart the network service for the setting to take affect.Ā  In our testing the DHCP address was still present, and the static IP assigned as a secondary (this can be seen with the ā€˜ip addressā€™ command).Ā  The DHCP address can be removed by using the ā€˜ip address command delā€™ command or be rebooting the system.
TYPE=Ethernet
IPADDR=192.168.10.201
NETMASK=255.255.255.0
BROADCAST=192.168.10.255
GATEWAY=192.168.10.51
PROXY_METHOD=none
BROWSER_ONLY=no
BOOTPROTO=static
DEFROUTE= yes
IPV4_FAILURE_FATAL=no
IPV6INIT= yes
IPV6_AUTOCONF= yes
IPV6_DEFROUTE= yes
IPV6_FAILURE_FATAL=no
IPV6_ADDR_GEN_MODE=stable-privacy
NAME=enp0s3
UUID=9099afe7-6dd6-4aec-bd93-8950b67ab8f5
DEVICE=enp0s3
ONBOOT= yes
DNS1=192.168.10.80
DNS2=8.8.8.8