|
Use clsetup command to simplify the task of setting
up a cluster on a typical machine configuration. The clsetup
command can create instances if they do not already exist, and perform cluster
setup on these instances based on the configurations in the input files.
The following input files are required for the clsetup
command to function:
-
clinstance.conf
- contains information about the application server instances that are
part of the cluster.
-
clresource.conf
- contains information about the HADB database and other resource information.
-
clpassword.conf
- contains the asadmin password and is pre-populated
with the correct password during a standard installation.
By default the input files are located in the application server configuration
directory which is located in /etc/opt/SUNWappserver7.
Additionally, the clsetup command is located by default
in installdir/bin.
Before editing the input files, keep in mind:
- The order of the entries must not be changed.
- Any line that starts with a hash mark (#) is treated as a
comment.
- If the entities to be handled (HADB database nodes and application
server instances) already exist, the clsetup command does
not delete or reconfigure them, and the respective configuration steps are
skipped.
-
clsetup command creates the HADB database
with no inetd settings. Consequently, inetd configurations are not performed.
-
clsetup command does not set any shared
memory values.
Before running the clsetup command you must:
- have the asadmin and hadbm
command on the local machine.
- use the clsetup command as-is to setup
a typical cluster configuration.
- run the HADB shared memory setup, and HADB cluster host communication
setup for SSH and RSH.
- use the same administrator password for all domains that are
part of the cluster.
- start the administration servers of all instances that are
part of the cluster.
During standard installation, the clinstance.conf
file is created with entries for two instances. This occurs only if the Sun
Java System Application Server is also installed. However, if only the application
server administration client is installed on the machine, the clinstance and clpassword files installed on this machine
are not pre-populated. If you add more instances to the cluster, you must
update the clinstance.conf file with the information
for the new instances. The information about the instances in each cluster
must be defined in the instance file (default name is clinstance.conf). The following are the possible entries in the clinstance.conf file:
Table 1: Entries in the clinstance.conf file
| Entry | Definition | Default Value(s) |
| instance | Name of the application server instance | server1, server2 |
| user | Administration server user name | admin |
| host | Host name | localhost |
| port | Port number of the Administration Server | 4848 |
| domain | Name of the Administrative
domain | domain1 |
| instanceport | Port number of the
application server instance | 80, 81 |
| master | Boolean to indicate the
master instance | true. For first
time installation. |
The clresource.conf file contains information about
the HADB database, JDBC connection pool, JDBC resource, session store, and
session persistence. Permissions 0600 are preset on the clresource.conf file and it can be accessed only by the root user. The following
are the possible entries in the clresource.conf file:
Table 2: Entries in the clresource.conf file
| Entry | Definition | Default Value |
| HADB Database Information |
| historypath | Path for the history
files | /var/tmp |
| devicepath | Path for the data
and log devices | installdir/SUNWhadb/4 |
| datadevices | The number of data
devices on each node | 1 |
| portbase | The port base number
used for node 0 | 15200 |
| spares | The number of spare nodes | 0 |
| set | Comma separated list of database configuration attributes. | managementProtocol=rsh To specify
the use of RSH instead of SSH (the default), uncomment the following line:#set
managementProtocol=rsh |
| inetd | Database runs with inetd
daemon | false |
| inetdsetupdir | The inetd setup
files directory location | /tmp |
| devicesize | Size of the device in MB | 512 |
| dbpassword | Password for the system user of the database | password |
| hosts | All hosts used for all data nodes | localhost,localhost |
| JDBC Connection Pool Information |
| steadypoolsize | Minimum and initial number of connections maintained in the pool | 8 |
| maxpoolsize | Maximum number of connections that can be created | 32 |
| datasourceclassname | Name of the vendor supplied JDBC datasource | com.sun.hadb.jdbc.ds.HadbDataSource |
| isolationlevel | Transaction isolation level on the pooled database connections | repeatable-read |
| isisolationguaranteed | Transaction isolation level guaranteed | true |
| validationmethod | type of validation method | meta-data |
| property | Property used to specify username, password, and resource configuration | username=appservusr:password=password:cacheDataBaseMetaData=false:eliminateRedundantEndTransaction=true:serverList=replaceurl |
| JDBC Resource Information |
| connectionpoolid | Name of the connection pool | appservCPL |
| Session Store Information |
| storeurl | JDBC URL of the HADB database | replaceurlValue is replaced by the actual URL at
runtime. |
| storeuser | HADB user who has access to session store | appservusr |
| storepassword | password for store user | password |
| dbsystempassword | Database system password | password |
| Session Persistence Information |
| type | The session persistence type | ha |
| frequency | The session persistence frequency | web-method |
| scope | The session scope | session |
| store | Session store | jdbc/hastore |
| Stateful Session Bean Information |
| sfsb | The stateful session bean failover | true |
| RMI IIOP Failover Information |
| rmi_iiop | RMI IIOP cluster configuration | true |
| Cluster ID Information |
| cluster_id | Cluster ID | cluster1 |
The clpassword.conf file contains the administration
server password. During execution of the cladmin command,
the asadmin command requires the administration server
password specified in the clpassword.conf file. The format
for the clpassword.conf file is :
| |
AS_ADMIN_PASSWORD=password
|
Where password is the administration server
password.
Permissions 0600 are preset on the clpassword.conf
file and it can be accessed only by the root user.
A log file, named clsetup.log, is available in the /var/tmp directory. By default the clsetup command
executes in verbose mode and logs information in the log file. Log file entries
start and end with timestamp tags. If the log file exists prior to execution,
the output is appended to the existing log file. Scan the log after each execution
to verify that it ran properly.
|
