Install Xinet Server on a Red Hat and CentOS Linux Server (first time or upgrade)

Use these instructions if you are installing the Administration software for the first time or if you are upgrading to a newer version on a Red Hat and CentOS Linux server.

Before completing an upgrade, back up your database on the Xinet Server. For more information, see Backing up and restoring data.

Preparation/Libraries for Xinet on Linux Server

Xinet software does not support the Security-Enhanced Linux (SELinux) module. You will need to disable it permanently before installing Xinet software. Temporarily disabling SELinux is not recommended, as a server reboot will automatically re-enable the service.

Xinet software requires the following additional libraries for Red Hat 6. You can use the Red Hat yum(8) command to install them.

If you are setting up a Linux Redhat 7.0 server, you need to verify that the following packages are installed in order for things to work. The number of packages that are installed may vary depending on which type of install you did. For example, a minimal installation may have some or even none of the following components installed.

•

libpng12

•

bc

•

tcsh

•

gzip

•	openssl-utils

•

httpd

•	openssl098e*

•

cups

•

cups-libs

•

libXt

•

libCrypto

•

unzip

•

firefox

•	Flash Plugin for Firefox

•

xauth

•	Xvfb* (from X11)

•	xwd (from X11)

•	Libreoffice 5.2.2 or later OR OpenOffice version 4 or later

•	libaio.x86_64

•

perl

•	perl(Data::Dumper)

•

java

* Packages needed from standard "RHEL 7 with GUI" install option.

Cut-and-paste friendly version:

Copy and paste the following “yum” commands to install these libraries:

yum install -y libpng bc tcsh gzip httpd cups cups-libs libXt unzip firefox xauth libaio perl 'perl(Data::Dumper)' java

yum install -y libpng12-1.2.50-7.el7_2x8_64

yum install -y openssl098e

Note: In order to install on Red Hat 7.0, the backward compatible libpng library must be installed. The standard install will include: /lib64/libpng15.so.*
But our code needs the older libpng12.so0. If the library is not present, it can be installed by running the command shown above.

For Xvfb and xwd, it is a bit more complicated:

Run this command to see the package that contains Xvfb:

> yum provides Xvfb

Install the latest package listed. It should look like this (but with a different version number):

xorg-x11-server-Xvfb-1.15.0-26.el6_6.x86_64 : A X Windows System virtual framebuffer X server.

Repo : installed

Matched from:

Other : Provides-match: Xvfb

Then run:

> yum install #latest X11 package listed#

The actual command should look similar to this:

> yum install -y xorg-x11-server-Xvfb-1.15.0-26.el6_6.x86_64

or simply:

> yum install -y xorg-x11-server-Xvfb

> yum install -y xorg-x11-apps

If “yum provides” doesn't find any packages, you need to enable optional RPMs to find Xvfb:

> subscription-manager repos --enable rhel-6-server-optional-rpms

And for Linux 7:

> subscription-manager repos --enable rhel-7-server-optional-rpms

In the worst case you can edit the repos directly:

> vi /etc/yum.repos.d/redhat-rhui.repo

Search for "optional" to find this entry (change enabled=1 if it is set to 0):

[rhui-REGION-rhel-server-optional]

name=Red Hat Enterprise Linux Server 7 Optional (RPMs)

mirrorlist=https://rhui2-cds01.REGION.aws.ce.redhat.com/pulp/mirror/content/dist/rhel/rhui/server/7/$releasever/$basearch/optional/os

enabled=1

The yum provides command should now be able to find Xvfb and "*/xwd".

Also PHP needs to be installed; see the next section.

Install PHP for running Portal on Linux 7.0-7.1

Prerequisites:

> yum install httpd

Installation:

With Portal v18.0 on Linux 7 and higher we are now using the built-in php 5.4 provided by the operating system. However, it may not be installed by default and running the installer with no php will cause the installer to fail with the following message:

> installportal

Server version: Apache/2.4.6 (Red Hat)

Server built: Dec 4 2014 03:30:10

sh: /usr/bin/php: No such file or directory

Missing PHP 5.4 distribution. Please use yum to install php on this server and rerun the Xinet Portal install. at installportal line 56.

yum install php php-mysql php-gd php-xml php-mbstring php-xmlrpc php-pear php-cli php-common php-pdo at installportal line 57.

If only php was installed the above message may not be shown. However an attempt to log into PORTALADMIN may fail after entering information for the 'First Run for Xinet Administration' section and hitting submit. Check the apache error log for any messages such as:

[Mon Jul 27 12:11:02.096168 2015] [:error] [pid 4716] [client 192.168.1.101:57909] PHP Fatal error: Call to undefined function mb_strtoupper() in /usr/etc/portal/PORTAL/libs/SECURITY.obj.php on line 647, referer: http://192.168.1.160/PORTALADMIN/index.php?dologin=true

CentOS: Just skip down to the 'yum install' command below.

One of the RPMs, php-mbstring, will not install unless the server has the appropriate optional repo subscription. Linux 7.1 see notes below. To enable it:

> subscription-manager repos --enable=rhel-7-server-optional-rpms

Red Hat Enterprise Linux 7.1 (HVM), SSD Volume Type from the EC2 management console, instead of the command: subscription-manager repos --enable=rhel-7-server-optional-rpms above.

You have to use:

> yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

To provide the list of PHP packages installed:

yum list "php*"

If php (or any of the required dependencies are missing), run the following to install the required packages:

yum install -y php php-mysql php-gd php-xml php-mbstring php-xmlrpc php-pear php-cli php-common php-pdo

A reboot is required after installing these packages.

Install Xinet on Red Hat and CentOS

1.	In a browser, open www.northplains.com, on the top right corner click Portal > Xinet Portal and log into AXI Support.

Tip:	If you are not able to log in, contact help@northplains.com.

2.	Click Downloads > Released Software.

3.	Open the Xinet directory and download the latest Xinet tar file for your platform.

4.	Download   Xinet-18.1-LINUX6.5-7.1-64.tar.

Once the file is on the server, you will need a place to extract it. Place it in /var/tmp or some other place where you have enough free space. The tar file is not compressed, and will take about the same amount of space extracted as it does whole.

5.	Extract the installer.

# tar -xvf Xinet-18.1-LINUX6.5-7.1-64.tar

6.	Install the package with the following command:

# /install

Note: If you are not logged in as root, use the following command: sudo /install.

7.	Next, license your software. See Licensing Software.