logoBack to home screen

Docs tagged "Troubleshooting"

Contained topics: Resetting Admin Password, Reporting Issues to ADx Support Team, Exporting and Importing Repository Contents, Using Backup and Restore Scripts, Conversion Area, Introduction, ...

25 files


Resetting Admin Password

If you forgot the password of your admin user and cannot log in to ADx or Conversion, follow the procedure below to reset the password. Note that you cannot simply edit the installation file and reinstall when the password is already persisted in the database....
Troubleshooting

Reporting Issues to ADx Support Team

If you need to raise an issue in ADx, please follow these guidelines so that we can identify your problem and fix it as quickly and efficiently as possible. Please use only Braintribe's JIRA Board to report a problem or a question. This way you can be sure that your concern can be handled as quickly as possible....
Troubleshooting

Exporting and Importing Repository Contents

This page explains export and import repository contents. Content export and import is based on JSON metadata files, created either on upload or after running the bulk export service - depending on your repository settings and preferences....
Troubleshooting

Using Backup and Restore Scripts

ADx and Conversion packages contain the create-backup and restore-backup scripts. As a best practice, we recommend to use those scripts to back up your current installation before installing a new version. In case of errors in the new version, you can quickly restore the working runtime from a backup package. Update procedure is the same for ADx and Conversion....
Troubleshooting

Conversion Area

This area, available from the landing page, provides a number of filters allowing you to find conversion jobs and browse conversion statistics from the current session. It's used internally by ADx and not meant for end users, but you can still use it to test internal conversion functionality....
Troubleshooting

Introduction

Use the contents of this section to perform operations on ADx REST APIs and solve problems. Currently, the following pages are available:...
Troubleshooting

Conversion API

This API contains a set of endpoints used by ADx client to run conversion jobs. These endpoints are not accessible from within ADx itself and they are not relevant (at least not directly) to ADx user. They could be used, for example, to test the internal Conversion functionality. Do not confuse these with ADx repository endpoints used to start a conversion job....
Troubleshooting

Backup Strategies in ADx

This page explains the backup strategies for ADx installations....
Troubleshooting

Migrating from Legacy ADx to ADx 2.0 and Newer

See the pages below for information necessary to migrate repository configuration and contents, and how to use legacy REST endpoints in ADx 2.0 or newer:...
Troubleshooting

Database Connection fails on Default Repository

If you see this error in your health check report, do the following:Verify that your database is running....
Troubleshooting

Reindexing Contents in ADx

...
Troubleshooting

Exporting and Importing Repository Configuration via ADx UI

ADx provides the possibility to export and import repository configuration. Repositories and users are exported as JSON assembly files in a ...
Troubleshooting

Migrating Contents from Legacy ADx Installations

This document explains how to migrate repository content from legacy ADx installations....
Troubleshooting

Setting Conversion Restrictions on Repository

This page explains how to set limits on conversion job input files on both conversion and repository level, and provides information on how to track failed conversions caused by exceeded restriction limits....
Troubleshooting

Running Deep Health Checks on Legacy Endpoints

In ADx 2.0, it's still possible to use endpoints from older versions (even though they are not exposed in Swagger). To make sure these endpoints are operational after installation, you can run a legacy deep health check, as explained in this document....
Troubleshooting

Updating Repository Configuration

This page explains how to update your repository configuration based on a package received from Braintribe. Updating the repository configuration allows you to adapt it to custom needs (for example by customizing the WebReader design or attaching logic to a repository which extends normal repository features)....
Troubleshooting

Sessions Ending on Shared ADx/Conversion Host

Session cookies are domain-bound in ADx and Conversion installations. As a result, when Conversion and ADx are running on the same host, it's impossible to log in to both nodes at the same time. Consider the following situation:...
Troubleshooting

ADx/Conversion is suddenly shutting down

In case ADx or Conversion is suddenly shutting down it is most of the time an out of memory issue....
Troubleshooting

Introduction

Browse the pages available in this section to troubleshoot problems with your ADx installation. Currently, the following pages are available:...
Troubleshooting

Starting and Stopping ADx and Conversion

This page explains how to start and stop ADx and Conversion. The procedure is the same for both services....
Troubleshooting

Running ADx, Conversion and Platform Health Checks via REST API

This document explains how to run health checks on a running ADx and Conversion instances and how to check the status of the host itself....
Troubleshooting

Migrating Configuration from Legacy ADx Installations

This page explains how to migrate configuration data (repositories, users, groups, and roles) from ADx 1.1 installations....
Troubleshooting

Migrating Applications from ADx 1.1

If you have applications that use the legacy ADx REST APIs and you need to migrate to the up-to-date APIs, here are tables that help you find the APIs you need....
Troubleshooting

Problem Starting up ADx/Conversion

If you're not able to access tribefire services on Conversion node or the landing page on ADx node, check the logs for the following items:...
Troubleshooting

Shutdown Aborted - Missing CATALINA_PID

This page explains what to do when you run into the following error when attempting to shut down ADx or Conversion:...
Troubleshooting