1. Curator Styles

    2. Homepage

    3. Titles and Toolbars

    4. Group Overrides

    1. Pages Overview

    2. Tiles

    3. SSRS Embedding

    4. Explorer

    5. User Customized Metrics

    6. Error Pages

    1. Tutorials

    2. Search

    3. Managing Menus

    4. Menu Items

    5. Keywords

    6. Files

    7. Notices

    8. Loading Screens

    1. Embedded Tableau Server Views

    2. Thumbnails

    3. Tagged Workbooks

    4. Favorites

    5. Email Subscriptions

    6. Data Export

    7. Download Workbook

    8. Share Workbook

    9. Custom Views

    10. Pause/Resume Changes

    11. Dashboard Titles

    1. Filters

    2. Parameters

    3. Apply Button

    4. Filter Categories

    5. Hidden Sticky Filters/Parameters

    6. Specify Filter Sheet

    7. Mark Commenting

    8. URL Action Overrides (Link Target)

    9. Hidden Dashboards

    10. Replace Dashboard URLs

    11. Site Switcher

    12. Cache Filter/Parameter Options

    1. Data Manager Basics

    2. Web Data Connector (WDC)

    3. Connecting to Data Manager

    4. User Commenting

    5. Field Calculations

    1. Overview and Enabling

    2. Report Builder: Email Option

    3. Report Builder: Watermark Text

    4. Report Builder: Scheduled Reports Option

    1. Automatic License Provisioning

    2. Just-in-time (JIT) Provisioning

    3. Users and Groups

    4. Reset User's Password

    5. User Sync and Membership Sync Overview

    6. Custom Attributes

    1. Frontend User Permissions

    2. Password Change

    3. Password Reset

    4. Password Expiration and Complexity

    5. Bypass Link-preview Security

    1. E-mail Configuration

    2. System Notifications

    1. Force SSL

    2. Trusted Tickets

    3. Basic HTTP Authentication

    1. Import / Export

    2. Backend Users

    3. Frontend Users

    4. Updating License Key

    5. Linux: Cron Troubleshooting

    6. Filesystem Permissions

    7. Backend Administrator Password Reset

    8. Dependency Updates

    9. Updating Curator Logging

    10. Third Party Cookies

    11. Troubleshooting Load Times

    12. Manual Restoration of Curator Backup

    13. Curator Backup

    14. Taking a Manual Full Backup

    1. System Upgrade

    2. Disable Curator Upgrades

    3. Offline Upgrades (Airgapped)

    4. Troubleshooting Upgrades

    1. Scripts

    2. Commands

    3. Subscription Routing

    1. Curator API Overview

    2. Integration

    3. Curator API

    4. Tableau API

    5. Content

    6. User API

    1. Username Mapping

Documentation: Upgrading

Troubleshooting Upgrades

You may run into issues during the upgrade process, but we've provided some common scenarios and how to quickly resolve them below.
NOTE: It is always a good idea to have someone on standby during your upgrade who has access to the web-server that Curator is running on, as most of these solutions require web-server access.

Re-run the upgrade with an alternate method

If you find an upgrade related error in your event logs, there may be an issue with running the upgrade using the "one click" upgrade. Try upgrading via the API key, or the manual upgrade using the steps in our System Upgrade guide.

Updating the Curator Database (Running Migrations)

Curator's database is often modified during the upgrade process, and in many cases this can cause errors that read "column not found". If you run into this issue, re-running Curators upgrade migration can resolve these errors. To re-run the Curator database migration from your browser

  1. Visit your Curator url in a web browser, but add /up to your URL, for example: https://www.site.com/up
  2. You should receive a white background with black text that says "success", if you do not, try running the migration directly on the web server using the steps below.

To re-run the Curator database migration from the web server

  1. Open a command prompt/terminal
  2. Double-check you are running the terminal/command prompt as the same user that is running curator (you can find this information on the backend of Curator under Settings > Curator > Status)
  3. cd into your webroot directory (e.g. /var/www/html on Linux or C:\InterWorks\Curator\htdocs on Windows)
  4. type the following command php artisan winter:up, then press ENTER
  5. Any remaining migrations will run, and display status messages in green
  6. If there are any errors, please screenshot and send to Curator support.

File system permissions fixes

You may see a warning relating to filesystem permissions on your Curator site, or the site itself may be rendering an error that says "failed to cache..." or "permission denied...", or "no such file found...".

  1. Click the "clear cache" button on the backend of Curator
  2. Use our Filesystem Permissions guide to fix any errant file permissions settings.

Fix Corrupted Files

You may see an error message stating "vendor files are missing", or some pages may throw a warning message that some files were not able to be found. In this case, you can re-download the file system to your web server

Fixing Corrupted File Systems on Linux:

  1. cd into your webroot directory (e.g. /var/www/html)
  2. Run the commands below, replacing the [curator_key] in the URL with your Curator license key:

    wget -O latest.zip "https://api.curator.interworks.com/get_version.php?key=[curator_key]&kernel=1.1.7-03&version=latest" 
    unzip latest.zip  
    rm -Rf plugins/interworks; cp core/. . -Rf 

    NOTE: You may replace latest in the URL above with a specific version

  3. Visit your Curator site in a web browser to confirm your site is back up and running
  4. After this, ensure you re-run the migration using the steps in the "Updating Curator Database" section above.

Fixing Corrupted File Systems on Windows:

  1. From a web-browser visit the URL below to download a .zip file with your Curator filesystem, replacing the [curator_key] in the URL with your Curator license key:
  2. Make a backup of your webroot in case of any errors that occur in the steps below
  3. Unzip the file that was downloaded from step 1 into your webroot (e.g. C:\InterWorks\Curator\htdocs) and replace all files with the newly extracted files.
  4. After this, ensure you re-run the migration using the steps in the "Updating Curator Database" section above.

Event Log Troubleshooting

Troubles with Upgrade?

  1. Login to the backend of your Curator instance (e.g. https://www.site.com/backend).
  2. Navigate to the Settings > Logs > Event Log section from the left-hand menu.
  3. Look to see if there are any "upgrade" related errors.
  4. Reach out to support for further troubleshooting.