Versions Compared

Old Version 2

changes.mady.by.user Kirstin Seidel-Gebert

Saved on

compared with

New Version 3

changes.mady.by.user Kirstin Seidel-Gebert

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WINSTALLATION and version 1.0.2_api
Table Filter
hideControlstrue
inverse,
sparkNameSparkline
columnProblem
separatorPoint (.)
labels‚
default,
cell-width,
datepatterndd M yy
globalFiltertrue
id1549611605376_1875416194
worklog5|8|w d h m|w d h m
isORAND
order0,1

...

ProblemPossible ReasonSolution

Cannot run docker-compose on gateway container:
Docker-compose throws NoSuchFileException for e.g. jks files during build.

You are using Docker for Windows and you have changed your Windows password recently.

There is an mounting issue using Docker for Windows.

You can try this workaround:

  1. Open Docker settings.
  2. Click on the Shared Drives tab.
  3. Deselect your shared drives.
    Click  Apply.
  4. Select the drives you want to share.
    Click  Apply.
    Docker should prompt you to re-enter your credentials.
  5. Rerun docker-compose.
  • API Management will not start.
  • Docker deamon does not respond anymore.

The assigned resources for Docker for Windows or for the Docker Toolbox are not enough for API Management.

  1. Open your Docker Settings from windows context menu.
  2. Navigate to tab "Advanced".

  3. Increase the memory to at least 8192 MB:

    Image Modified

You cannot login to API Management.

  • You have configured localhost for variable ENDPOINT in your .env file.
  • One or more docker container can't resolve you hostname
  • You cannot use localhost as endpoint. Please configure your full hostname e.g. api.acme-corp.com.
  • Your hostname must resolve to the IP of your server.
    localhost or 127.0.0.1 will not work, because this will resolve to localhost of your container.

  • Check if you have correctly configured your etc/hosts file on Windows or Linux. You can try this using the ping command.

    Code Block
    languagetext
    title/etc/hosts
    # localhost name resolution is handled within DNS itself.
#	127.0.0.1       localhost
#	::1             localhost

192.168.99.100	api.acme-corp.com

  • If the steps from above do not work for you

After accessing the Login

...

page, you see the error Invalid parameter: redirect_url.

The redirect URL is configured wrongly in Keycloak.

Change the Keycloak settings as described on

...

Installing API Management >

...

Configure the

...

Cannot run docker-compose on gateway container:
Docker-compose throws NoSuchFileException for e.g. jks files during build.

...

You are using Docker for Windows and you have changed your Windows password recently.

...

There is an mounting issue using Docker for Windows.

You can try this workaround:

  1. Open Docker settings.
  2. Click on the Shared Drives tab.
  3. Deselect your shared drives.
    Click Apply.
  4. Select the drives you want to share.
    Click Apply.
    Docker should prompt you to re-enter your credentials.
  5. Rerun docker-compose.

Authentication Service (Keycloak).

After having logged in, you are not redirected to the API Management UI.
The error message reads: "HTTP Status 403 - Forbidden. The server understood the request but refuses to authorize it."		If you are using CentOS on your API Management server, you might have run into a know firewall issue.Change the firewall rules as to trust the Docker interface.
Your browser shows an ERR_SSL_VERSION_OR_CIPHER_MISMATCH error.

This may be a problem with your file permissions:
If the file permissions are not set correctly, the container can not read the certificate.

Linux: Change the file permissions in your config folder to provide at least read-access:

Code Block
$ sudo chmod -R 644 api-mgmt/configs

Still Need Help?

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamesupport_overview
PageWithExcerptINTERNAL:_api_excerpts

Otp
Floatingfalse
maxHLevel2

...