DEV Community

hediyeh kianmehr
hediyeh kianmehr

Posted on

# OpenIAM Installation Guide

Introduction

OpenIAM is a software that helps organizations manage user access securely. This guide will walk you through a simple way to install OpenIAM on a Single VM (Virtual Machine) without needing deep technical knowledge.

Installation Overview

You will:

  1. Prepare your system (check system requirements).
  2. Download and set up a Linux operating system (CentOS).
  3. Connect to your VM.
  4. Install necessary system tools.
  5. Start the OpenIAM installation.

Step 1: System Requirements

When setting up OpenIAM, you have two deployment options based on your needs.

  • If you are developing, testing, or experimenting, you can use a Non-Production setup with lower system requirements.
  • If you are running OpenIAM in a live environment with real users and high traffic, you should use a Production setup with higher resources for stability and performance.

Choose the appropriate option based on your environment and requirements.

Non-Production

Use when testing, developing, or running environments where performance, high availability, and scalability are not critical.

  • Memory: 48 GB
  • CPU: 8 CPUs
  • Disk: 80 GB

Production

Use when running a live, high-availability environment with significant traffic, real users, and critical security needs.

  • Memory: 64 GB
  • CPU: 12 CPUs
  • Disk: 200 GB

To check your system, run these commands:

lscpu         # Checks CPU
free -m       # Checks memory
cat /etc/os-release  # Shows OS version
df -H         # Checks disk space
Enter fullscreen mode Exit fullscreen mode

Example Outputs

Check CPU

[root@server ~]# lscpu
Architecture:        x86_64
CPU(s):              8
Thread(s) per core:  1
Core(s) per socket:  1
Socket(s):           8
CPU MHz:             2199.994
Hypervisor vendor:   KVM
Enter fullscreen mode Exit fullscreen mode

Check Memory

[root@server ~]# free -m
              total        used        free      shared  buff/cache   available
Mem:          31959         221       31473          16         264       31341
Swap:           511           0         511
Enter fullscreen mode Exit fullscreen mode

Check Operating System

[root@server ~]# cat /etc/os-release
NAME="CentOS Stream"
VERSION="8"
ID="centos"
VERSION_ID="8"
PRETTY_NAME="CentOS Stream 8"
Enter fullscreen mode Exit fullscreen mode

Check Disk Space

[root@server ~]# df -H
Filesystem           Size  Used Avail Use% Mounted on
/dev/mapper/cs-root   52G  2.4G   49G   5% /
/dev/mapper/cs-home   25G  209M   25G   1% /home
/dev/sda1            1.1G  295M  769M  28% /boot
Enter fullscreen mode Exit fullscreen mode

Step 2: Download CentOS

OpenIAM works best with CentOS (a version of Linux). If you don’t have it yet, download it here:

CentOS Download


Step 3: Choose a Virtualization Platform

You can use one of the following platforms to create a VM:

  • VirtualBox (Free, cross-platform)

    VirtualBox is a free and open-source virtualization software that works on multiple operating systems including Windows, macOS, and Linux. Ideal for beginners and casual users.

  • VMware Workstation Player (Free for personal use)

    VMware Workstation Player is a free version of VMware’s virtualization software for non-commercial use. It’s easy to use and supports advanced features for virtual environments.

  • Hyper-V (Built into Windows Pro/Enterprise)

    Hyper-V is a Microsoft virtualization technology available in Windows Pro and Enterprise editions. It's useful for creating and managing virtual machines directly from your Windows OS.

  • Proxmox (For advanced users, open-source)

    Proxmox VE is an open-source virtualization platform that combines KVM for virtual machines and LXC for containers. It’s a powerful solution for data centers or more advanced use cases.

  • KVM/QEMU (Linux-based, powerful for server environments)

    KVM (Kernel-based Virtual Machine) and QEMU (Quick Emulator) are popular virtualization technologies for Linux servers. They’re ideal for creating high-performance virtual machines on Linux-based systems.


Step 4: Connect to Your VM

You can use SSH to securely access and manage your VM remotely. SSH is essential because most VMs run without a graphical interface, and it allows encrypted communication over the network. Before connecting, ensure the SSH port is open and OpenSSH is installed; otherwise, the connection won’t work.

  1. Find your VM’s IP Address Run this command:
   ip addr
Enter fullscreen mode Exit fullscreen mode
  1. Connect to your VM Use SSH (a remote login tool) to connect. Replace [your VM's IP] with your actual VM address:
   ssh root@[your VM's IP]
Enter fullscreen mode Exit fullscreen mode

Example:

   ssh root@172.16.101.128
Enter fullscreen mode Exit fullscreen mode

If you're using Windows, you can use PuTTY (a simple and effective tool for managing remote servers securely).

Download PuTTY here: PuTTY Download


Step 5: Install Necessary Tools

Before installing OpenIAM, install some basic system tools. Run:

dnf install -y tar wget curl vim
Enter fullscreen mode Exit fullscreen mode

Why Install tar?

The tar command is essential because it allows you to extract installation files that are often distributed as compressed archives (.tar.gz or .tar.bz2). Without tar, you may not be able to properly extract and install OpenIAM.

This will ensure the system can extract files and manage installations efficiently.


Step 6: Choose Installation Method

  • With Internet Access: The system will download required files automatically.
  • Without Internet Access: You will need to download and transfer the required packages manually.

Simply follow the OpenIAM instructions, and your system will be set up!

Top comments (0)