Chapter 10 - Installing Options Using Software Codes and Installing Third-Party Services
This chapter describes how to manage the Server Codes and Option Codes supplied by Banyan to boot a server and install Banyan software options on the server. It also explains how to load third-party services that support UNIX-based applications.
Note: This description deals only with software Server Codes and Option Codes. If you have a previous version of VINES and have server and option hardware keys, refer to the documentation that came with the previous version of VINES for instructions on how to manage server keys and option keys.
When you purchase Banyan server software, you receive a card with a Banyan Server Code. A Banyan Server Code provides a unique network identification number (network ID) for the server that allows all other servers in the network to locate it. The server must have a unique network ID, or serial number, or it cannot operate.
Note: If you install VINES 7.00 on an existing Banyan server, you must have the server key that is applicable to previous revisions of VINES plugged into the server's parallel port. If you previosly installed a Banyan option using a software option code, you do not need the server key. The system reads the file sftopts.db and determines the server's serial number.
Caution: Do not use a Server Code on another server unless you shut down the server whose code you want to move. Providing two servers on the same network with a single network ID causes confusion on the network. Significant degradation in performance may result. Refer to "Moving Server Codes Between Servers" later in this chapter.
When you order a Banyan software option, your shipment includes a card with a Banyan Option Code. An Option Code lets you:
![]() |
Install a Banyan software option on a server |
![]() |
Transfer options between servers |
You should keep your server code card and your option code cards in a safe place in the event that you need to reinstall your server software.
An Option Code pertains to only one software option. After you install an option on a server, you can remove the option code from that server and either transfer it to another server, or store the Option Code card until it is needed on a network.
An Option Code pertains to a single option. You enter the code when you install an option and it is stored in the server database files sftopts.db and sysopts.db.
Moving Server Codes Between Servers
You should not use a Server Code from one server on another server. However, under special circumstances it is possible to use one server's code to boot another server.
To Move a Server Code to a Different Server
1. Shut down the server whose code you want to move. Two servers that have been booted with the same Server Code cannot operate on a network at the same time.
If two servers were to use the same network ID, severe problems would result in StreetTalk services and in the routing of data packets.
2. Wait a minimum of four days (96 hours) before using the Server Code to bring the new server onto your network. This delay ensures that servers on your network no longer associate the identification number on the Server Code with the server you removed from the network.
You need to wait four days whether servers on your network use a single Banyan software revision or several mixed revisions.
3. Enter the Server Code during the installation of the new server or restore a backup, depending on whether this is a complete new installation or a system rebuild. See Restoring a Backup in the Server Installation Guide.
You may replace an invalid or corrupt Server Code with another code if the replacement code was not used to boot another server that is operating on your network. You cannot have two servers on the network that have been booted with the same Server Code.
This section explains how to:
![]() |
Display installed options |
![]() |
Install options |
![]() |
Move options to another server |
1. From the Operator Menu, choose Shut Down Server Software. The Shut Down Menu appears.
2. Select Shut down services and return console to OPERATOR MENU. Services are stopped and the Operator Menu reappears. For more information on shutting down services, see Chapter 2.
3. From the Operator Menu, select System Maintenance. The System Maintenance menu appears.
4. Select Manage Software Options. The Manage Software Options screen appears. The upper portion of the screen lists the functions you can perform. The lower portion lists the options currently installed on the server and a designation for each option.
You can page down through the list to see all options installed on your server.
5. Press ESC to exit the Manage Software Options screen and return to the System Maintenance menu.
6. Select Return to Operator Menu.
7. Select Restart Services.
1. From the Operator Menu, select Shut Down Server Software. The Shut Down Menu appears.
2. Select Shut down services and return console to OPERATOR MENU. Services are stopped and the Operator Menu reappears. For more information on shutting down services, see Chapter 2.
3. From the Operator Menu, select System Maintenance. The System Maintenance menu appears.
4. Select Manage Software Options. The Manage Software Options screen appears.
5. Select INSTALL options. The Install Options screen appears.
6. Select Install OPTION CODE options. The prompts for entering the Option Code and Option Enabler appear in the lower half of the screen.
7. Enter the 14-digit Option Code and the 3-digit Option Enabler exactly as they appear on the option card that you received similar to those shown in Figure 10-6.
The message "Option installed!" briefly appears at the bottom of the screen if you successfully enter the correct codes. If you enter invalid codes, the message "Invalid Option Code!" briefly appears. Reenter the correct codes.
8. Press ESC three times to return to the System Maintenance Menu.
9. Select Return to Operator Menu.
10. Select Restart Services. Server operations resume.
Store the Option Code card in a secure place. You can use the code in the future to move options to another server.
For further information on setting up, managing, and using an option, refer to the guide that you received with your option.
Moving Options to Another Server
Moving an option from one server to another involves:
1. Removing the option from the first server
2. Installing the option on another server
You cannot transfer an option between servers if the second server's revision level does not support that option. For example, if option A on Server1 requires a server revision of 7.00, and Server2's revision level is 5.50, you cannot transfer option A from Server1 to Server2.
To Remove an Option from a Server
1. Delete any service associated with the option.
2. From the Operator Menu, choose Shut Down Server Software. The Shut Down Menu appears.
3. Select Shut down services and return console to OPERATOR MENU. Services are stopped and the Operator Menu appears. For more information on shutting down services, see Chapter 2.
4. From the Operator Menu, select System Maintenance. The System Maintenance menu appears.
5. Select Manage Software Options. The Manage Software Options screen appears. The lower portion of the screen lists the options available on this server.
6. Select MOVE options. The MOVE options screen appears.
7. Select Move OPTION CODE options. The options available to move appear in the lower half of the screen.
8. Use the arrow keys to select the name of an option you want to transfer and press ENTER. An asterisk appears to the left of the option. You may select more than one option.
9. Press F10 to remove the options you have selected. When the removal is complete, a message informs you that the options have been removed from the server.
10. Press ESC until you return to the System Maintenance Menu.
11. Select Return to Operator Menu. The Operator Menu appears.
12. Select Restart Services. Server operations resume.
When you remove an option from a server, any service created for that option no longer runs. For details on deleting these services, see Managing VINES Services.
For information on how to install the option on another server, refer to the procedure "To Install Options" earlier in this chapter.
Installing Third-Party Services
You can load third-party services that support UNIX-based applications onto the server. You install these services from the server, a workstation, or from both the server and the workstation. The documentation that comes with the third-party software contains information on how to correctly install the service.
Before installing the software for any third-party service, verify that the server is running a Banyan software revision that supports the service.
In this procedure, you may substitute the word "tape" wherever the word "diskette" appears, because the procedure may be used for both Banyan and non-Banyan servers.
1. From the Operator Menu, choose Shut Down Server Software. The Shut Down Menu appears.
2. Choose Shut down services and return console to OPERATOR MENU. Services are stopped and the Operator Menu appears. For more information on shutting down services, see Chapter 2.
3. From the Operator Menu, choose System Maintenance. The System Maintenance menu appears.
4. Choose Load Additional Software.
The following message appears:
Load the software diskette. Press [return] when ready, or q [return] to quit:
5. Insert the software media and press ENTER. The following message appears:
Starting load...
Loading third-party software option.
If services are running, the following messages appear:
The server must be stopped.
The installation stops and the System Maintenance menu appears. Exit to the Operator Menu to stop services and begin the procedure again.
6. The system checks that the revision of the server's Banyan software is compatible with the third-party software.
- If they are compatible, the following message appears:
Installing third-party software. Press ENTER to continue.
Skip to step 8.
- If they are not compatible, a warning appears. You are prompted to enter Y to proceed or N to return to the System Maintenance menu. Continue with step 7.
7. Enter N. Check the documentation for the third-party software to determine the Banyan software revision needed to support the service. Perform any necessary upgrades before you attempt to install the third-party software.
8. Press ENTER. The system checks the server for the disk space required to store the software.
- If there is enough space, the system displays the pathnames of the files it is loading from the media at the server console screen. After the system has loaded all of the software from the first diskette, it requests the next diskette in the sequence:
No more files on diskette 1. Place diskette 2 in drive. Enter 'p' to proceed or 'a' to abort:
Continue with step 9.
- If the server lacks sufficient disk space, you receive an error message and then the System Maintenance menu appears. If you want to install the third-party service, you need to move or delete files from disk1 of the server and restart the installation process.
9. Remove diskette 1.
10. Insert the next diskette in the sequence into the drive and enter p. The server copies the software from the diskette, then requests the next diskette in the sequence.
11. Repeat step 10 until all diskettes have been copied to the server.
The following message appears:
New software installation complete.
The System Maintenance menu appears.
12. Choose Return to Operator Menu. The Operator Menu appears.
13. Choose Restart Services. Server operations resume.
14. Run MSERVICE from a workstation client and create a name for the service. For information on how to create a service name, refer to Managing VINES Services.