Skip to main content
Skip table of contents

Rocky Linux 9 Software Appliance

This document outlines the specifics of a virtual appliance designed to operate on VMware with Hardware Version 17. It is compatible with ESXi 7.0 and later versions.

Y Soft offers a comprehensive Virtual Software Appliance that includes Rocky Linux 9 and the latest version of SAFEQ Cloud. For detailed package specifications, see the Complementary Information section of this page.

This guide is applicable to virtual machines using OVA/OVF images.

Prerequisites

A functioning virtual machine (VM) environment. If you are not sure how to set up a VM, ask your IaaS provider for assistance.

Installing the Virtual Software Appliance

  1. Download the most recent Virtual Software Appliance from the YSoft Partner Portal (YSoft SAFEQ Cloud > Software).
  2. Open the package in your VM manager. If you are using VMware, select File > Open, then navigate to the Virtual Software Appliance and follow the on-screen guided instructions.
  3. Once the Virtual Software Appliance is imported, verify and adjust the VM settings:
    1. Memory size – The default is 4 GB.
    2. Processor – We recommend 1 processor/2 cores.
    3. Options > VMware Tools – Verify the  Synchronize guest time with host option. Disable automatic updates as the appliance uses open-vm-tools updated with Rocky Linux 9.
    4. Network – Make sure the network adapter is set to Bridged Mode to ensure the appliance has direct access to the network.

  4. Start the VM.
  5. At the login prompt, enter admin as the username and va as the password.
  6. After your first login, you will be prompted to change your password. If you are connected via SSH, you will be disconnected after changing the password. Log in again to continue.

    By default, the appliance is set up to use the US keyboard mapping.

  7. The Appliance Welcome screen provides a comprehensive view of the setup. Note these values, as you will be customizing them later on.



From here, you can continue the installation in your VM manager or remotely connect to the appliance using an SSH client such as MobaXterm or PuTTY (see the Complementary Information section) with the username admin and your new password.

Installing SAFEQ Cloud

  1. When prompted to start the installation process, press y.
  2. Enter your password to start the wizard with elevated privileges. Follow the instructions in the wizard. During the installation, you will be asked to:
    1. Change the keyboard layout.
    2. Customize the complete hostname in FQDN form (e.g., appliance-01.acme.com).
    3. Customize the network settings. For example, change to a static IP address.

      Do not change the network profile name.

    4. Customize the Time Zone.
  3. When the SAFEQ Cloud installer opens:
    • Read and accept the license agreement.
    • Accept the installation directory.
    • Select the role of the server – in this case Extra secondary server for existing vendor or customer installation.
  4. When prompted for Connection details, provide the required information for the primary server address and account name.

    You can see these in Customer information in SAFEQ Cloud Web UI.

  5. Accept to autostart all services and complete the installation.

Firewall ports will be updated automatically.

At the end of the installation, you will be presented with instructions on how to use the Cockpit admin tool.

Optional recommended post-installation tasks

Connect to the appliance via an SSH client with the username admin and your password.

If you did not set a static IP address during installation, change the network settings as follows:

CODE
$ sudo nmtui


To change the keyboard layout:

  1. To list all available keymaps:
    CODE
    $ sudo localectl list-keymaps
  2. To temporarily change the system’s keymap, for example, to ‘English UK keyboard’:
    CODE
    $ sudo loadkeys uk

  3. To permanently change the system’s keymap, for example, to ‘English UK keyboard’:
    CODE
    $ sudo localectl set-keymap uk

Complementary Information

Installation log

To check the installation log on Rocky Linux 9, use the following command:

CODE
more /home/admin/safeqcloud-Install-Script.log


SSH clients

Windows:

macOS:

  1. Launch the Terminal app.
  2. From the menu, select Shell > New Remote Connection.
  3. This will open a connection manager window.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.