Chapter 4: Install the Gateway

• Install the Gateway Files
  
  
• Create the Gateway
  
  
• Define Gateway Information
  
  
• Define Required Parameters
  
  
• Start the Gateway

Install the Gateway Files

To install the gateway files, select the correct platform for your version of the gateway.

• Install the NLM Gateway Files
  
  
• Install the OS/2 Gateway Files

Install the NLM Gateway Files
Before you can install the gateway, make sure you have access to the GroupWise* domain database and dirrectory structure. The Install program copies gateway files to the subdirectories listed under the domain.

To install the NLM* gateway files,

1. At the NetWare* system console, type load install  choose Product options.
   
   
2. For NetWare 3.1x, press Insert to display a prompt for a drive and path.
   
   For NetWare 4.x, choose Install a Product Not Listed.
   
   
3. At the file server, insert the gateway disk in a drive. In this example the A: drive is used.
   
   
4. For NetWare 3.1x, type the drive or path where the gateway installation files reside press  Enter to display the OV/VM Gateway Installation screen.
   
   For NetWare 4.x, select one of the following installation options:

   F3: Specify the path on the local server you want to install from.
   F4: Specify the path on a remote workstation you want to install from.
   Enter: Press Enter to install the files from the A drive of the local server. The disk should already be in the drive.

5. Fill in the fields.
   
   Install From: This field displays the location of the installation files.
   
   Install NLM To: Enter the directory where you want to store the OVVM.NLM. The default is SYS:\OVVM41.
   
   Install Shared NLMs To: Enter the directory where you want to store the NGWLIB.NLM. Store this file where it can be shared by each GroupWise NLM. The default location is SYS:\SYSTEM.
   
   Domain Path: Enter the path to the GroupWise domain where the gateway will be installed.
   
   Gateway Directory (under <domain>\wpgate\): Enter the path to the gateway subdirectory. The default is domain\wpgate\ovvm41.
   
   
6. Press Enter to install the gateway.
   
   
7. Press Esc until you return to the system console.

Do not start the gateway until after you configure it using NetWare Administrator. See Create the Gateway later in this chapter for more information.

Install the OS/2 Gateway Files
To install the OS/2** version of the gateway, you must install the gateway files to the domain directory where you want the gateway to reside. The install program can run only under OS/2.

1. Open an OS/2 window.
   
   
2. Insert Disk 1 in a drive. In this example, the A drive is used. Type a:install, press Enter to display the Novell
   
   GroupWise OS/2 Gateway Installation window.
   
   
3. Fill in the fields.
   
   Install from: This field displays the drive where the Gateway for OV/VM diskette resides. If the letter of the correct drive is not displayed, enter it.
   
   Install to: This field displays the drive where the gateway is to be installed. The Install program assumes the C drive is the OS/2 partition. If the C drive is not the OS/2 partition, enter the letter of the correct drive. If you want to install the gateway to the network or to another location on the local drive, enter the full pathname of the drive.
   
   Domain Directory: Enter the full pathname of the domain directory where the gateway is to reside.
   
   GW Home Directory under <domain>\wpgate\: The home directory is where the gateway stores its files and subdirectories that reside on the file server. These files and directories must reside in the \wpgate directory of the domain. The Install program assumes the gateway's home directory will be called OVVM. If you do not want to use the default, enter another name.
   
   
4. Click Install to begin the installation process.
   
   
5. Click Yes to create the directory where the gateway is to reside and to install the files. Insert the diskettes when the Install program prompts you to.
   
   
6. Click Yes if you want to view the README file at this time; otherwise, click No.
   
   
7. Click Yes if you want the Install program to create a folder for the GroupWise OfficeVision/VM icon. Choose No if you do not want to create a folder or an icon.
   
   
8. Click OK to return to the command prompt in the OS/2 window.

At this point, the gateway is installed. If you created the folder, the folder appears on your OS/2 desktop.

Do not try to start the gateway at this time. You must first set up the gateway using NetWare Administrator. See Create the Gateway below for more information.

Create the Gateway

After the gateway files have been installed, you must add the gateway object to the NDS* tree and configure the gateway.

To create the gateway in NDS,

1. From the NetWare Administrator browser window  click the GroupWise domain object where you want to install the gateway.
   
   
2. Right-click the domain  Create  double-click GroupWise Gateway.
   
   
   
   
3. Fill in the fields.
   
   
   
   Gateway Name: Enter a name for the gateway to be used for message addressing purposes. The name must be unique within the domain.
   
   Gateway Home Directory: Select the gateway home directory.
   
   Language: The default language is English. Click the drop-down box if you need to change the data in the Language field.
   
   Time Zone: Click the correct time zone. The gateway should use the same time zone as its domain.
   
   Gateway Type: Select the OV/VM gateway type by clicking the drop-down box to display a list of gateway types.
   
   Version: Click either the 4X or 5X version of the gateway. The default is 4X.
   
   
4. Click Create.

Before you can start the gateway, you must define the gateway information. See Define Gateway Information below for more information.

Define Gateway Information

After creating the gateway object in the NDS tree, you must complete the Gateway Information page in NetWare Administrator.

1. From the NetWare Administrator browser window  click the GroupWise domain object where the gateway was installed.
   
   
2. Right-click the gateway object  click Details.
   
   
3. Fill in the fields.
   
   
   
   Description field : Type text in this field that will help you identify where and when you created the gateway. This field is optional.
   
   Database Version: Select either the 4X or 5X version of the gateway. If you leave the field blank, the configuration will default to 4X.
   
   Platform: Select the platform for the gateway for OV/VM you have installed (NLM or OS/2).
   
   UNC Path: The UNC path to the gateway's home directory is displayed for your information and can be changed if necessary. Click the folder icon to open the Choose Directory dialog box.
   
   Gateway Alias Type: This field is optional if you want to define addresses in your GroupWise system so that your GroupWise users can select GroupWise OV/VM recipients from the Address Book. Enter a name you can use to identify the gateway when you assign aliases, for example, OVVM. This name is important if you have multiple installations of the same gateway or if the gateway shares a form of addressing syntax with another gateway. Gateway aliases let you define user addresses in your GroupWise system so that your GroupWise users can select foreign-mail-system recipients from the GroupWise Address Book.
   
   Foreign ID: Does not apply to the Gateway for OV/VM.

Define Required Parameters

1. From the NetWare Administrator browser window  click the GroupWise domain object where the gateway was installed.
   
   
2. Right-click the gateway object  click Required Parameters.
   
   
3. Fill in the fields.
   
   
   
   Mainframe Parameters: The following fields are required.

   RSCS Node ID: Enter the RSCS Node ID from item #9 on the Worksheet. In this example, VM1 is used.
   
   RSCS APPLID: Enter the RSCS APPLID from item #10 on the Worksheet. In this example, RSCSVM1 is used.
   
   RSCS Link ID Enter the RSCS Link ID from item #11 on the Worksheet. In this example OVVMNJE1 is used.
   
   VTAM Logmode: Enter the VTAM Logmode from item #1 on the Worksheet. In this example RSCSNJE1 is used.

   NWSAA Parameters: Complete the following fields if you are using the NLM version of the gateway or if you are using NetWare for SAA as the communications link.

   User ID: If you used CSCON to authorize one or more users to administer NetWare for SAA, you must include one of those users in this field. If you did not authorize any users, enter the name of any NetWare user ID.
   
   Password: Enter the NetWare password for the user included in the NetWare User ID field.
   
   Server ID: Enter the name of the NetWare server where the gateway resides.
   
   LU Name: Enter the NWSAA LU name created through CSCON. This name is created by CSCON. Do not confuse this value with the VTAM LU name used in the Major Node Definition on the mainframe.

Start the Gateway

• Start the NLM Gateway
  
  
• Start the OS/2 Gateway

Start the NLM Gateway
With the gateway software installed and configured, and the gateway defined to the mainframe, you are ready to start the gateway. Before starting the gateway make sure the Message Transfer Agent, is running and COMMEXEC.NLM, and NWSAA.NLM are loaded on the NetWare server.

Standard Syntax
To start the gateway, use the following syntax at the NetWare system console. In the following syntax example, the gateway directory is J:\HEADQ\WPGATE\OVVM41, the NLM resides in SYS:\OVVM41, and both reside on the same server.

load sys:\ovvm41\ovvm /home-sys:\headq\wpgate\ovvm41

The /home option is required. It indicates the location of the gateway directories and files.

Reduced Syntax
You can reduce the startup syntax by completing the following:

• Including a search path pointing to the location of OVVM.NLM in AUTOEXEC.NCF
• Copying OVVM.NLM to SYS:SYSTEM
• Copying OVVM.NLM to a search path

The syntax is then reduced to:

load ovvm /home-sys:\headq\wpgate\ovvm41

Simplified Syntax
You can reduce the syntax further by creating a startup file called OVVM.CFG. A startup file is an ASCII file that includes at least one startup option. For a list of startup options, see Appendix B: Startup Switches. Place the startup file in the same directory with the NLM.

When you start the gateway, the file server displays the gateway operation screen. See Chapter 11: Monitor Gateway Operations for more information about the operation screen.

Start the OS/2 Gateway
Before starting the gateway make sure the Message Transfer Agent is running. You can start the gateway by using the OS/2 icon or from the OS/2 command line. Regardless of how you choose to start the gateway, you must use the /home startup switch. For more information about the startup switches, see Appendix B: Startup Switches.

Start Gateway Using the OS/2 Icon

1. Double-click the GroupWise Gateways folder icon.
   
   
2. Double-click the OVVM Gateway icon.

When you start the gateway, the file server displays the gateway operation screen. See Chapter 11: Monitor Gateway Operations for more information about the operation screen.

Start Gateway from Command Prompt

1. Open an OS/2 window.
   
   
2. Change to the gateway directory. In this example, C:\OVVM41 is used.
   
   You must use the /home startup switch to run the gateway from the command line. The /home switch points the gateway to the gateway directory \WPGATE on the network. To use the /home switch, the syntax is:

   ovvm /home-path to gateway directory

   The syntax for the sample system is:

   ovvm /home-j:\headq\wpgate\ovvm

When you start the gateway, the file server displays the gateway operation screen. See Chapter 11: Monitor Gateway Operations for more information about the operation screen.

* Novell trademark. ** Third-party trademark. See Trademarks for more information.