Getting Started With WP Squared

Overview

WP Squared is a new product from WebPros International, LLC that simplifies your experience with WordPress® and allows even the most novice user to easily create a website. This document will walk through system requirements, installing WP Squared, and setting up your first WordPress website.

System requirements

Before you begin to install WP Squared, verify that your server meets the hardware, license, and networking requirements.

Hardware requirements

Supported operating system and versionRAMDisk spaceArchitecture
AlmaLinux OS 8
  • Minimum: 2 GB
  • Recommended: 4 GB
  • Minimum: 20 GB
  • Recommended: 40 GB
64-bit
Note:
You must start the installation using AlmaLinux. The installation script will convert AlmaLinux to CloudLinux 8 Pro.

License requirements

Important:

You must have a valid WP Squared license to log in to WHM and use WP Squared.

Obtain a WP Squared license from your hosting provider.

Your license is tied to your IP address, so make sure that you provide a valid, public IP address to your hosting provider or Customer Service.

Networking requirements

Hostname

Your hostname must meet the following requirements:

  • Be a registered and fully-qualified domain name.
  • Does not match any of your server’s domains.
  • Be a maximum of 60 characters in length.
  • Resolve to a valid IPv4 or IPv6 address.
Note:
If your server does not use a resolvable fully-qualified domain name as the hostname, it will automatically receive one from WebPros International, LLC.

IP addresses

Your IP address must meet the following requirements:

  • Be a valid IP address.

  • Be a 1:1 NAT and NAT loopback configuration if your server resides in a NAT-configured network.

Ethernet device

You must configure your Ethernet device with a static IP address and a fully-qualified hostname. The system attempts to detect and set the Ethernet device during the installation process.

Warning:

You cannot use an IP address that a Dynamic Host Configuration Protocol (DHCP) service dynamically assigns to your server.

Firewalls

The installer will attempt to open the necessary ports during the installation process. We recommend that you disable operating system (OS) firewalls before you run the WP Squared installation.

Important:

AlmaLinux distributions allow you to disable the firewall for the operating system’s installation configuration. We strongly recommend that you use this method.

To deactivate the firewall on an AlmaLinux server, run the following commands, where ~/firewall.rules represents the firewall rules file:

iptables-save > ~/firewall.rules
systemctl stop firewalld.service
systemctl disable firewalld.service

Utilities

On AlmaLinux 8 systems, the WP Squared installer automatically disables the Network Manager service and enables the network.service service.

Disable SELinux

You must disable SELinux to make your system compatible with WP Squared.

To disable SELinux, use one of the following methods:

  • Use the graphical interface to disable SELinux while you configure your operating system, and then reboot the server.

  • Edit the /etc/selinux/config file to set the SELINUX parameter to disabled, and then reboot the server. The contents of the /etc/selinux/config file should resemble the following example:

# This file controls the state of SELinux on the system.
# SELINUX= can take one of these three values:
# enforcing - SELinux security policy is enforced.
# permissive - SELinux prints warnings instead of enforcing.
# disabled - No SELinux policy is loaded.
SELINUX=disabled
# SELINUXTYPE= can take one of these two values:
# targeted - Only targeted network daemons are protected.
# strict - Full SELinux protection.
SELINUXTYPE=targeted
Important:

Make certain that the number sign (#) does not precede SELINUX=disabled. If a # precedes this configuration option, the system ignores the option.

Warning:
  • To run WP Squared on your server, SELinux must remain disabled.
    • SELinux in enforcing mode does not allow WP Squared to function properly. For more information about SELinux modes, read the SELinux Mode documentation.
    • While WP Squared can function with SELinux in permissive mode, we recommend that you do not use it. The permissive mode generates a large number of log entries.
    • To check the status of SELinux on your server, run the sestatus command.
  • Do not transfer the SELinux configuration file between computers. It may destroy the file’s integrity.

Perl installation

Perl must exist on your server for WP Squared to successfully install. If Perl does not exist during installation, the WP Squared installer attempts to install Perl via the yum -y install perl command.

Note:

We strongly recommend that you allow your operating system’s distribution to control the system Perl installation. Do not customize this Perl installation.

Filesystems

When you install your operating system (OS), we recommend that you use the XFS® or ext4 filesystems.

Note:

We only develop and test WP Squared on filesystems that support flock. Some network filesystems (for example, NFS) may require additional configuration in order to function properly. However, these configurations are difficult to implement successfully and we do not support them.

Installation

To use WP Squared, you will need to install it on your server. If you have problems with installation, contact your hosting provider. To install WP Squared, run the following commands as the root user:

  yum install -y wget
  wget https://securedownloads.cpanel.net/latest-wp2
  bash latest-wp2
Note:

When using DigitalOcean’s AlmaLinux 8 image, run the following command before you install WP Squared:

rpm --import https://repo.almalinux.org/almalinux/RPM-GPG-KEY-AlmaLinux

The server will download and install the latest version of WP Squared. After installation, if your kernel has been updated, the server will automatically reboot to ensure that the correct kernel is running for WP Squared. After the reboot, additional components will install themselves. This generally takes around 30 minutes.

You should only log in to WP Squared when the installation process finishes.

Automatically-issued hostnames

First-time users who try to log in to WHM on newly installed servers will frequently see a security warning. Newly installed servers without a fully qualified domain name (FQDN) as a hostname will automatically receive one from WebPros International, LLC. The hostname will be a subdomain of wp2.host.

WP Squared attempts to secure your server immediately after installation by installing a self-signed certificate. Then, it requests a free hostname certificate from our Certificate Authority. If there is no resolvable FQDN set, the system cannot issue a certificate. To allow the certificate installation, we will automatically issue wp2.host hostnames to newly installed servers without a valid FQDN. We encourage you to replace the automatically-issued hostname with an existing or new domain. Using your own domain name and hostname will help establish your company’s brand.

Note:

You cannot manage the wp2.host subdomain or delegate the subdomain to any other server. We recommend you update your hostname to a domain you control as soon as possible.

Create a WP Squared account

  1. Log in to WHM as the root user. You can get the WHM URL by typing whmlogin in your terminal window. Copy and paste the URL provided in your browser.

  2. Navigate to the Create an Account interface and provide the needed information for creating a new account. Click Create once you have provided the required information.

  3. Click Go To WP Squared in the top right corner once you have created the account to immediately go into the WP Squared website setup. You can also click on the WP Squared icon (WP Squared icon) in WHM’s List Accounts interface to launch WP Squared.

The first time you launch WP Squared, the wizard will walk you through setting up your first website.

Virtual environments

WP Squared supports the following virtual environments with the following restrictions:

Virtual environmentRestrictions
KVMNo additional restrictions.
Note:

If you use a Linux bridge on a KVM server, you may experience problems with multicast routing. These problems affect the server’s ability to resolve nodes on the network. For example, IPv6 Stateless Address Auto-Configuration (SLAAC) addresses may drop off intermittently, or the server may experience problems when it attempts to find the router. To resolve this issue, set the multicast_router system knob value to 2. For more information, read the CentOS-virt mailing list thread.

Linux containersWP Squared requires additional configuration to run inside a Linux container.
Linux-VServerNo additional restrictions.
Microsoft Server® 2008 Hyper-V, Microsoft Server 2012 Hyper-VWP Squared only supports the drivers and configurations that Microsoft® provides.
OpenVZWP Squared only supports stable releases.
Oracle VM VirtualBox, VirtualBox OSENo additional restrictions.
QEMUNo additional restrictions.
SmartOSWP Squared detects this virtual environment and reports as functional, but we do not officially support it.
Virtuozzo™
  • We support Virtuozzo version 7 and earlier.
  • We only support Virtuozzo KVM and container environments.
VMware ESXi™ ServerNo additional restrictions.
Xen, XenEnterprise™, XenExpress™, XenServer™No additional restrictions.