Troubleshooting

Application Setup

Do not Call your Generated Application pageflow

It leads to conflicting constant names and prevents the generator and the app from running.

Solution: rails new pageflow_something and NOT rails new pageflow

Devise Migration without File Extension

Some versions of Devise seem to generate a migration without a file extension. When running migrate the file is ignored causing the following migrations to fail.

Solution: Add .rb extension to db/migrate/xxxx-devise_create_users file.

Install Generator Fails

If you get the error message "Pageflow has not yet been configured" while running the generator, make sure you are running in the development environment. When, for example, the RAILS_ENV environment variable is set to production, the generator will fail.

Image and Media Processing

Resque Worker cannot be Started

• Error connecting to Redis on localhost:6379 when running rake resque:work

  Solution: Make sure Redis server is running.

• rb_sys_fail_str(connect(2) for [fe80::1%lo0]:6379) when running rake resque:work

  As reported in redis/redis-rb#479 this error message is given on Max OS X Yosemite 10.10.1 with Ruby 2.1.0 when a Redis connection cannot be established.

  Solution: Make sure Redis server is running.

Error Message in Pageflow Editor during Image Upload Step

Check log/development.log to see the stack trace of the exception causing the request to fail.

• Errno::ECONNREFUSED in Pageflow::Editor::FilesController#create or hangs at [paperclip] saving ...

  Check that you have used a valid s3_host_name in Pageflow's paperclip_s3_default_options setting. In particular, ensure that you are not using an s3-website. endpoint. Those are only for serving files from the bucket via HTTP - not for API access. See the AWS list of regions and enpoints for possible values.

• Uploading large files fails without output in any Rails log.

  Make sure your web server does not restrict the allowed size of uploads too much (i.e. configure client_max_body_size for Nginx

Error Message in Pageflow Editor during Image Processing Step

Check log/jobs/development/resize.log to see why the job failed.

• Ensure that ImageMagick is installed.

• Restart your Resque workers if you have changed the Paperclip configuration.

• Ensure there are no unwanted Resque worker processes still running, that might pick up jobs and fail silently. Run ps aux | grep resque to find such processes.

Error Message in Pageflow Editor during Video Processing Step

Check log/jobs/development/default.log and log/jobs/development/resize.log to see why the job failed.

• Zencoder failure after 4k video input

  You need to opt-in for 4k video transcoding at Zencoder. 4k video is billed at 4 times the rate of other formats (current as of March 2017)

Server Side Rendering

Missing Precompiled Assets

Trying to display an entry results in an error message:

ActionView::Template::Error: No compiled asset for react-server.js, was it precompiled?

Solution: In config/initializers/assets.rb add the following line:

Rails.application.config.assets.precompile += %w(react-server.js components.js)

Browser Console Error Messages

Bandwidth Probe Images Cannot be Found

When viewing an entry, the browser console contains an error of the form:

GET http://com-example-pageflow-out.s3-website-eu-west-1.amazonaws.com/bandwidth_probe_small.png?1495014184536 404 (Not Found)

• Ensure the bandwidth probe files have been placed in the S3 bucket

• If the bucket name in the URL does not match your current configuration, recompile the assets. URLs are written to Javascript during asset precompilation. Therefore configuration changes do not take effect immediately.

Upgrading Pageflow

Missing Translations in Editor

Sometimes, after updating the pageflow gem or installing a new page type, missing translations appear inside the editor. This is caused by the i18n-js gem not picking up new translations. See the discussion in issue #100 for some background.

Solution: Remove the sprockets cache directory located at tmp/cache/assets/development/sprocket and restart your app.

Missing Assets/Asset Changes in Development

Sometimes in development environment, Sprockets does not pick up changes in asset files, even though the requires match. A quickfix is to change something in the root js within your app that uses the pageflow gem or directly within the gem. Then save, reload page, change back, and Sprockets should pick up changes.