<%@ page import="java.sql.*" %> <%@ page import="java.util.*" %> <%@ page import="java.text.*" %> <%@ page import="com.assorted.affiliate.data.*" %> <%@ page import="com.assorted.affiliate.display.*" %> <%@ include file="/jsp/session-handler.jsp" %> InterWorx-CP - The InterWorx Cluster Panel (interworx.com) <%@ include file="/ssi/header.html" %> <%@ include file="/ssi/search-bar-include.jsp" %>

InterWorx-CP Installation Overview

InterWorx-CP is a complex system and works on a variety of platforms. The clean installation of such a system on many platforms is unfortunately not simple and this overview will try to give you an idea of how installing InterWorx-CP on your system will affect it.

What Does it Mean to Install InterWorx-CP on My System?

InterWorx-CP will take care of most basic tasks on your system. InterWorx-CP sets up logical defaults for those things which are usually left to a system administrator. InterWorx-CP is also very system admin friendly in that you can easily edit files on the system without confusing InterWorx-CP. For most tasks you will be able to use InterWorx-CP without ever logging into your server via the shell. You may choose however to perform some tasks on the system via SSH and this is fine as well.

What Exactly Will Be Installed?

InterWorx-CP installs all of the base services (mail, dns, web, ftp) to make your server manageable via InterWorx-CP. The current list of installed packages can always be found on the updates.interworx.com RPM repository, located at InterWorx updates site. The repository is indexed by distribution and the README will explain the distribution -> mapping.

What is the Process for Installation?

Installation is most easliy done on a “clean” system. By clean we mean one that is newly installed with a supported operating system and that has had no special configuration or other tweaking. Most servers that were previously production boxes or previously housed websites cannot be converted to use InterWorx-CP without a reinstall. This also goes for servers that previously ran a competitor’s control panel system, a fresh install is normally needed as well. The process for installation is very easy after your core operating system is setup. Just follow the script install instructions and you can have a running system in as little as 15 minutes!

What if I'm Installing an InterWorx-CP Cluster?

The process for installation is the same for a cluststed setup. You must install InterWorx-CP on each server in the cluster. The only special requirement for a cluster install is that all servers reside on the same physical network segment.

System Requirements

InterWorx-CP runs on a variety of systems and hardware including Virtual Private Server (VPS) systems. The hardware and software requirements listed below represent systems / configurations that are known to work and are supported. Other configurations may work (with varying degrees of success) but are unsupported by the InterWorx-CP team. Any resource amounts listed (disk space, memory etc) are minimum recommdantions and a greater amount of the given resource is usually beneficial but not required.

Supported Hardware

  • 128 MB of memory
  • Pentium III 866 CPU
  • 512 MB of disk space (for InterWorx-CP alone)

Supported VPS Systems

  • Virtuozzo
  • XEN (BETA SUPPORT)

Supported Software

  • RedHat Linux 9
  • RedHat Enterprise Linux 3.x, 4.x
  • CentOS 3.x, 4.x
  • Fedora Core 1, 2, 3, 4

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

Last Updated for InterWorx-CP version 2.1.0
  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
  • After installation is complete you’ll want to activate your InterWorx-CP license. Further information below.

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)

How to Activate Your InterWorx-CP License

Prerequisites

Last Updated for InterWorx-CP version 2.1.0

  1. A fully installed InterWorx-CP server with no active license keys applied.

  2. An InterWorx-CP license key. License keys can be purchased through any authorized InterWorx-CP Reseller Partner

Purpose

This how-to will walk you through the process of installing / activating an InterWorx-CP license key on your InterWorx-CP server.

Procedure

  1. Login to your InterWorx-CP server via SSH and become the root user.

  2. Run the goiworx.pex script 

     root@server# cd /usr/local/interworx/bin
 root@server# ./goiworx.pex

  3. Enter your license key when prompted 

      +----------------------------------------------------------------------+
  |                            Go! InterWorx                             |
  +----------------------------------------------------------------------+

  +----------------------------------------------------------------------+
  |                          License Key Setup                           |
  +----------------------------------------------------------------------+

  Please enter license key: INTERWORX_XXXXXXXXXX
  You entered 'INTERWORX_XXXXXXXXXX'.

  4. Setup the main NodeWorx user. This will be the administrator account for the InterWorx-CP installation 

      +----------------------------------------------------------------------+
  |                     Default NodeWorx User Setup                      |
  +----------------------------------------------------------------------+

  e-mail address: admin@yourbox.com

  password: your-password
  confirm : your-password

  5. Once the goiworx scripts ends login to NodeWorx by going to https://<your ip>:2443/nodeworx/ using the e-mail address and password you setup in the previous step.

Troubleshooting

  • If you get any license activation errors be sure that your server time is correct
  • If you are moving a license from one server to another you’ll need to open a support ticket for us to reset your license
  • Make sure that license.interworx.com is resolvable and pingable from your server
  • Verify that port 2443 is open both out and inbound to the server

FAQ

Leaving your Web Host? We are always welcoming "refugees" from other web hosts! If you need your website moved quickly, contact us to make special arrangements.

 

<%@ include file="/ssi/footer.html" %>