Migrate your site from Webserve to IU Sitehosting

On this page:


Overview

Following are general steps to migrate your site from Webserve to the IU Sitehosting servers. This is not a comprehensive guide; your site may need additional work not covered here.

The Webserve group account owner will need to complete most of these steps.

For a list of IU Sitehosting features and other changes from Webserve, see About IU Sitehosting.

Pre-migration checklist

Before requesting an Sitehost account, verify that Duo is enabled for the Group account that you will use on Sitehost. To enable Duo on a group account, see Use Two-Step Login (Duo) with a group account.

Before migrating your site, refamiliarize yourself with your site's code and check for the following:

  • Does your Webserve site have any virtual hosts?
  • Does your site have PHP code with compatibility issues with PHP 7.3?
  • Does your site have scripts that will need to be updated?
  • Do you have active cron jobs that will need to be recreated?
  • Does your site use .htaccess files to control access?

For more, see About IU Sitehosting.

Create a new IU Sitehosting account

If you're the account owner, follow the steps below to create a new IU Sitehosting account. This will create accounts on both the Sitehost production server and the test server, Sitehost-test.

  1. Log into Enterprise Web Technical Services with your personal username and passphrase.
  2. You will see a list of Group accounts that you own. Click Overview<account> for the group account for which you want to request IU Sitehosting.
  3. Click Request Sitehost account. Read the User Agreement, provide the information requested at the end, and then click Request.
  4. The request will be sent to Web Services Support for approval. You will receive email confirmation that the account was created.

Move your site files to Sitehost

How you move your site files to Sitehost will depend on how you manage your site. UITS recommends that you set up your site first on the test server, sitehost-test.iu.edu. The following instructions assume you are moving your Webtest site to sitehost-test; the process is similar for moving your production site.

If you use the WCMS

  1. Set up Transports for Sitehost:
    • A site manager should log into WCMS Manager Tools.
    • Expand the Transport setting for the site you wish to change.
    • Click the + (plus sign) to add a new Transport.
    • Add the following information for sitehost-test (replace username with the group account username):
      • Transport Name: A name for your Transport; for example, sitehost-test
      • Host Name: ssh.sitehost-test.iu.edu
      • Port: 22
      • ServerDirectory: /groups/username
      • Username: username
      • Password: Your group account password
      • Confirm Password: Your group account password
      • Use SFTP: Checked
      • Use PASV: Unchecked
    • Add the following information for sitehost production (replace username with the group account username):
      • Transport Name: A name for your Transport; for example, sitehost
      • Host Name: ssh.sitehost.iu.edu
      • Port: 22
      • ServerDirectory: /groups/username
      • Username: username
      • Password: Your group account password
      • Confirm Password: Your group account password
      • Use SFTP: Checked
      • Use PASV: Unchecked
  2. Set up destinations for Sitehost:
    • In the WCMS, click Manage Site, then Destinations, then +Add, and then Destination.
    • Enter the following information for sitehost-test:
      • Name: A name for your destination, for example, sitehost-test
      • Directory: web, or a subdirectory of /groups/username/web
      • Transport: The sitehost-test Transport you created earlier
      • Applicable Groups: Select the groups that can publish your site
      • Web URL: username.sitehost-test.iu.edu
    • Enter the following information for sitehost production:
      • Name: A name for your destination, for example, sitehost
      • Directory: web, or a subdirectory of /groups/username/web
      • Transport: The sitehost Transport you created earlier
      • Applicable Groups: Select the groups that can publish your site
      • Web URL: username.sitehost.iu.edu
  3. Update content types to allow publishing to the new destinations.

If you manage your files directly

  1. Connect to webservet with CyberDuck, WinSCP, or another file transfer program.
  2. Download the contents of your /www/ and /wwws/ directories to your local workstation, as well as any other files that you will need on the new servers (such as scripts in ~/bin, libraries, etc.).
  3. If you used both /www/ and /wwws/ on Webserve, consolidate your files in one directory.
  4. Rename the directory containing your web files to web.
  5. Connect to ssh.sitehost-test.iu.edu for sitehost-test and ssh.sitehost.iu.edu for sitehost production.
  6. Upload the contents of the web directory to sitehost-test or sitehost production, as well as any other files that your site needs.

Request the virtual host name

Note:

Your Sitehost account will automatically have a virtual host (accountname.sitehost.iu.edu). You only need to follow these steps if you have a custom virtual host name.

Requesting your virtual host name will not move your virtual host at this point. It will prepare the IU Sitehosting server and allow the steps in Test your site on Sitehost to work with your current site URL. Once you have confirmed your site is ready and performed the instructions in Final steps, your virtual host will be updated and moved to the IU Sitehosting servers.

  1. Select Overview:accountname for the account that will be the document root for the virtual host.
  2. Click View virtual hosts.
  3. Any virtual hosts associated with this account will be listed. Click Request a new Virtual host.
  4. Enter the following information (replace accountname with the name of the account):
    • Primary URL: The main host name that users will use to access your website
    • Alias(es): Any alternate host names associated with the website
    • Document root: The file location for your website; this must be /groups/accountname/web or a subdirectory
    • Contact Email: Usually the account owner, but can also be a technical contact
    • Technical Contact Email (Optional): An additional technical contact
    • Launch Date: Requests are normally fulfilled as soon as possible; if you need your site to go live on a specific date, enter it here.

Test your site on Sitehost

To test your site on the Sitehost production servers, do the following after you have published or uploaded your site to sitehost.iu.edu (this only works for virtual host names, not ~username URLs):

  1. In a web browser, go to:
    https://hostname/sitehostmigrationtest

    Replace hostname with the name of your site.

  2. You will see an intermediate page that says you are about to view your site on the Sitehost production servers. Click the link to proceed.

    You will see your site as rendered by the Sitehost servers. If your page has a title, "Testing - " will be prepended to it.

    Note:
    If your site does not have a default page (for example, index.html, index.php, or home.html), you may see an error page. If this happens, add the specific page you wish to preview to the URL.

Final steps

When you have finished the above steps, contact the Support Center Tier 2 Web Services Support team with the account names and site URLs that you migrated. Site migrations require a DNS change, which will take effect by 8am on the following business day after you receive confirmation of the request.

When the DNS changes take effect, Webserve administrators will work with you to remove the old Webserve accounts.

Related documents

This is document axoh in the Knowledge Base.
Last modified on 2019-08-16 11:14:29.

Contact us

For help or to comment, email the UITS Support Center.