Stratus Specific Guides on Webscale Product Documentation

Stratus Guides - Deploying

Mon, 01 Jan 0001 00:00:00 +0000

Despite the incredible sophistication of the Webscale STRATUS cloud platform, Webscale STRATUS deployments are fairly straightforward and familiar.

Pre-checks:

Make sure that all symlinks are using absolute paths.
Note that CloudFront may take up to 15 minutes to clear.

Deployment Examples

To deploy code to Webscale STRATUS, use SSH and push the code, move symlinks, and flush caches. The built-in CLI commands provided in the Webscale STRATUS Control panel can also be used to assist.

Stratus Guides - Zero Downtime Deployment

Mon, 01 Jan 0001 00:00:00 +0000

Autoscaling must be enabled to use Zero Downtime Deployment (ZDD). Learn more about Autoscaling .

How it works

ZDD consists of two Webscale STRATUS CLI commands, the zerodowntime.init command followed by the zerodowntime.switch command.

Prior to running any of the commands, you should enable Autoscaling and the Zero Downtime Deploy option on the Autoscaling page in the Webscale STRATUS panel. Enabling ZDD may take up to a minute of downtime.

With autoscaling enabled, you can now perform zero downtime deploys. An example flow:

Stratus Guides - Going Live

Mon, 01 Jan 0001 00:00:00 +0000

Each store is unique and may require slight variations from the sequence shown. Developers may contact Stratus support for assistance. Webscale Stratus provides free migration to a new STRATUS environment. Please consult how migrations work .

The following is a typical, example launch sequence on a Webscale STRATUS environment based on a an existing application that is migrated to STRATUS.

Prepare the Webscale STRATUS Environment

Before any go-live, test a copy of the store for all functionality.

Stratus Guides - STRATUS CLI

Mon, 01 Jan 0001 00:00:00 +0000

The following commands are accessible via SSH access. See the SSH > Info Webscale STRATUS Control panel for access parameters.

Help

Run /usr/share/stratus/cli help for a list of viewable commands with descriptions.

Command Format

CLI commands are entered as /usr/share/stratus/cli <command>. For example, to use the command database.config run /usr/share/stratus/cli database.config

Common Commands

`autoscaling.reinit`

If autoscaling is enabled, this command will issue a redeploy of PHP-FPM services and update the code copied out to the various physical nodes. This is a rolling redeployment for zero environment downtime and minimal site downtime. The command executes asynchronously and will return before all the redeployment is completed. It is for legacy deploys only. This command should not be used if you are using Zero-Downtime Deployment

Stratus Guides - Default Cron Configurations

Mon, 01 Jan 0001 00:00:00 +0000

Use the following as a guide for configuring production environments in the Webscale STRATUS Cron > Schedule panel.

Magento 1

Magento 1 requires cron.sh to run every minute to update and execute it’s internal schedule. On a default Webscale STRATUS environment that configuration would be:

To configure the cron using crontab via shell access, enter:

* * * * * /bin/bash /srv/public_html/cron.sh >> /srv/public_html/var/log/cron.log 2>&1

Magento 2

Magento 2.x requires three cron tasks. By default, these are already configured on every new Webscale STRATUS environment. If the document or web roots are changed, the tasks will need updated to show the correct file paths.

Stratus Guides - New Relic

Mon, 01 Jan 0001 00:00:00 +0000

When purchasing or obtaining a New Relic license, please choose the option “Self-Hosted Environment.” Stratus currently supports New Relic APM only. (NRAL KEYS) Once a license key is received, open a support ticket to have the key added to the Webscale STRATUS environment.

Adding your own license will populate trace data for any transactions over 2 seconds to your New Relic account, so you may need to wait 24 hours after adding the license to analyze any findings.

Stratus Guides - Cloudflare DNS Setup

Mon, 01 Jan 0001 00:00:00 +0000

NOTE: when using Cloudflare for DNS, Webscale cannot assign or install a Let’s Encrypt certificate; LE certficates can only be installed when using the Webscale Route 53 nameservers. Furthermore, certificates issued and signed by Cloudflare cannot be installed on Webscale STRATUS. Certificates must be issued by a publicly trusted Certificate Authority (CA), such as ACM or those listed by the Mozilla Foundation . For more information, see “Continually Enhancing Domain Security on Amazon CloudFront” .

Stratus Guides - AngularJS

Mon, 01 Jan 0001 00:00:00 +0000

server.ts

Locate the server.ts file at the root of AngularJS deployment and edit it to use port 10000. We need port 10000 for anything hosted under the nodejs container.

The block that needs to be modified looks like this. You can comment the default line and simply hard code it.

function run() {
 //const port = process.env.PORT || 4000;
 const port = 10000;

 // Start up the Node server
 const server = app();
 server.listen(port, () => {
 console.log(`Node Express server listening on http://localhost:${port}`);
 });
}

After this is done we need to compile. Please run:

Stratus Guides - Install IonCube Loader

Mon, 01 Jan 0001 00:00:00 +0000

Note: ionCube Loader for PHP 8 installation at the server with Webscale Stratus had not been tested, and we cannot guarantee its stability.

To Install IonCube Loader in your Stratus environment, follow these steps:

cd /srv/
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
tar -xvf ioncube_loaders_lin_x86-64.tar.gz

 mkdir php_conf
 cp -a /usr/local/etc/php/conf.d/* php_conf
 cd php_conf/
 rm zzz_custom.ini
 ln -s /usr/local/etc/php/conf.d/zzz_custom.ini ./
 cp /usr/local/etc/php/php.ini ./

While still in php_conf dir, create a file named 00_ioncube.ini with the following content:

Stratus Guides - Using Varnish

Mon, 01 Jan 0001 00:00:00 +0000

Enable Varnish for Magento 2

To enable Varnish on your store, follow these steps:

Log into your Magento 2 admin panel.
Connect to your store admin panel and go to Stores → Settings → Configuration → Advanced → System → Full Page Cache
In the FPC section, configure it as in the screenshot below
Save the configuration
Now log into your STRATUS Store Panel
Go to the Varnish area from the left-hand navigation menu, click to expand and select the Info section.
Click Enable to start the Varnish service. (Note: this will redeploy all services)
Varnish is now enabled!

Enable Varnish with Turpentine

If you are using Magento 1 and Turpentine, the configuration for Turpentine should use:

Stratus Guides - Install Sourceguardian

Mon, 01 Jan 0001 00:00:00 +0000

Installation

To Install SourceGuardian Loader in your Stratus environment, follow these steps:

cd /srv/
Create a folder: mkdir sourceguardian
Get linux x64 loader using the following command: curl 'https://www.sourceguardian.com/loaders/download/loaders.linux-x86_64.tar.gz' -H 'authority: www.sourceguardian.com' -H 'accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9' -H 'accept-language: en-GB,en-US;q=0.9,en;q=0.8,hr;q=0.7' -H 'cache-control: no-cache' -H 'cookie: RGTR=40811663063942; SiteSession1=1csd7upu9i6s3jvuss3v3ueuf7' -H 'pragma: no-cache' -H 'referer: https://www.google.com/' -H 'sec-ch-ua: ""' -H 'sec-ch-ua-mobile: ?0' -H 'sec-ch-ua-platform: ""' -H 'sec-fetch-dest: document' -H 'sec-fetch-mode: navigate' -H 'sec-fetch-site: cross-site' -H 'sec-fetch-user: ?1' -H 'upgrade-insecure-requests: 1' -H 'user-agent: Chrome' --output /srv/sourceguardian/loaders.linux-x86_64.tar.gz

Stratus Guides - Using SupervisorD

Mon, 01 Jan 0001 00:00:00 +0000

Supervisor is a client/server system that allows its users to control a number of processes like Magento consumers. Note: this is only possible on PHP 7.4 and above.

Installation

Versions of Python available in your environment will depend on which PHP version you are using. You can see which version is currently running on your system by running python --version Note that installing SupervisorD is only possible on PHP 7.4 and above.

Stratus Guides - Install MailHog

Mon, 01 Jan 0001 00:00:00 +0000

In the SSH container, navigate to ~/bin directory and execute the following command:

wget -c https://go.dev/dl/go1.19.5.linux-amd64.tar.gz

Extract archive:

tar -xvf go1.19.5.linux-amd64.tar.gz

Export PATH:

export PATH=$PATH:/srv/bin/go/bin

Navigate to /srv/pwa directory and execute:

go install github.com/mailhog/MailHog@latest

Adjust start.sh file in the /srv/pwa directory or create it fresh with the following details:

#!/bin/bash
export PATH=$PATH:/srv/bin/go/bin
/srv/go/bin/MailHog -ui-web-path /mailhog -smtp-bind-addr 0.0.0.0:10000

Note: If you are already running some NodeJS application, adjust the export path accordingly as an add-on to the current NVM settings.