Manually Configuring the Gateway's System Configuration Options

Products

• STARTER PACK-7
• CA Rapid App Security
• CA API Gateway

Issue/Introduction

The Gateway has a terminal user interface for configuring time, time zone, and time synchronization. It may be desirable to manage these items outside of the Gateway configuration menu. Additionally, development incident SSG-4589 exists to address some concerns regarding certain behaviors of this configuration menu. In order to accommodate for these behaviors, certain items can be manually configured.

Environment

Release:
Component: APIGTW

Resolution

The Gateway configuration menu provides a TUI-based front-end for several Linux applications that are used to configure the system. This includes but is not limited to: System time, system time zone, and the network synchronization configuration. To configure each of these items manually, follow the associated procedures:

System time and date

Set the date and time in the following format: "DD MMM YYYY HH:MM:SS" For example: date -s "2 OCT 2006 18:00:00"

Local system time zone

The Gateway appliance contains various files that associate with specific time zones. These files are contained in /usr/share/zoneinfo. A Gateway can be configured to use these time zone files as follows: ln -sf /usr/share/zoneinfo/path/to/zone /etc/localtime. For example: ln -sf /usr/share/zoneinfo/US/Eastern /etc/localtime

Network time synchronization

Adjust NTP runtime status

An administrator can start, stop, restart, or query the current running status of the NTP client as follows:

• service ntpd status
• service ntpd stop
• service ntpd start
• service ntpd restart

An administrator can also configure and query the running state of the NTP client upon system initialization:

• chkconfig --level 2345 ntpd on
• chkconfig --level 016 ntpd off
• chkconfig --list | grep ntpd

The NTP client can be manually synced the remote server

• service ntpd stop
• ntpdate -v server.domain.com
• service ntpd start

Particular servers can be added to the pool of servers by reconfiguring the NTP client configuration file (/etc/ntp.conf) to have one or more of the following directives:

• server 0.rhel.pool.ntp.org