[FOLIO-2876] Consistently use -Dserver.port or -Dport or -Dhttp.port for Okapi HTTP port Created: 17/Nov/20  Updated: 15/Feb/22

Status: Draft
Project: FOLIO
Components: None
Affects versions: None
Fix versions: None

Type: Tech Debt Priority: TBD
Reporter: Julian Ladisch Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: tech-debt
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original estimate: Not Specified

Issue links:
Blocks
blocks CIRCSTORE-256 Honor -Dport setting Open
blocks MODFEE-142 Honor -Dport setting Open
blocks MODFIN-167 Honor -Dport setting Open
blocks MODGOBI-114 Honor -Dport setting Open
blocks MODINVOICE-212 Honor -Dport setting Open
blocks MODINVOSTO-95 Honor -Dport setting Open
blocks MODINVSTOR-617 Honor -Dport setting Open
blocks MODKBEKBJ-525 Honor -Dport setting Open
blocks ERM-1235 Honor -Dport setting Closed
blocks MDEXP-335 Honor -Dport setting Closed
blocks MODCAL-85 Honor -Dport setting Closed
blocks MODCONF-67 Honor -Dport setting Closed
blocks MODCR-48 Honor -Dport setting Closed
blocks MODDATAIMP-344 Honor -Dport setting Closed
blocks MODDICONV-157 Honor -Dport setting Closed
blocks MODEMAIL-43 Honor -Dport setting Closed
blocks MODEUS-97 Honor -Dport setting Closed
blocks MODEVENTC-24 Document jar options Closed
blocks MODFISTO-185 Honor -Dport setting Closed
Sprint: CP: Non-roadmap backlog
Development Team: Core: Platform

 Description   

RMB has been using -Dhttp.port to define which port to listen on. Most back-end modules use RMB.
Spring based modules use -Dserver.port.
Other modules use -Dport.

When deploying using Okapi this is not relevant because the "launchDescriptor" in the ModuleDescriptor use the %p placeholder.

However, for other deploy methods like Debian packages https://github.com/drexljo/folio-projects such a configuration option is needed.

This Jira is to decide whether we

  • let each module decide which option to use (-Dserver.port or -Dhttp.port or -Dport or any other)
  • suggest that all modules should support at least -Dserver.port
  • suggest that all modules should support at least -Dport
  • suggest that all modules should support at least -Dhttp.port

A GitHub search finds

Some modules do not get HTTP requests from Okapi but requests in a different protocol, for example edge-sip2. This is not HTTP and http.port might be a misleading name.



 Comments   
Comment by David Crossley [ 08/Feb/22 ]

When something is decided then need to clarify https://github.com/folio-org/okapi/blob/master/doc/guide.md#compiling-and-running and perhaps an FAQ at dev.f.o

There is a recent Slack discussion (#development 2022-02-05) about new Spring modules using a new option "server.port".

Generated at Thu Feb 08 23:23:54 UTC 2024 using Jira 1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d.