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

You see a complete blank/white page when navigating on the store.

Solution

This indicates a silent error. Please see the Completely Blank Page guide. If enabled, please also ensure that you have refreshed the compiler.

Method Not Defined

Symptom

You see a message in the form:

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

Solution

Issues successfully reading one or more files cause this message. First, ensure that all files have been re-copied from the ZIP per the Installation Guide, the cache and compiler have been refreshed (if enabled). Then, check that the permissions are set correctly on the files.

Include file missing

Symptom

You see a message 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.

Location to double check the scope under ShipperHQ Configuration.

Location to view current scope on ShipperHQ dashboard.

Invalid Credentials

Symptom

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

Solution

To address this issue, ensure that the API Key and Authentication code from the Websites configuration section have been entered correctly.

SQL Not Run Successfully

Symptom

You’re seeing an error in the form:

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

Solution

SQL install scripts have failed to 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.

Was this doc helpful?