Installing

System Specs

Recent sipXcom RPMs will only install on CentOS 7.x with amd64/x86_64 architecture.

We recommend using the CentOS minimal ISO.

The following is a recommended hardware configuration:

2x CPU/vCPU
8GB RAM
50GB or larger disk

Note

All servers in the cluster should have a static IP address.
The server(s) must have only one active NIC or IP interface.
Only IPv4 is supported. Disabling IPv6 on the NIC during OS install is recommended.
Review the partition sizes if automatic partitioning is used.
1GB ext2 for the /boot partition with the boot flag set
Set swap partition equal to the system RAM size
Allocate the rest of the free space for the root (/) partition as a LVM volume, XFS formatted

Warning

If the disk is larger than 50G and you use automatic partitioning, most of the space will be allocated to /home rather than /.

Prepare Server

Log on as root via ssh:
```
sudo -s
```

If you want root password authentication:

passwd

vi /etc/ssh/sshd_config =>

  PermitRootLogin yes

  PasswordAuthentication yes

service sshd restart

Since CentOS 7 is now end of life, we must use its vault for yum

sed -i 's|mirror.centos.org|vault.centos.org|g' /etc/yum.repos.d/CentOS-*
sed -i 's|mirrorlist|#mirrorlist|g' /etc/yum.repos.d/CentOS-*
sed -i 's|#baseurl|baseurl|g' /etc/yum.repos.d/CentOS-*

Remove epel to avoid conflicts
```
yum remove -y epel-release
```
Update OS:
```
yum update -y
```
Install wget used for downloading RPMs
```
yum install -y wget
```

Setup Google Could Artifact registry

If you are NOT using a Google Cloud image, you must add and install their artifact registry plugin:

wget -O /etc/yum.repos.d/artifact-registry-plugin.repo \
  https://storage.googleapis.com/sipxecs/artifact-registry/artifact-registry-plugin.repo

yum install -y yum-plugin-artifact-registry

Setup sipXcom repo

wget -O /etc/yum.repos.d/sipxcom.repo \
  https://storage.googleapis.com/sipxecs/sipxcom/24.01/centos-7-x86_64/sipxcom.repo

Enable elasticsearch

yum install -y elasticsearch

systemctl enable elasticsearch

service elasticsearch start

Configure System

On first boot you may need to update your network interface card config

vi */etc/sysconfig/network-scripts/YourNICCard* => (update)

  ONBOOT="yes"

Increase Max Number of open files and max user processes for MongoDB (important for larger systems)

Update max file size. ONLY do this if the default is less than 65536.

cat /proc/sys/fs/file-max (to check default)

vi /etc/sysctl.conf =>

  fs.file-max=65536

edit system limits:

vi /etc/security/limits.conf => (add)

*          soft     nproc          65535
*          hard     nproc          65535
*          soft     nofile         65535
*          hard     nofile         65535`

Reboot system:
```
reboot
```

Install and Setup sipXcom

Install sipXcom RPMs

yum install -y sipxcom

Initial setup

Execute the sipXcom setup script:
```
sipxecs-setup
```

The system will reboot to disable selinux to allow the rest of the setup routine to work properly.

Network Configuration

Run setup script again:
```
sipxecs-setup
```
Answer questions as follows for a single server instance:
- hostname: e.g. us1
- domain: e.g. onrelay.net
- SIP Domain: e.g. us1.onrelay.net
- SIP Realm: e.g. us1.onrelay.net
  
  Ignore “Failed to open /dev/tty: No such device or address” warnings
Update system again and reboot:
```
yum update -y

reboot
```

After a few minutes, the administration web interface should be available at https://your-host-name-or-ip-address/