You can install Patchman on any new server that requires it, once you have prepared your server and installed all dependencies.
Each new server requires a manual initial install of Patchman. The assumed base directory is /home/nevrax
, using the nevrax
user that was created during the server preparation.
Under admin_install\patchman
, edit the patchman_list
. Add an additional line containing the domain followed by the server hostname. You can have multiple domains on a single box, if necessary. The following example will run the patchman configuration patchman_service.open.cfg
on hostname demo
and open
.
// domain hostname
open demo
open open
If your new host is responsible for serving patches, then special_patchman_list
should be updated as well. This example will run the patchman_service.open_bridge.cfg
and patchman_service.open_spm.cfg
services on hostname open
, a VM for administration utilities, which happens to have the domain name as hostname for convenience.
// domain_service hostname
open_spm open
open_bridge open
If you haven't prepared any of the
.cfg
files underadmin_install\patchman
yet, simply copy them from their respective templates, and update the hostnames to point to the server that will serve the patches.
TODO: Replace this process with just one CSV file
domain,hostname,service
(e.g.open,demo,spa
,open,open,spm
, etc.), and a Python script that generates all the cfg files for the current host upon admin launch, and returns the list to the existing shell script, so no cfg files have to be made manually.
On the Windows build box, run the following build pipeline command.
c1_shard_patch.py --admininstall
This will create or update the admin_install.tgz
archive under Y:\ryzomcore\pipeline\bridge_server
.
Upload patchman_service_local.cfg
from admin_install
into /home/nevrax
and edit the hostname in the config file to match the hostname of the server (e.g., demo
, not the FQDN).
Upload Y:\ryzomcore\pipeline\bridge_server\admin_install.tgz
to /home/nevrax
on the server box and extract it there.
tar zxvf admin_install.tgz
Chmod the contents of /home/nevrax/bin
and /home/nevrax/patchman
to be executable.
chmod -R +x bin
chmod -R +x patchman
Browse to /home/nevrax/bin
and run ./startup
. This will launch the Patchman services as configured for this server box.
cd bin
./startup
Patchman services store their configuration data under /home/nevrax/[domain]
, /home/nevrax/[domain]_bridge
and /home/nevrax/[domain]_spm
, depending on the configuration.
The Patchman services can be stopped using ./admin stop
.
You can use screen -r
to monitor the Patchman services manually.
While you haven't added the server to the server park configuration yet, you may see the debug message
getHost failed for hostName
.
If this issue persists, ensure you've correctly setup the DNS lookup of your servers.