CSE Installation and Configuration › Advanced CSE Configurations › Install a Multiple Release Encyclopedia

Install a Multiple Release Encyclopedia

When you install a multiple release encyclopedia, consider these points:

• Although the CSE clients can see all the models in the encyclopedia, models are not interchangeable between software releases. Each model in the Encyclopedia belongs to exactly one software groups.
• After using the new release to access a model, do not use the old release software to access that model. This is true for operations that change the model.
• The new software can work with models in the new release and the old release.
• The old software can only access models in the old release schema.
• Old release CSE clients can access models through the new release and old release servers. Those clients will not have access to some features added in the new release.
• New release clients can only access the encyclopedia through the new release servers. The new clients can access models in the old release and the new release schemas.

Before you begin the install, ensure all models and subsets are checked in. The owner of each checked out model or subset check it in or should override the checkout.

Follow these steps:

1. Stop the CSE if it is running.
2. Shut down iefrds if it is running.
3. Back up coordination and encyclopedia databases.
4. Configure TCP/IP connections.
5. Multiple Release configuration requires two IEFRDS names. One IEFRDS name should be present and is associated with the old release software. Add a new IEFRDS name to the host's file or DNS and to the services file. Verify that the IP addresses are the same for the two names and the port numbers are different. The new RDS name is associated with the new release software. Instructions for altering the hosts and services file are in the basic installation instructions.
6. Install and configure Coordination and Encyclopedia Servers. Install the new release of the CSE in a new directory. Do not install the new release in the same directory as the old release because it replaces all the old programs you want to continue using. Run this new configuration to verify it starts correctly. After it is completed, shut it down.
7. Upgrade the Coordination and Encyclopedia databases so the new release can run with the existing database. Use a new Encyclopedia Group name for the new release software.
8. Start iefrds in the old release environment: Use telnet or rlogin to start a new shell on your UNIX system. Change directory to the old release installation directory, source cse.csh, or cse.sh. For the releases that preceded AllFusion Gen 7, the release installation directory might be iefcse.sh or iefcse.csh, depending on the shell you are using, and might run startrds. This execution instance of iefrds provides an execution environment the older version of the software need.
9. Start iefrds in the new release environment. A second instance of RDS must be running during the next configuration step. Use telnet or rlogin to start another new shell, change directory to the new release installation directory, source cse.csh, or cse.sh according to the shell you are using, and run startrds to provide the execution environment the new release software needs.
10. Prepare the Multiple Release Configuration. In the new release installation directory, run mdcfg to create the Multiple Release configuration. In the Configuration menu, select Multi-Ency/Single MD. Add one Message Dispatcher, one Coordination Server, and two Encyclopedia Servers.
11. The Message Dispatcher, Coordination Server, and first Encyclopedia Server are all executed from the new installation. Use the new software group name for this encyclopedia.
12. The second Encyclopedia is executed from the old release installation and it does not have its own lock and ID servers. The software group name from the old release is used with this Encyclopedia.
13. Complete the configuration by saving and exiting mdcfg. Ignore the warning about using the same encyclopedia name twice.
14. (Optional) Stop the execution of the iefrds for the new release environment. It is needed only during configuration preparation.
15. Run the Multiple Release Configuration. In the new release directory, start the Message Dispatcher. Use your preferred method for starting the Message Dispatcher and the two sets of servers. Verify that one instance of srvcoord, srvid, and srvlock are running and two instances of srvms, srvuga, srvcons, and srvvc are running.
16. Perform Coordination updates. Add the new software group to the Coordination database and grant some users access to the new Encyclopedia. Start the coordination client using the directory administration account id. Register a new encyclopedia using a new Encyclopedia name and description, the new software group, and the same encyclopedia ID as is already registered. Grant the encyclopedia access to users requiring access to the encyclopedia. Warn these users, they will see two encyclopedias the next time they start any CSE client.

The Multiple Release configuration is ready to use.

The new software can work with models in the new release and the old release. The old software can only access models in the old release schema. Old release CSE clients can access models through the new release and old release servers. Those clients will not have access to some features added in the new release.

New release clients can only access the encyclopedia through the new release servers. The new clients can access models in the old release and the new release schemas.