docs.go.cd icon indicating copy to clipboard operation
docs.go.cd copied to clipboard

Improve "Other config options" page

Open deeaitche opened this issue 2 years ago • 4 comments

I have just spent hours to figure out how to change the go-server's port. (Environment: Linux)

The official doc here does not provide enough information.

Workaround:

Adding wrapper.java.additional.{} property to /usr/share/go-server/wrapper-config/wrapper.conf

For example,

wrapper.java.additional.12=-Dcruise.server.port=28153

deeaitche avatar Nov 10 '22 09:11 deeaitche

The linux docs at https://docs.gocd.org/current/installation/install/server/linux.html point to the best place to do this, which is /usr/share/go-server/wrapper-config/wrapper-properties.conf If you change wrapper.conf it is liable to be overridden when you upgrade your server. That file gives examples and instructions (e.g I would not suggest starting your numbering at 12 as if additional default server options/system properties need to be added, they might be overridden. Best to start at 100.

The challenge is that there are different ways to configure these args depending on whether you are containerised or not, or a different deployment type. Definitely could do with linking from these to the page with the various options though.

chadlwilson avatar Nov 10 '22 11:11 chadlwilson

The linux docs at https://docs.gocd.org/current/installation/install/server/linux.html point to the best place to do this, which is /usr/share/go-server/wrapper-config/wrapper-properties.conf If you change wrapper.conf it is liable to be overridden when you upgrade your server. That file gives examples and instructions (e.g I would not suggest starting your numbering at 12 as if additional default server options/system properties need to be added, they might be overridden. Best to start at 100.

Thanks! very useful.

deeaitche avatar Nov 11 '22 07:11 deeaitche

@deeaitche For my own clarity, are you installing with the .deb, .rpm or just generic zip install on Linux? That'll help me validate some of the behaviour when upgrading an existing instance before I try to add some clarity to the docs.

chadlwilson avatar Nov 11 '22 07:11 chadlwilson

@chadlwilson I followed the linux docs to install via YUM.

deeaitche avatar Nov 11 '22 08:11 deeaitche