How to Install InterWorx-CP

The InterWorx-CP team has spent a considerable amount of time making the install process for InterWorx-CP as simple and straightforward as it can be. Our installer script tries to compensate for differing systems and package mixes automatically.

Prerequisites

  1. A server or supported VPS system of at least the minimum supported hardware configuration.
  2. A clean install of one of the supported operating systems
  3. A valid active InterWorx-CP license key
  4. UIDs 102 → 107 and GIDs 102 and 103 must be free for use. The Qmail MTA which InterWorx-CP uses requires these UID/GIDs to be available for it.
A CLEAN install is required in most cases. InterWorx-CP must install versions of Apache, PHP, MySQL and other tools that it is familiar with and that may have a custom configuration. If you have a server with any websites on it at all then you will need to either clean off what you have or risk the install process overwriting your config files. Your best bet is simply to start with a clean system.

Purpose

The purpose of this how-to is to install InterWorx-CP on a dedicated server or VPS system.

Procedure

  • Grab the latest install script just running the following commands:
[root@test-box ~]# cd /root/
[root@test-box ~]# wget http://updates.interworx.com/iworx/scripts/iworx-cp-install.sh
  • Run the InterWorx-CP installer by executing the bash shell script downloaded in the last step. In its most basic form the script takes no arguments and requires no user input. Just run it as root.
[root@test-box ~]# sh iworx-cp-install.sh
  • Run the smiley command when you're done installing to send the InterWorx-CP developers the distro you've installed on. It not's mandatory but makes them feel warm and fuzzy
[root@test-box ~]# sh iworx-cp-install.sh :D

Troubleshooting

The most common problem during the install is package conflicts between the packages being installed and those that are already on the system. The installer is very nice, in that it can be run and re-run as needed and will continue where it previously left off if you run into problems. Just keep an eye on the output for conflict errors, and remove any conflicting packages that are reported. After the conflicts are removed simply re-run the installer and it will continue.

The installer will try to remove packages pre-emptively for you (and prompt where necessary before it removes anything)

Post a Comment

You must be logged in to post a comment.