Use the following procedures to set up a Failover Group.
Set up server addresses and client addresses. This step is needed only when using a private network or a when using a Sun Ray server that provides DHCP services. See Chapter 19, Alternate Network Configurations for details.
Configure a primary server.
Add secondary servers.
Synchronize the primary and secondary servers.
Change the group manager signature.
Layered administration of the failover group takes place on the primary server, where the master copy of the Sun Ray data store resides. The utreplica command designates a primary server, advises the server of its administration primary status, and tells it the host names of all the secondary servers.
The term primary server reflects the replication relationship, not the failover order.
Configure the primary server before you add the secondary servers.
If a common home directory is mounted on machines with different GNOME versions, conflicts between or among the versions cause unpredictable behavior. Do not try to use multiple GNOME versions with a common home directory.
Become superuser on the primary Sun Ray server.
Configure this server as the primary Sun Ray server and identify all secondary servers.
# /opt/SUNWut/sbin/utreplica -psecondary-server1
[secondary-server2
...]
where
[secondary_server1
...]
is a space-separated list of unique host names of the
secondary servers.
secondary_server2
When the script ends, a log file is available at:
For Oracle Solaris:
/var/adm/log/utreplica.Year
_Month
_Date
_Hour
:Minute
:Second
.log
For Oracle Linux:
/var/log/SUNWut/utreplica.Year
_Month
_Date
_Hour
:Minute
:Second
.log
The secondary servers in the group store a replicated version of the primary server's administration data.
Use the utreplica command to advise each secondary server of its secondary status and also the host name of the primary server for the group. Adding or removing secondary servers requires services to be restarted on the primary server.
If the secondary server has not been configured on the primary server, become superuser on the primary server and rerun the utreplica command with the new secondary server.
# /opt/SUNWut/sbin/utreplica -p -asecondary-server1
[secondary-server2
...]
where
[secondary_server1
...]
is a space-separated list of unique host names of the
secondary servers.
secondary_server2
Become superuser on the secondary server.
Add the secondary server.
# /opt/SUNWut/sbin/utreplica -s primary-server
where
is the host name of the primary server.
primary-server
Log files for Sun Ray servers contain time-stamped error messages that can be difficult to interpret if the time is out of sync. To make troubleshooting easier, make sure that all secondary servers periodically synchronize with their primary server.
The Network Time Protocol (NTP) is the recommended protocol to synchronize primary and secondary servers. With NTP, you can synchronize to an absolute time source and it provides additional synchronization capabilities. In some deployments, the simpler TIME protocol configured through the rdate command may be sufficient.
Both the NTP and TIME protocols are disabled by default on Oracle Solaris servers.
The utconfig command asks for a group manager
signature if you chose to configure for failover. The signature,
which is stored in the
/etc/opt/SUNWut/gmSignature
file, must be
the same on all servers in the group.
The location can be changed in the
gmSignatureFile
property of the
auth.props
file.
To form a fully functional failover group, the signature file must meet the following criteria:
Owned by root with only root permissions
Contain at least eight characters, in which at least two characters are letters and at least one character is not
For slightly better security, use long passwords.
Become superuser on the Sun Ray server.
Start the utgroupsig command.
# /opt/SUNWut/sbin/utgroupsig
You are prompted for the signature.
Enter the signature twice identically for acceptance.
For each Sun Ray server in the group, repeat this procedure.
Be sure to use the utgroupsig command rather than any other method to provide the signature. utgroupsig also ensures proper internal replication.