Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update readme with GAP migration troubleshooting guide #234

Merged
merged 3 commits into from
Feb 5, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@ AEMC is a versatile tool for managing Adobe Experience Manager (AEM) instances.
* [Replication agents](#replication-agents)
* [SSL by Default](#ssl-by-default)
* [Global Trust Store](#global-trust-store)
* [Troubleshooting](#troubleshooting)
* [Contributing](#contributing)
* [Authors](#authors)
* [License](#license)
Expand Down Expand Up @@ -659,6 +660,25 @@ Command `certificate add` supports certificates in PEM and DER formats.
sh aemw gts certificate remove --alias <alias> -A
```


# Troubleshooting

## Migration from Gradle plugins

If you're migrating from [Gradle AEM Plugin](https://github.com/wttech/gradle-aem-plugin) you may run into issue with setting up dispatcher.
In case of error when running task dispatcher:start or dispatcher:setup:

```
2024-01-22 16:37:23 dispatcher | 2024/01/22 15:37:23 Dispatcher configuration validation failed:
2024-01-22 16:37:23 dispatcher | 2024/01/22 15:37:23 /mnt/dev/src/conf.d/variables/default.vars: lstat /etc/httpd.extra: no such file or directory
2024-01-22 16:37:23 dispatcher |
2024-01-22 16:37:23 dispatcher | ERROR Mon Jan 22 15:37:23 UTC 2024 Configuration invalid, please fix and retry,
2024-01-22 16:37:23 dispatcher | Line numbers reported are correct for your configuration files.
```

Check if there is a broken symlink/file in `dispatcher/src/variables/default.vars`. If the file exists, delete it and
run the task again.

# Contributing

Issues reported or pull requests created will be very appreciated.
Expand Down
Loading