How to Troubleshoot Magento 1 Installations

Overview

This article is for troubleshooting the installation of the extension for Magento 1. For Magento 2 please see the Magento 2 Installation Troubeshooting Guide. For incorrect shipping rates please see the Rate Discrepancies guide

Blank Page

Symptom

When navigating on the store a completely blank/white page is presented.

Solution

An error is being presented silently. Please see the Completely Blank Page guide. If enabled, please also ensure that you have refreshed the compiler.

Method Not Defined

Symptom

A message is displayed in the form:

Method “exampleMethod” is not defined in “/path/to/magento”…

Solution

This is caused by one or more files not being able to be read successfully. Please ensure that all files have been re-copied from the ZIP per the Installation Guide, the cache and compiler have been refreshed (if enabled) and that the permissions have been set correctly on the files.

Include file missing

Symptom

A message is displayed in the form:

Warning: include(…)

Solution

Please ensure that you have refreshed the Magento Compiler (if enabled).

Website Not in Environment Scope

Symptom

Then message “Website Not in Environment Scope” is presented in System > Configuration > Shipping Methods after saving the configuration

Solution

This is due to ShipperHQ and Magento looking at different scopes. You’ll want to ensure the scope in the top right of your ShipperHQ account matches the scope shown under ShipperHQ Configuration.

Set Scope in ShipperHQ

Invalid Credentials

Symptom

An error message denoting invalid credentials is displayed in System > Configuration > Shipping Methods after enabling ShipperHQ.

Solution

Please ensure that the API Key and Authentication code have been entered correctly from the Websites configuration section.

SQL Not Run Successfully

Symptom

An error is presented similar to:

SQLSTATE[42S02]: Base Table Or View Not Found

Solution

The SQL install scripts have not been run successfully. Please see the SQL Failed to Run article.

PHP 7 support

Version 2.195 of the extension adds support for PHP 7.2 for Magento 1. Please contact us if you require the latest version.