4.9 Software Directory Management

The Software Directory Management feature lets you manage GroupWise software distribution directories. A software distribution directory is simply an image of the GroupWise DVD or downloaded GroupWise 8 image located on a network server. Diagrams of the contents of software distribution directories are provided in Directory Structure Diagrams in GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure:

From this network location, you can distribute the GroupWise Windows client software to users or install additional GroupWise software such as the Message Transfer Agent, Post Office Agent, Internet Agent, WebAccess, and Monitor.

When you install GroupWise, one software distribution directory is created automatically. Using Software Directory Management, you can create additional software distribution directories, update existing software distribution directories, or delete existing software distribution directories. A single software distribution directory can service multiple post offices and can contain software for multiple platforms.

4.9.1 Creating a Software Distribution Directory

  1. Make sure the directory you want to use as the software distribution directory exists.

    All distribution subdirectories (admin, agents, client, and so forth) will be created under this directory.

  2. Click Tools > GroupWise System Operations > Software Directory Management to display the Software Distribution Directory Management dialog box.

    Software Distribution Directory Management dialog box

    The Software Distribution Directories list includes all software distribution directories defined in your GroupWise system.

  3. Click Create to display the Create Software Distribution Directory dialog box.

    Create Software Distribution Directory dialog box

  4. Fill in the following fields:

    Name: Specify a name to identify the software distribution directory within your GroupWise system. For example, whenever you create a post office, you associate it with a software distribution directory. The software distribution directory’s name, not its location, appears in the list of directories from which you can select. The name can include any characters; there are no restrictions.

    Description: Specify an optional description for the software distribution directory. You might want to use this description to indicate the software version or to give other pertinent information.

    Location: Specify the location where you want to create the software distribution directory. If you specify a path to a directory that does not exist, ConsoleOne creates the directory for you.

    NetWare and Windows:

    In the UNC Path field, specify the location where you want to create a software distribution directory based on the GroupWise 8 DVD or downloaded GroupWise 8 image. The Windows client checks this location for software updates.

    Linux:

    In the Linux Path field, specify the location where you want to create a software distribution directory based on the GroupWise 8 DVD or downloaded GroupWise 8 image. You can use a software distribution directory on Linux as a location from which to install GroupWise Linux software. However, the Linux/Mac client does not perform software updates in the same way that the Windows client does. You can use a software distribution directory on Linux to distribute the Windows client software if you have set up appropriate access to the Linux location for Windows workstations.

    Macintosh:

    The AppleTalk Path field is used only if you are still running the GroupWise 5.2 Macintosh client.

    You can fill in more than one field in order to distribute software for multiple platforms from a single software distribution directory.

    Copy Software From: Select this option to copy GroupWise software to the new directory, then choose from the following source locations:

    • Software Distribution Directory: If you want to copy software from an existing software distribution directory, select this option, then select the software distribution directory. All directories are copied.

    • Path: If you want to copy software from a location that is not defined as a software distribution directory in your GroupWise system (such as the GroupWise 8 DVD or downloaded GroupWise 8 image), select this option, then browse for and select the correct path.

  5. Click OK to create the software distribution directory and add it to the list.

    Software Distribution Directory Management dialog box

  6. Click Close to exit the dialog box.

Each time it starts, the POA checks to make sure it can access all of the software distribution directories in the list. If it encounters a problem accessing any software distribution directory, the POA notifies you of the problem through the POA agent console and the POA log file. This helps ensure that each software distribution directory is always available.

4.9.2 Updating a Software Distribution Directory

  1. Click Tools > GroupWise System Operations > Software Directory Management to display the Software Distribution Directory Management dialog box.

    Software Distribution Directory Management dialog box

    The Software Distribution Directories list includes all software distribution directories defined in your GroupWise system.

  2. Select the software distribution directory to update, then click Update to display the Update Software Distribution Directory dialog box.

    Update Software Distribution Directory dialog box

  3. Fill in the following fields:

    Update by Copying From: Select this option, then choose from the following source locations:

    • Software Distribution Directory: If you want to copy software from an existing software distribution directory, select this option, then select the software distribution directory. All files and subdirectories are copied.

    • Path: If you want to copy software from a location, that is not defined as a software distribution directory in your GroupWise system (such as the GroupWise 8 DVD or downloaded GroupWise 8 image), select this option, then browse for and select the correct path.

    Force Auto-Update Check by GroupWise Components: This option causes the GroupWise Post Office Agent (in client/server access mode) or the GroupWise Windows client (in direct access mode) to check the software distribution directory for a new version of the GroupWise Windows client; if a new version is found, the next time a user starts the GroupWise Windows client, he or she is prompted to update the client software.

    The Force Auto-Update Check by GroupWise Components option is automatically selected when you select the Update by Copying From option. If you don’t select the Update by Copying From option, you can still select this option and then click OK. This forces an auto-update check of the client software version, but the software distribution directory’s files are not updated.

    To determine the current client software version in ConsoleOne, click Tools > GroupWise Diagnostics > Record Enumerations to display a list of records types in the domain database. From the drop-down list, select Areas by ID, select a software distribution directory, then click Info to list detailed information about the software distribution directory. Check the Software Version field to determine the GroupWise client software version.

  4. Click OK to update the directory’s software.

4.9.3 Deleting a Software Distribution Directory

When you delete a software distribution directory, the directory is removed from the file system and no longer appears in the list of software distribution directories. You cannot delete a software distribution directory if any post offices are still configured to access it.

To delete a software distribution directory:

  1. Click Tools > GroupWise System Operations > Software Directory Management to display the Software Distribution Directory Management dialog box.

    Software Distribution Directory Management dialog box

    The Software Distribution Directories list includes all software distribution directories defined in your GroupWise system.

  2. Select the directory to delete, click Delete, then click Yes to confirm the deletion.