Updating modpagespeed.com and ngxpagespeed.com

Updating modpagespeed.com and ngxpagespeed.com

Currently only team members at Google have logins on these servers, so if you're outside Google you'll need to ask someone else to make the change for you.

modpagespeed.com and ngxpagespeed.com are served by VPSes on GCE, and run mod_pagespeed and ngx_pagespeed respectively to demonstrate their functionality. Additionally, modpagespeed.com serves the mod_pagespeed, ngx_pagespeed, and psol documentation.

Getting credentials

We use a single shared login for each server. The usernames and passwords are in Google's internal password storage tool; search for modpagespeed or ngxpagespeed.

Deploying user-facing doc changes.

When making a change to the user facing docs, which are in mod_pagespeed/doc and served under modpagespeed.com/doc/, do:

ssh [email protected]
cd doc/mod_pagespeed
git pull

When doing a release

When we do a new release cut from master, like 1.12.34.1, we update both servers with an updated set of examples pages, we update the psol/ documentation on modpagespeed.com, and we copy the mod_pagespeed binaries to modpagespeed.com

modpagespeed.com

You should have, from earlier in the release process:

• The packages for the release.
• mod_pagespeed_examples.tar.gz
• psol_doc.tar.gz

modpagespeed.com/mod_pagespeed_example/

# Set the RELEASE environment variable:
export RELEASE=1.2.24.1

# Copy the packages so users can download them later (when it's been superseded):
sudo mkdir /var/www/html/release_archive/$RELEASE
sudo mv ~/mod-pagespeed-*${RELEASE}* /var/www/html/release_archive/$RELEASE/
sudo chmod 444 /var/www/html/release_archive/$RELEASE/*

# Install the new module:
sudo apt-get update
sudo apt-get upgrade   # ensure it updates to the correct version!
sudo service apache2 restart

# Copy the new examples over:
sudo /var/www/scripts/install_examples.sh $RELEASE

Verify that your new version is visible on the internet, by browing to http://modpagespeed.com/. Check for some new feature.

modpagespeed.com/psol

Install the PSOL documentation you scp'd to modpagepseed.com earlier:

sudo mv ~/psol_doc.tar.gz /var/www/html/release_archive/$RELEASE/
sudo mkdir  /var/www/html/psol-$RELEASE
sudo tar -C /var/www/html/psol-$RELEASE -xzf /var/www/html/release_archive/$RELEASE/psol_doc.tar.gz
sudo chmod -R ugo+r /var/www/html/psol-$RELEASE
sudo chmod -R ugo-w /var/www/html/psol-$RELEASE
sudo find /var/www/html/psol-$RELEASE -type d -exec chmod +x {} \;
sudo rm -f  /var/www/html/psol
sudo ln -s  psol-$RELEASE/html /var/www/html/psol

Verify that your new version is visible on the internet, by browing to http://modpagespeed.com/psol/. Check the version at the top.

If you update /etc/httpd/conf.d/pagespeed.conf for any reason, make sure that modpagespeed.com has gzip enabled by adding this stanza:

SetOutputFilter DEFLATE
SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip

ngxpagespeed.com

Update examples

From an open-source checkout of the release branch, run install/prepare_ngx_pagespeed_examples.sh and follow the instructions to update ngxpagespeed.com:

$ cd install/
$ ./prepare_ngx_pagespeed_examples.sh
Building ngx_pagespeed_example.tar.gz ...
 ... built
Now scp it up to ngxpagespeed.com, and run:
  tar -xzf ngx_pagespeed_example.tar.gz
  sudo rm -rf /usr/local/nginx/html
  sudo mv ngx_pagespeed_example /usr/local/nginx/html
  sudo chmod ugo+rwX -R /usr/local/nginx/html

Update nginx

Run the automated installation for ngx_pagespeed:

bash <(curl -f -L -sS https://ngxpagespeed.com/install) \
  --nginx-version latest \
  --ngx-pagespeed-version YOUR-BETA-RELEASE
  --additional-nginx-configure-arguments '--with-http_ssl_module'

Then if that succeeds run:

sudo service nginx restart