To enable Swagger for a PASOE instance:
- Open a PROENV shell and navigate to the working directory.
- Create a PASOE instance:
$ pasman create -f -p 8890 -P 8891 -s 8892 -m tomcat:tomcat -N Test <workingdirectory>/Test
- Deploy the oemanager service:
tcman deploy <dlc>/servers/pasoe/extras/oemanager.war
Note: If running in a production server the -f will not copy the war files to the instance directory because there are no war files in $CATALINA_HOME.
- Start the PASOE instance in order to have the oemanager directory properly created in \<workingdirectory>\<instancenamedirectory>\webapps
$ pasman pasoestart -I Test -restart
- Navigate to the PASOE new instance directory: \<workingdirectory>\<instancenamedirectory>\webapps\oemanager\WEB-INF
a. Edit the file oemgrSecurity-container.xml,
b. Uncomment the following line (around line 35):
<!-- Access to SwaggerUI. Disabled by default, user has to uncomment the below line to enable it -->
<intercept-url pattern="/doc/**" method="GET" access="hasAnyRole('ROLE_PSCAdmin','ROLE_PSCOper','ROLE_PSCUser')"/>
- Navigate back to the working directory and then restart the PASOE instance to apply changes
$ pasman pasoestart -I Test -restart
- Open a web browser and type:
http://<servername>:8890/oemanager/
Note: Ensure the URL has trailing backslash / at the end.
- User and Password (tomcat/tomcat)
- Swagger page should be loaded. If not, please verify the steps above and then stop and restart the PASOE instance, with the OpenEdge Explorer Console or tcman stop/start.
