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 CDs located on a network server. Diagrams of the contents of software distribution directories are provided in Directory Structure Diagrams in GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure:

From this network location, you can distribute the GroupWise 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.

The preferred configuration is to create a software distribution directory on each server where one or more post offices are located. When you use this configuration, the POA for a post office does not need to access a remote server when performing Windows client software updates, as described in Section 66.1, Using GroupWise AutoUpdate and SetupIP to Distribute the GroupWise Windows Client.

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 7 Administrator and Client (NetWare/Windows) CDs. 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 7 Administrator and Client (Linux) CDs. The Cross-Platform client checks this location for software updates for both the Linux and Macintosh versions of the Cross-Platform client.

    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 CDs), 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 CDs), 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 client (in direct access mode) to check the software distribution directory for a new version of the GroupWise client; if a new version is found, the next time a user starts the GroupWise 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 record 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.

To delete a software distribution directory:

  1. Make sure that no post offices still have the software distribution directory assigned to them.

    If you try to delete a software distribution directory that is still in use, an error notifies you. The software distribution directory is assigned on the Post Office Settings property page of each Post Office object.

  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. Select the directory to delete, click Delete, then click Yes to confirm the deletion.