<%@ 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" %>
 

Migration Overview

InterWorx-CP provides a variety of tools to allow you to easily migrate your existing websites from many competitor’s systems to InterWorx-CP. We provide an individual website import for importing individual competitor website backup files as well as a mass transfer option to copy sites from an existing installation to InterWorx-CP.

InterWorx-CP Import Overview

What Systems Can I Import From?

InterWorx-CP currently imports from the following systems:

  • cPanel 10.x+
  • Plesk 7.5+
  • Ensim 4+
  • DirectAdmin 1+

What is Imported?

We are working toward a system that imports every last bit of data from your previous system to the new InterWorx-CP system. We are close, but there are some things that should be noted. InterWorx-CP imports all account features and options (disk space allotments, bandwidth allotments etc) and imports all configuration settings relavent to InterWorx-CP. The import process also copys over all website data, including MySQL databases, MySQL users and passwords.

 MySQL usernames and database names may be changed to fit into the InterWorx-CP infrastructure. This is unavoidable and you will most likely have to fix references to databases and database users after the fact.

InterWorx-CP will not import the following at this time:

  • E-mail box data (i.e. actual e-mails themselves)
  • SPAM settings
  • CRON jobs

There may also be files/settings etc specific to a given control panel that are not imported. If you are concerned about a given feature of the importer please open a support ticket and we’ll assist you.

How to Import a Single Account

Prerequisites

Last Updated for InterWorx-CP version 2.1.0

The server must have at least one SiteWorx account on the system.

Purpose

From the NodeWorx interface administrators will be able backups of SiteWorx accounts, both partial backups and full backups.

Procedure - NodeWorx Web Interface

If you prefer to use the web interface, follow the steps below.

  1. Click on the SiteWorx menu if it is not already expanded.
  2. Click on the ♦    Import submenu if it is not already expanded.
  3. Click on the      ◊    Single Account item.
  4. You should now be looking at the Single Account Import controls in the main content area.
  5. Click the radio button next to Local Backup File or the radio button next to Remote Backup File.
    1. Choose Local Backup File if you have a backup file saved on your computer’s hard drive. Click the Browse button and choose the backup file.
    2. Choose Remote Backup File if you have a backup file saved on the server. You will need to type in the fully-qualified path to the file. For example, if you have a backup file named testaccount.tar.gz in /tmp/backups/, you would enter: /tmp/backups/testaccount.tar.gz
  6. Choose the control panel from which this backup was created from the dropdown labeled Control Panel Type. For example, choose InterWorx-CP (all) if this backup was created by InterWorx-CP.
  7. Choose from the list of available IP addresses in the dropdown labeled IP Address.
  8. Click the Import button.
  9. If there is already an existing SiteWorx account with the same domain name you will be asked to confirm. Click the Import button to finish.

Procedure - Command Line Interface

The command line backup interface is less user-friendly, but you have a lot more options at your disposal. Using the command line interface is most useful when you want to automate (e.g., via CRON) the creation of SiteWorx account backups.

 You should be familiar with the Linux command line to use this method.

  1. SSH into the server
  2. su to the iworx system user. You may need to switch to the root user first (if you’re not already logged in as the root user) and then switch to the iworx user.

The command you will be running is, as the iworx user: 

[iworx@test-box ~]$ /home/interworx/bin/import.pex

import.pex has several command line parameters:

Required Parameters
Parameter Description
--archive=filePath and filename of backup file to import.
--ip-address=ip-addressIP address to use for the imported account. The IP address must be a valid shared or unused IP address.
--control-panel=cptypeIndicates the control panel from which this backup was created. Valid values:
* siteworx
* plesk
Optional Parameters
Parameter Description
--forceTells import.pex to force the restore which will delete any existing SiteWorx account, without a confirmation prompt, before restore proceeds.

To restore SiteWorx backup file /tmp/backup.tar.gz with a prompt to confirm deletion of the existing SiteWorx account: 

[iworx@test-box ~]$ /home/interworx/bin/import.pex \
                    --archive=/tmp/backup.tar.gz \
                    --control-panel=siteworx \
                    --ip-address=inifile

To restore SiteWorx backup file /tmp/backup.tar.gz without a prompt to confirm deletion of the existing SiteWorx account:

How to Import Multiple Account

Prerequisites

Last Updated for InterWorx-CP version 2.1.0

The server must have at least one SiteWorx account on the system.

Purpose

Using NodeWorx’s Mass Transfer interface, administrators can easily migrate multiple InterWorx-CP accounts from one server to another. Additionally, administrators can easily import multiple cPanel accounts from a cPanel server to an InterWorx-CP server.

Procedure

If you prefer to use the web interface, follow the steps below.

  1. Click on the SiteWorx menu if it is not already expanded.
  2. Click on the ♦    Import submenu if it is not already expanded.
  3. Click on the      ◊    Mass Transfer item.
  4. You should now be looking at the Mass Account Transfer controls in the main content area.
  5. In the Hostname: field, enter the hostname of the remote server from which you want to migrate.
  6. In the Root User: field, enter the root user of the remote server from which you want to migrate.
  7. In the Password: field, enter the password for the root user you entered above.
  8. Click the Query Accounts button.
  9. You will now see a list of accounts on the remote server, with a checkbox next to each account.
  10. Mark the checkboxes next to accounts you would like to migrate.
  11. Select the IP Address you want to use for each migrated account from the IP Address column.
  12. Select Import ... from the drop-down list at the bottom of the table.
  13. You will now see a list of the accounts you chose to mass transfer, along with a status for each account under the Import Status column.
    1. In Progress - Account is currently being backed up, transferred over from the remote server, and imported into InterWorx-CP.
    2. Pending - Account is waiting for import process to begin.
    3. Success - Import of account succeeded.
    4. Failure - Import of account failed. A message that indicates possible reasons for failure will appear beneath the Failure box.
  14. The page will automatically reload after a certain interval to update the import status of each account.
  15. When the mass transfer process is complete, all accounts will either have a Success or Failure status in the Import Status column.

 If you leave this page, the mass account transfers will still continue in the background. However, if you return to this page, you will no longer be able to see the status of any of the accounts.

Troubleshooting

If you get a Permission Denied error after clicking the Query Accounts button on the first Mass Account Transfer page, check the following:

  1. You have entered the correct root password.
  2. You have entered the correct root username.
  3. Double check that the remote server allows the root user to SSH in. You can verify this by trying to SSH into the remote server as the root user.
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.

 

some small text here

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