Search Engine: Elastic

Article ID: 132851, created on Jun 29, 2018, last review on Apr 25, 2019

  • Applies to:
  • Operations Automation

Introduction

The Linux Shared Hosting module is discontinued and will no longer be available for installation starting from OA premium 8.0. Providers willing to offer Linux-based hosting services should migrate their customers from Linux Shared Hosting to WebHosting Linux by means of the Migration Manager tool, and then clean up Odin Automation by using the clean-up-lsh-module cleanup tool. Otherwise, they will not be able to upgrade to OA Premium 8.0 or later.

This article explains how to remove the Linux Shared Hosting module and all related data from Odin Automation.

Supported configurations

Odin Automation 7.4 with the Linux Shared Hosting module.

What happens during cleanup

The cleanup tool does the following:

  1. Deactivates all service templates related to the Linux Shared Hosting module to make it impossible to buy and provision new Linux Shared Hosting subscriptions from CCPv1 and CCPv2.
  2. (Optional) Synchronizes all online stores so as to unpublish the service plans that are based on the deactivated service templates. You should do this to prevent users from purchasing Linux Shared Hosting subscriptions in online stores.
  3. Removes all packages related to the Linux Shared Hosting module from service nodes.
  4. Removes all packages related to the Linux Shared Hosting module from the internal repository on the management node.

Installing the cleanup tool

To install the clean-up-lsh-module tool:

  1. Download the package by using this link.
  2. Log in to the management node over SSH as a user with root credentials.
  3. Upload the downloaded archive to the Odin Automation management node.
  4. Extract the contents of the archive by issuing the following command:

    tar xvzf clean-up-hosting-module.tar.gz
    

Preparing for cleanup

To remove the Linux Shared Hosting module from your installation of Odin Automation, you need to remove or migrate all websites and webspaces from the service nodes related to the Linux Shared Hosting module. The cleanup tool does not do anything to customer or reseller subscriptions. You must process them on your own.

If you want customers' websites to continue to operate after you remove the module and upgrade Odin Automation to a later version, you must migrate users' subscriptions by following this guide.

Or you can remove ("destroy" in Billing terms) the subscriptions that are no longer needed by following this guide.

During the creation of new reseller accounts associated with the Linux Shared Hosting module, the system may create webspaces for resellers on one of Linux Shared Hosting nodes. To proceed with the cleanup, you must subscribe resellers to other service plans that do not contain Linux Shared Hosting resources. The following is an overview of the steps that you need to perform:

  1. In the Provider Panel of Odin Automation, create a service template by following these instructions.
  2. In Billing, create a reseller service template.
  3. In Billing, create a service plan based on the reseller template.
  4. In Billing, locate the service plan to which the reseller is currently subscribed, and add the service plan that you created in step 3 to the list of plans available for upgrade.
  5. In Billing, locate the reseller's subscription, click Switch Plan, and select the plan that you created in step 3.
  6. In Billing, process the order related to the plan change.

Removing Linux Shared Hosting resources from customers' subscriptions

If there are subscriptions that include resources related to Linux Shared Hosting and other resources (for example, DNS resources), such subscriptions cannot be deleted as they may be used by other services. In such a case, to continue with the cleanup process, you need to do either of the following:

  1. Switch all subscriptions with resources related to Linux Shared Hosting to another service plan.
  2. Remove resources related to Linux Shared Hosting.

To remove resources related to Linux Shared Hosting from subscriptions, do the following:

  1. Set limits on those resources to 0 in all subscriptions.
  2. Remove resources related to Linux Shared Hosting from all service templates.
  3. Synchronize subscriptions with Linux Shared Hosting resources with service plans.

Removing Linux Shared Hosting resources from resellers' subscriptions

If there are Linux Shared Hosting resources in a reseller subscription, do the following:
Step 1. Perform any of the following:

  • Migrate the customers' subscriptions under that reseller to WebHosting Linux. After that, remove Linux Shared Hosting subscriptions or switch them to another service plan that does not include Linux Shared Hosting resources.
  • Switch the customers' subscriptions under that reseller to another service plan that does not include Linux Shared Hosting resources.
  • Remove the subscriptions if they are no longer needed.

Step 2. Log in to the Reseller Panel on behalf of that reseller, and remove all Linux Shared Hosting resources from service templates.

Step 3. Log in to the Provider Panel and switch the reseller's subscription to another plan that does not include Linux Shared Hosting resources.

Performing the cleanup

You can clean up your installation of Odin Automation by subsequently running the following commands:

  1. deactivate-service-templates
  2. synchronize-online-stores
  3. remove-packages-from-service-nodes
  4. remove-packages-from-repository

If you want to ensure that all of the cleanup steps can be carried out successfully, you can run each of these commands with the –check-only key. It performs all checks without making any changes to your Odin Automation installation.

To view the help page for the cleanup tool, run the tool without any arguments or run it with the --help (-h) option.

Note: You must run the cleanup tool on the management node as root.

Step 1. Deactivating service templates

You need to deactivate all service templates related to the Linux Shared Hosting module to make it impossible to buy and provision new Linux Shared Hosting subscriptions from CCPv1 and CCPv2 (also referred to as UX1). After deactivating a service template, all service plans based on it become no longer available for purchasing in CCPv1 and CCPv2. To remove these plans from online stores, you must synchronize the online stores.

To deactivate the service templates related to Linux Shared Hosting, run the script as follows:

# ./clean-up-lsh-module.py [--check-only] deactivate-service-templates

Where:

[--check-only] is an optional parameter that performs all checks without making any changes to the Odin Automation installation.

Step 2. Synchronizing online stores

This is an optional step, but we highly recommend performing it. You should unpublish the service plans that are based on the deactivated service templates to make it impossible to buy and provision new Linux Shared Hosting subscriptions from online stores. Note that during the synchronization, all other settings, even those that are not related to service plans, will be synchronized as well. If you do not want to synchronize some of the online stores at this moment, synchronize online stores manually.

To synchronize all online stores, run the script as follows:

# ./clean-up-lsh-module.py [--check-only] synchronize-online-stores

Where:

[--check-only] is an optional parameter that performs all checks without making any changes to the Odin Automation installation.

Step 3. Removing packages from service nodes

This step removes all packages related to the Linux Shared Hosting module from service nodes. Any user data related to these modules are not removed.

To remove all packages related to the Linux Shared Hosting module from service nodes, run the script as follows:

# ./clean-up-lsh-module.py [--check-only] remove-packages-from-service-nodes

Where:

[--check-only] is an optional parameter that performs all checks without making any changes to the Odin Automation installation.

Step 4. Removing packages from the internal repository

To remove all packages related to the Linux Shared Hosting module from the internal repository on the management node, run the script as follows:

# ./clean-up-lsh-module.py [--check-only] remove-packages-from-repository

Where:

[--check-only] is an optional parameter that performs all checks without making any changes to the Odin Automation installation.

The outcome

After all cleanup steps are performed, it will be possible to upgrade Odin Automation to OA Premium 8.0. All items related to the Linux Shared Hosting module will be removed from Odin Automation.

5356b422f65bdad1c3e9edca5d74a1ae 8fc71f07abe5b233fea1ae0377cd5e3d

Email subscription for changes to this article
Save as PDF