The Fixes Administration workbench lets a system administrator manage the fixes to an environment from within the COINS ERP+ user interface.
COINSAdmin needs to be upgraded to 1203B or later to use the fixes administration features.
Configuration file
To enable the Fixes Administration workbench:
Create a vault configuration file (for example, $BASE/var/vault/fixadmin.cfg). You can copy a default example from $ADMIN/std/cfg.
In the configuration file, specify the following two configuration items:
0 COINS FIXADMINWS "<branch-list>"0 COINS FIXADMIN "<type-list>"
<branch-list> is a list of workspaces/branches that should be shown in the workbench. This should always contain at least one branch (the version that you are on) for example,
0 COINS FIXADMINWS "v12.04".If you are on a full custom environment, contact support for guidance.
<type-list> is a list of types of fix that should be shown. Normally this should be set to
Service Pack; this also shows recent corrections after the last service pack.
Fix Admin script
A script fixadmin in $BASE/bin for all environments managed by COINSAdmin is used to power the Fixes Administration workbench in COINS ERP+. It is created by the Environments Generate Scripts.
Loading fixes
A script loadfixes in $ADMIN/bin is used to download fixes from the central server. It will only download fixes not available in COINSAdmin. The script can be run from a cronjob.
The COINS server must be able to FTP the fixes from the central hot fix server. It must not be blocked.
Usage of the script is as follows:
bin/loadfixes <Version> [<Cleanup>]
Where:
Version: ERP+ version
Cleanup: Y/Yes to clean up downloaded fixes - Optional, Default is Yes
Example:
bin/loadfixes v12.04
The script is also available per environment in $BASE/bin. If run from $BASE the version does not need to be specified.
Installing fixes
A script installfixes is available in COINSAdmin under $ADMIN/bin. It can be scheduled as a cron job or added to your existing maintenance scripts. This should be configured to run daily and will download fixes from the central server (the same as loadfixes) and install those fixes for a defined list of environments.
Usage of the script is as follows:
/u/coins/coinsadmin/bin/installfixes --live=<ENVS> --test=<ENVS>
Where:
--live: This flag is used when fixes are made live and allows the ability for non-live environments to mirror the Live environment.
--test: This flag is used for the fixes to go on non-live or test environment(s) and allows any issues to be identified and resolved before the fixes go live.
Multiple environments are specified as a comma-separated list.
Example:
/u/coins/coinsadmin/bin/installfixes --live=live,cplive --test=test
The installfixes script will send an email after it completes successfully.
The installfixes script will send error emails:
If it fails to download a list of installable fixes for the environment
If fixes (Maintenance Updates) are installed out of sequence
If it fails to install fixes
Emails will be sent from Application Monitor. For this to work the RSM Host and CGI fields in COINSAdmin > Application Monitor must be populated, and Mail From in COINSAdmin must also be set. The Mail To email address will be read from a blank role of type EMAIL if it exists, otherwise it will be read from the SY parameter ESBMON on the Mothership environment. If Mail From or Mail To are blank no email will be sent.
If the fix install job fails and the Mail Server is not set up in COINSAdmin, a message $BASE/bin/info.msg will be created.