Chapter 1: InterWorx Installation Requirements Up Part I: Installing InterWorx Control Panel Chapter 3: License Activation 

2 The InterWorx Install Script

2.1 Install Overview

Installing InterWorx is pretty straightforward. We will break it down into the following simple steps
  1. Install the operating system.
  2. Download the install script.
  3. Run the install script
  4. Activate the InterWorx License.

2.2 Installing the Operating System

Once you’ve decided on the compatible operating system you want to use, it needs to be installed. If you’re renting a dedicated server or VPS from a hosting provider, this step may already be completed for you. If so, you can skip to section 2.3.

2.2.1 Disk Partitioning

During the Linux install process, the installer will give you the opportunity to define disk partition size and configurations. The default configuration is usually to have one large partition mounted at the root (/) directory. The default configuration is acceptable, but if you want to make customizations to the partition layout, that is fine. As you make these plans, keep the following things in mind:
  1. MySQL databases will be installed at /var/lib/mysql directory.
  2. All user web and mail data will reside under the /home directory.
If you want a separate partition for /home, we recommend that you instead set it up as a partition called /chroot, instead of /home. Later, the InterWorx install script will move /home into /chroot/ and recreate /home as a symlink to /chroot/home. The reason for this is two-fold, first for compatibility with the jailed-ssh feature, and second, for compatibility with the Clustering setup. If you know you won’t use the jailed-ssh feature or Clustering in the future, this step is not required - you can just make the /home partition as /home.

2.2.2 Choosing Packages

During Linux installation, you will be given the opportunity to choose what kind of server this will be. You can choose whatever you like, as the InterWorx install script will uninstall any conflicting packages, and install any packages that are needed but not initially installed. If you’re looking for a recommendation, we suggest Basic Server, no GUI.

2.3 InterWorx Install Script Overview

InterWorx is installed via a bash script which essentially does a few things:
  1. The script will deactivate SELINUX since it gets in the way of installation.
  2. The script will move /home/ to /chroot/home/ if it’s not on its own partition and then symlink /chroot/home/ to /home.
  3. The script will uninstall any conflicting RPM packages that are installed initially. It does this with yum.
  4. The script will install InterWorx and it’s supporting software packages using yum.
  5. Finally, disk usage quotas will be enabled on the primary user partition (usually /, /home, or /chroot).

2.4 Getting the Install Script

After OS installation is complete, and the server as rebooted, the following steps need to be run at the Linux terminal/command line. Login to the server as root via SSH, and then continue.
The InterWorx install script is located at The easiest way to grab it is via the command “wget”. If wget is not installed, run the command: yum install wget
[root@server1 ~]# wget
Resolving Connecting to||:80... connected. HTTP request sent, awaiting response... 200 OK Length: 41045 (40K) [application/x-sh] Saving to: ‘’
100%[======================================>] 41,045      --.-K/s   in 0.006s
2012-07-05 15:53:37 (6.90 MB/s) - ‘’ saved [41045/41045] 
[root@server1 ~]#

2.5 Running the Install Script (Simple Version)

Run the install script like this:
[root@server1 ~]# sh
At this point the script will take over and install automatically. It has been designed to anticipate differences and distributions and thus is very good at performing the actions necessary to get InterWorx installed properly on your operating system. You will be occasionally prompted and warned when the script will make a significant change to your system. For example, prior to disabling SELINUX, the script asks you if this is OK. You can suppress these prompts by running the script with the -l option.
In the event that yum is unable to install a package due to a dependency issue, the script will halt. You will usually be able to see the output from yum and either use it to diagnose and repair the issue yourself or forward the output to InterWorx Support and have them repair the issue for you. In either case, you can always run the script as many times as you need until the install completes successfully. Since most of what the script does is run yum, running it multiple times will just make yum ignore commands to install already installed packages.

2.6 Running the Install Script (Advanced Version)

The install script has a few optional parameters that can be useful for installation in advanced environments.
[root@server1 ~]# sh -h
Usage: $0 [-s rpm/ks server hostname] [-s server] [-d] [-f] [-u] [-k] [-l] [-i] [-h]
    -s <server> Specify a different rpm host to grab 
                rpms from (default:
    -d Turn debugging on (you’ll have to hit enter
       sometimes to keep things moving, output is halted so 
       you can see it).
    -f FORCE installation even if the distro isn’t supported.
    -u Perform a "yum update" prior to installation of
    -k Force the removal of any conflicting packages that will
       interrupt the InterWorx-CP install.
    -l Run in headless mode.  No prompting will occur.
    -i Install all packages *except* InterWorx-CP itself.
    -h Show this help message
For example - if you wanted to run the install script and have it not prompt the user for anything, and run yum update first, you could run it like this:
[root@server1 ~]# sh -l -u
Once installation is complete, you can move on to the license activation step.
 Chapter 1: InterWorx Installation Requirements Up Part I: Installing InterWorx Control Panel Chapter 3: License Activation 

(C) 2019 by InterWorx LLC