The rest of this document is dedicated to completing the Everserve installation with commands for community creation. Note that the installation of Everserve onto all systems that will participate in the community is required. First is an overview of the steps that you will take.
Step one - mySQL and Everserve installation on the Community Manager. This is already done!
Step two - create the community definition and copy the seed file to each participating system. Specific commands to accomplish this are spelled here.
Step three - get Everserve installed onto all other systems, copy the seed file, and join these systems to the community. Each system that was added to the community in Step two was assigned a role. Take care with Everserve installation on the other community peers because the install program is specific to each role. When Everserve installation is executed at each station, the role designated during install should match the role that is assigned by the Community Manager. This tutorial intends for you to start simply with a community topology that has one system as a dedicated publisher and community manager and all other systems configured as targets.
Step four - verify that all systems in the community are active. Deliver a sample package and view the receipts.
On the community manager open a command window and enter the Everserve interactive shell by typing "everserve" at the shell prompt. Type a ? into the interactive shell to get a list of all the Everserve commands and their syntax. The commands listed in this section assume that you will use the interactive shell. Alternatively, you can use a standard OS shell prompt by prepending "everserve" as you type each of the commands. Values enclosed in angle brackets < > are not literal. You must substitute the correct value in place of the bracketed values.
Begin by creating the community manager peer. Later you will execute the create peer command at least once for every system you want to participate in the community. If any of these systems is to have more than one role in the community, a peer must be created (and subsequently added into the community) for each role. At the Everserve prompt of the command shell type the following commands:
create peer -p cm -h
The required arguments to this command are -p for the peer name "cm"
and the -h "hostname" flag for the community manager system's hostname
or ip address. The -d flag denotes an optional description for this peer.
create community -c community1
create peer -p pub -h
The community will need a publisher. In this example the community manager system also functions as the publisher for the community. This requires that two peers be created for the same system since a peer can have only one role assigned to it. A system may host more than one peer. This create peer command is similar to what was used for the community manager peer named cm.
add peer -p
Earlier, the create community command automatically added the community manager peer. The "add peer" command is needed here to assign the role of publisher to the peer named pub that was just created in the community named community1. Now it is time to create all the peers and get all the systems added into the community so that they can join following Everserve installation.
You should have the list of hostnames (or ip addresses) that was created to prepare for Everserve installation. You will execute a "create peer" command on the community manager for each of the entries in the list.
create peer -p <peername>
Substitute a unique peername along with the appropriate host address for each of the systems on the list. Peer names can be the same as hostnames. The description parameter is optional. Useful descriptions might include the peer's role or physical location.
For each of the peers created with the host list on the community manager you must execute an add peer command. If the -r parameter is left off of the commandline the default role of target is assigned to the newly added peer.
add peer -p <peername>
Community creation can be done with scripting. Synchron Networks' tech support
can provide sample scripts. Once all of the peers are created and added you
can validate the peer names assigned to hostnames in the community by executing
the a "show" command
on the community manager. Verify all systems from the list were added with the
following command:
show peers
The community manager now has a fully populated community. Other systems will need a copy of the community manager's seed file to initiate other new peers into the Everserve community. The seed file will be found in the server subdirectory of the Everserve installation base directory. The default directory location on Windows is "C:/Program Files/Synchron Networks/Everserve/server". On Solaris the directory is "/usr/local/synchron/server". The seed file in this example will be named community1.zip. Copy the file onto a floppy disk or to a network location that can be reached by all peers.
Working from station to station, install the appropriate Everserve role onto
the community peers. When the system comes back from the reboot that is part
of installation you must execute the join command to make the peer active. First,
copy the seed file to the same location that it came from on the community manager;
the default directory location on Windows is "C:/Program
Files/Synchron Networks/Everserve/server". On Solaris the directory
is "/usr/local/synchron/server".
Next you execute the join command in an OS shell or the Everserve interactive
shell. The syntax for the join command is:
join -c community1
A system only needs to join the community once; all of the peers created
with the system's hostname will join the community at the same time. The -c
parameter "community1" is the name of the community that was created
earlier and matches the name of the seed file (without the .zip extension).
Note: The community manager must be up and running Everserve's JMS Server whenever a peer tries to join the community.
Following the execution of join you can return to the community manager/publisher system, initiate a delivery and verify the results.
The "show" command
reviewed earlier will list the systems in a community. If the -c parameter is
used with "show peers"
then additional data will be output to show each joined peer as "active".
In order to check your work with community creation and validate the correctness
of the peer's join command execute the following Everserve command:
show peers -c community1
Review the output and verify that all of the peers are active and ready
to execute their first package. An
example package that is included with the Everserve installation can be sent
to check the Everserve version installed on each system in the community. On
the publisher/community manager system execute the following command:
deliver -f SimpleTest.xml -i test1
This command will send the package described in the SimpleTest.xml file and associate the receipts sent back from each peer with the identifier string "test1". The next command will verify that the package was delivered to all peers and executed without errors.
show receipts -v
If you have the time and energy, look at the packages directory found in the server subdirectory of the Synchron base installation. There you can view the contents of the SimpleTest.xml file. You can modify the xml package specification templates found on the installation CD, place the modified files in the Everserve packages directory and continue making Everserve deliveries.