Table of Contents
Abnormal termination of a server that causes service issues can occur for many reasons. These issues can be minimized by creating clusters. This chapter describes the issues that may occur if a server terminates abnormally and how to handle them.
Even if DAS terminates abnormally, managed servers(MS) can still run their services. If DAS stops abnormally due to a hardware error, MSs on the faulty machine are likely to fail as well. However, abnormal termination of DAS itself does not affect the services of MSs in the domain.
If DAS terminates abnormally, managing the configuration and adding and modifying applications cannot be performed until DAS restarts. After DAS restarts and notifies the MSs, the MSs are managed by DAS again.
Without being connected to DAS, an MS cannot start using the configuration in DAS. Instead, it must use the file in its local cache if it was able to connect to DAS at least once to obtain the configuration file.
However, if an MS starts before DAS it cannot use the configuration in DAS. It will use the copy in the local cache and then synchronize with DAS when DAS starts. If the MS and DAS share the domain directory because they are on the same machine, the MS can use the configuration in DAS even if DAS is not running.
Even if DAS terminates abnormally, the services can still run but some functions cannot be used. DAS should be restarted as soon as possible, but there are situations where DAS cannot restart due to such problems as a hardware failure.
To prepare for this, DAS settings and applications should be backed up. DAS can start on another machine by copying previously backed up DAS files to that machine.
The following are the methods for backing up and restoring DAS settings and applications.
Backing up DAS settings and applications
Back up the settings and applications of DAS using the pack-domain command.
offline>pack-domain domain1
Packing the domain [domain1] configuration completed successfully at the path [J
EUS_HOME/domains/domain1_packed.zip].
Applying the setting and application backups in DAS to another machine
Decompress the backup files using the unpack-domain command. DAS information such as IP, Port, and Node can be changed when using the unpack-domain command.
offline>unpack-domain domain1
The Domain Administration Server listener address is already set to [192.168.34.55]. Do you want to change it? (y/n): y
Enter the Domain Administration Server base listener address: 192.168.34.56
The Domain Administration Server listener port is already set to [9736]. Do you want to change it? (y/n): n
The Domain Administration Server nodename is already set to [node1]. Do you want to change it? (y/n): y
Enter the Domain Administration Server nodename: node2
The nodemanager of DAS machine listener address is already set to [192.168.34.56]. Do you want to change it? (y/n): n
The nodemanager of DAS machine listener port is already set to [7730]. Do you want to change it? (y/n): n
Unpacking the domain [domain1] configuration completed successfully.
Automatically backing up DAS settings and applications whenever DAS starts
The set-domain-backup command can be used to create the DAS backup file whenever DAS starts.
By default, the backup file is created in the directory where pack-domain command is executed. The backup file can be decompressed on a different machine using the unpack-domain command.
[DAS]domain1.adminServer>set-domain-backup -backupOnBoot true
Successfully performed the MODIFY operation for Domain Backup Policy.
Check the results using "set-domain-backup"
Once DAS starts with the recovered settings, MSs that were in the INDEPENDENT mode synchronize their settings and applications with DAS. Afterwards, they leave the INDEPENDENT mode and are managed by DAS again.
Refer to JEUS Reference Book. "4.2.4.28. pack-domain", JEUS Reference Book. "4.2.4.30. unpack-domain", and JEUS Reference Book. "4.2.4.29. set-domain-backup" for detailed information about the pack-domain, unpack-domain, and set-domain commands respectively.
Since Managed Servers run services regardless of the presence of DAS, the services are not affected when DAS terminates abnormally.
MSs have a local cache that stores settings and applications, which are synchronized when a server starts and when changes are made. If an MS is not connected to DAS when it starts, it uses the local cache to start in the INDEPENDENT mode.
When this happens, the MS is not controlled by DAS and DAS cannot monitor the MS. This can occur when DAS terminates abnormally, when the DAS address is incorrectly configured, or when a network error occurs.
After DAS restarts and notifies MS, the MS leaves the INDEPENDENT mode and is managed by DAS.
Managed servers in a domain can detect the abnormal termination of another server because they exchange state information through multicast. If the server is configured to automatically restart, DAS will automatically restart the server.
When the SSH Node Manager is used, option to restart a server is determined by the jeus.server.autorestart setting. If using the Java Node Manager, refer to "JEUS Node Manager Guide" for detailed information