The InterWorx Install Script
Install OverviewInstalling InterWorx is pretty straightforward. We will break it down into the following simple steps
- Install the operating system.
- Download the install script.
- Run the install script
- Activate the InterWorx License.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.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:
- MySQL databases will be installed at /var/lib/mysql directory.
- 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.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.InterWorx is installed via a bash script which essentially does a few things:
- The script will deactivate SELINUX since it gets in the way of installation.
- The script will move /home/ to /chroot/home/ if it’s not on its own partition and then symlink /chroot/home/ to /home.
- The script will uninstall any conflicting RPM packages that are installed initially. It does this with yum.
- The script will install InterWorx and it’s supporting software packages using yum.
- Finally, disk usage quotas will be enabled on the primary user partition (usually /, /home, or /chroot).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 http://updates.interworx.com/iworx/scripts/iworx-cp-install.sh. The easiest way to grab it is via the command “wget”. If wget is not installed, run the command: yum install wget
[[email protected] ~]# wget http://updates.interworx.com/iworx/scripts/iworx-cp-install.sh Resolving updates.interworx.com... 22.214.171.124 Connecting to updates.interworx.com|126.96.36.199|:80... connected. HTTP request sent, awaiting response... 200 OK Length: 41045 (40K) [application/x-sh] Saving to: ‘iworx-cp-install.sh.1’ 100%[======================================>] 41,045 --.-K/s in 0.006s 2012-07-05 15:53:37 (6.90 MB/s) - ‘iworx-cp-install.sh.1’ saved [41045/41045] [[email protected] ~]#Run the install script like this:
[[email protected] ~]# sh iworx-cp-install.shAt 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 yumand 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 runyum, running it multiple times will just make yum ignore commands to install already installed packages.The install script has a few optional parameters that can be useful for installation in advanced environments.
[[email protected] ~]# sh iworx-cp-install.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: updates.interworx.com). -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 InterWorx-CP. -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 messageFor 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:
[[email protected] ~]# sh iworx-cp-install.sh -l -u ...Once installation is complete, you can move on to the license activation step.
Was this answer helpful?
Import a Single Account Import Through NodeWorx If you prefer to use the web interface, follow...
2.1 Interactive Usage Below you will find the list of available Controllers. Each...
How to: Update the Cron Variables Click the Hosting Features menu item if it is not...
Login to your Linux server as root, via SSH or Terminal. Download and run the installer: sh...
This section covers the InterWorx Control Panel backup system and how to restore backups of your...