Apigee Developer portal kickstart specs does not render on very first click on view documentation.

[ashishkumar16]

I recently deployed the Apigee developer portal kickstart solution provided by Apigee.

After installation if found that the api specs are not loading when I click on view documentation however this works when I reload the page.

[byz]

Hello - thank you for reporting this behavior. Our team is looking into reproducing this and will reply once we have investigated. 

Can you please confirm you are experiencing this in the Apigee Developer Portal Kickstart on Drupal, and that this is reproducible every time you select to view documentation? 

[ashishkumar16]

Hi byz,

Yes this behaviour is observed in Apigee Developer Portal kickstart.

To reproduce this behaviour open the website every time in incognito window.

Click on View Documentation will show the empty details as below.

This issue will be more visible if you can add few more API Catalog with some different open api specs.

[shishir21]

Hi @ashishkumar16 

Could you please share us the Drupal and PHP versions you are currently using.

[ashishkumar16]

@shishir21 

Please find the version details:

Apigee developer portal kickstart (10.1.8)
NGINX(1.22.1)
Drupal(10.1.x)
MySQL-Client(15.1)
PHP(8.2.7)
Ops Agent(2.35.0)
OS: Debian (12)

[shishir21]

Thanks for sharing the details,

Sometimes this happens due to caching issue, could you please do the following steps:
1. Go to configuration -> development -> performance -> Bandwidth optimization
(admin/config/development/performance)

2. Uncheck both `Aggregate CSS files` and `Aggregate JavaScript files` then Save configuration.

3. click on `ClearAllCache` on same page.

once all above steps done, check to see if the specs renders correctly.

[ashishkumar16]

@shishir21 

Thanks for your response:

I followed the steps provided by you but no luck.

The behaviour is the same.

Secondly this issue is easily reproducible by following the steps mentioned by me above. not something  

[shishir21]

@ashishkumar16 ,

I am not able to reproduce this issue.

Could you please create a bug ticket here https://github.com/apigee/apigee-api-catalog-drupal/issues/new?assignees=&labels=bug&projects=&templ... so that our team can investigate more on this issue.

Thanks!

[kedarkhaire]

Hi @ashishkumar16 

Many Thanks for sharing the details.

I checked with 21 Api contents, tried on the Incognito window, for regular & admin user as well as the non-logged in user, My configs were same as yours except the server, I am using Apache server.

But still I was not able to reproduce the error with the steps mentioned by you.

Can you let us know, how many OpenApi docs you are testing with ? Also when you get error,  please provide us the error you are getting on Recent logs or if any error you are getting on browser's console.

As @shishir21 said, can you please create a bug ticket here with the details.

Thanks!

[byz]

Thank you for investigating this team! As there is no initial reproduction of the issue, to ensure proper further troubleshooting, data protection, and context preservation, let's follow up through the bug ticket process to drive this to completion.

[anoopgoel]

Hi @ashishkumar16 ,

I am also facing the same issue that api spec loads intermittently. Kindly help if above issue got resolved for you and how ?

Thanks in advance!

Anoop Goel

[ashishkumar16]

@anoopgoel 
As my observation this issue seems like with NGINX Server and not with Apache.
I swiched to native deployment of all components (i.e., Linux, Apache, PHP, MySQL, Composer etc.). rather than Kickstart solution provided by Apigee.
This worked for me.

Thanks,
Ashish

[anoopgoel]

Thanks for your reply @ashishkumar16 . I tried the suggestion given by @kedarkhaire  which resolved my issue. 

Thanks!

Anoop Goel

[ashishkumar16]

Just an update on the issue.
This was not getting reproduced in my local system with Apache.
When I deployed the kickstart on GCP Compute engine instance the issue is reproducing with Apache server as well.

[kedarkhaire]

Hi @anoopgoel   

This can be the issue with formatter you are using, try using other formatter as mentioned here - https://github.com/apigee/apigee-api-catalog-drupal/blob/3.x/README.md#overview

This above will solve your issue.

Thanks!

[anoopgoel]

Hi @kedarkhaire ,

Thanks for your response. Yes, it resolved my issue.

Thanks!

Anoop Goel

[kedarkhaire]

Hi @ashishkumar16  

If the above solutions/steps solved your issue, feel free to close the issue. If not then do let us know with the errors you are getting.

Thanks!

[ashishkumar16]

Hi @kedarkhaire 

When I follow the steps you have provided here - https://github.com/apigee/apigee-api-catalog-drupal/blob/3.x/README.md#overview
My kickstart solution gets refreshed and shows to setup screen again and again. 

[kedarkhaire]

Hi @ashishkumar16 

I have checked, the above solution, and it works for me, I don't see why changing the formatter would lead to setup screen.

Can you please share screenshot of the issue and the details you are seeing on it ?

Thanks!