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 version | RAM | Disk space | Architecture |
---|---|---|---|
AlmaLinux OS 8 |
|
| 64-bit |
License requirements
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.
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.
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.
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 theSELINUX
parameter todisabled
, 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
Make certain that the number sign (#
) does not precede SELINUX=disabled
. If a #
precedes this configuration option, the system ignores the option.
- 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. Thepermissive
mode generates a large number of log entries. - To check the status of SELinux on your server, run the
sestatus
command.
- SELinux in
- 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.
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.
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
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.
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
Log in to WHM as the
root
user. You can get the WHM URL by typingwhmlogin
in your terminal window. Copy and paste the URL provided in your browser.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.
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 (
) 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 environment | Restrictions |
---|---|
KVM | No 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 |
Linux containers | WP Squared requires additional configuration to run inside a Linux container. |
Linux-VServer | No additional restrictions. |
Microsoft Server® 2008 Hyper-V, Microsoft Server 2012 Hyper-V | WP Squared only supports the drivers and configurations that Microsoft® provides. |
OpenVZ | WP Squared only supports stable releases. |
Oracle VM VirtualBox, VirtualBox OSE | No additional restrictions. |
QEMU | No additional restrictions. |
SmartOS | WP Squared detects this virtual environment and reports as functional, but we do not officially support it. |
Virtuozzo™ |
|
VMware ESXi™ Server | No additional restrictions. |
Xen, XenEnterprise™, XenExpress™, XenServer™ | No additional restrictions. |