MySQL Studio

 Introduction

 AI Chat

 SQL Workshop

 My Files

 Configuration Options

 Known Issues

 MySQL Studio - Known Issues

Overview

This section documents current known issues and important prerequisites for running MySQL Studio. Please review these details to ensure a smooth installation and operation, especially in environments with SELinux enabled.

Requirements

Before installing MySQL Studio, ensure your system meets the following requirements:

  • Operating System:
    Oracle Linux 8.10 is required.

  • Node.js:
    The installer expects that Node.js is not installed on the system. It will install Node.js version 22 as part of the setup process.

  • Container Engine:
    The installer will install Podman. Ensure that neither Podman nor Docker is present on the host before running the installer to avoid conflicts.

  • Kernel for SELinux Support:
    For SELinux-enabled environments, Oracle Linux 8.10 with Kernel version 5.15 is required. SELinux support may be limited or unavailable with other kernel versions.

Known Issues

  • Python Notebook Environments and SELinux:
    The Python notebook environments in MySQL Studio may not function properly when SELinux is enabled, unless you are running Oracle Linux 8.10 with a 5.15 kernel. Using a different OS version or kernel with SELinux enabled may result in limited or broken functionality within the Python notebook environments.

  • SELinux Policy Development Package Required:
    Before running the setup command (sudo(8) mysql-ai-setup), users must install the SELinux policy development package. Use the following command to ensure proper installation:

    sudo dnf install selinux-policy-devel

    Skipping this step may result in setup errors or incomplete SELinux support.

  • Current Directory Permissions for Installer Bug:
    Due to a known installer bug, the installer will attempt to run the podman(1) command as the mydas user in the current directory. The current directory must therefore be writable by the mydas user. If it is not, installation may fail at this step.
    To set the necessary permissions, you can run:

    chmod a+wx .

    Note: This command will allow all users to write to and access the current directory, which may have security implications. Use with caution and adjust permissions according to your organization’s security policies.

Glossary

  • Installer:
    Refers to the mysql-ai-setup command used to install and configure MySQL Studio.