open-im-server/docs/contrib/linux-development.md

Ubuntu 22.04 OpenIM Project Development Guide

TOC

• Ubuntu 22.04 OpenIM Project Development Guide
  • TOC
  • 1. Setting Up Ubuntu Server
  • 1.1 Create openim Standard User
  • 1.2 Setting up the openim User's Shell Environment
  • 1.3 Installing Dependencies

1. Setting Up Ubuntu Server

You can use tools like PuTTY or other SSH clients to log in to your Ubuntu server. Once logged in, a few fundamental configurations are required, such as creating a standard user, adding to sudoers, and setting up the $HOME/.bashrc file. The steps are as follows:

1.1 Create openim Standard User

1. Log in to the Ubuntu system as the root user and create a standard user.

Generally, a project will involve multiple developers. Instead of provisioning a server for every developer, many organizations share a single development machine among developers. To simulate this real-world scenario, we'll use a standard user for development. To create the openim user:

# adduser openim # Create the openim user, which developers will use for login and development.
# passwd openim # Set the login password for openim.

Working with a non-root user ensures the system's safety and is a good practice. It's recommended to avoid using the root user as much as possible during everyday development.

1. Add to sudoers.

Often, even standard users need root privileges. Instead of frequently asking the system administrator for the root password, you can add the standard user to the sudoers. This allows them to temporarily gain root access using the sudo command. To add the openim user to sudoers:

# sed -i '/^root.*ALL=(ALL:ALL).*ALL/a\openim\tALL=(ALL) \tALL' /etc/sudoers

1.2 Setting up the openim User's Shell Environment

1. Log into the Ubuntu system.

Assuming we're using the openim user, log in using PuTTY or other SSH clients.

1. Configure the $HOME/.bashrc file.

The first step after logging into a new server is to configure the $HOME/.bashrc file. It makes the Linux shell more user-friendly by setting environment variables like LANG and PS1. Here's how the configuration would look:

# .bashrc

# User specific aliases and functions

alias rm='rm -i'
alias cp='cp -i'
alias mv='mv -i'

# Source global definitions
if [ -f /etc/bashrc ]; then
    . /etc/bashrc
fi

if [ ! -d $HOME/workspace ]; then
    mkdir -p $HOME/workspace
fi

# User specific environment
export LANG="en_US.UTF-8" 
export PS1='[\u@dev \W]\$ '
export WORKSPACE="$HOME/workspace"
export PATH=$HOME/bin:$PATH

cd $WORKSPACE

After updating $HOME/.bashrc, run the bash command to reload the configurations into the current shell.

1.3 Installing Dependencies

The OpenIM project on Ubuntu may have various dependencies. Some are direct, and others are indirect. Installing these in advance prevents issues like missing packages or compile-time errors later on.

1. Install dependencies.

You can use the apt command to install the required tools on Ubuntu:

$ sudo apt-get update 
$ sudo apt-get install build-essential autoconf automake cmake perl libcurl4-gnutls-dev libtool gcc g++ glibc-doc-reference zlib1g-dev git-lfs telnet lrzsz jq libexpat1-dev libssl-dev
$ sudo apt install libcurl4-openssl-dev

1. Install Git.

A higher version of Git ensures compatibility with certain commands like git fetch --unshallow. To install a recent version:

$ cd /tmp
$ wget --no-check-certificate https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.36.1.tar.gz
$ tar -xvzf git-2.36.1.tar.gz
$ cd git-2.36.1/
$ ./configure
$ make
$ sudo make install
$ git --version          

Then, add Git's binary directory to the PATH:

$ echo 'export PATH=/usr/local/libexec/git-core:$PATH' >> $HOME/.bashrc

1. Configure Git.

To set up Git:

$ git config --global user.name "Your Name"
$ git config --global user.email "your_email@example.com"
$ git config --global credential.helper store
$ git config --global core.longpaths true

Other Git configurations include:

$ git config --global core.quotepath off

And for handling larger files:

$ git lfs install --skip-repo

By following the steps in this guide, your Ubuntu 22.04 server should now be set up and ready for OpenIM project development.