Enabling AutoUpdate

AutoUpdate can occur whether users have a mapped drive or IP connection to the software distribution directory. If users have a mapped drive to the software distribution directory, make sure they have Read and Scan rights to the software_distribution_directory\client and software_distribution_directory\client\win32 directories.

If you are going to use AutoUpdate over an IP connection, copy software_distribution_directory\admin\utility\setupip\setupip.fil to an HTTP web server, or copy the entire client directory to the HTTP web server.

For GroupWise 6 Support Pack 1, setupip.fil is not included in the support pack image because of its size (over 44 MB). This file must be downloaded separately from Novell Software Downloads and copied to software_distribution_directory\admin\utility\setupip.

IMPORTANT:  To install the GroupWise client using AutoUpdate, you must first make sure GroupWise 6 Administration and GroupWise 6 agents have been installed, and that administration, agent, and client software has been updated.

In the following procedure, steps 1-4 apply only if you will be using an IP connection for AutoUpdate.

  1. Run software_distribution_directory\admin\utility\setupip\writeip.exe.

    Specify an IP location for setupip.fil (or the IP location of the software distribution client subdirectory). For example, you can specify:

    http://151.155.135.122/gw6/client

    or

    http://intranet.company.com/software/gw6/gwclient

    You can include proxy and port information, for example:

    http://name.mycompany.com/software/gw6/client;proxy.place.mycompany:1690

    You can specify up to five locations. During AutoUpdate, each location is checked, in order, until a connection is made.

    If you select Choose IP Address at Random, the order in which the locations are checked is selected randomly when AutoUpdate occurs. This will balance the load on the web server.

  2. Specify other options, such as the location for downloading the client installation files (setupip.fil or the client subdirectory files).

    You can have files downloaded to a temporary or specific directory.

    If you select Allow the User to Change the Download Directory, the user is prompted for the location of the download directory and can change the default location.

  3. Click OK.

    Setupip.exe is created. writeip.ini is also created, which stores the options you selected in writeip.exe.

  4. Copy setupip.exe to the software_distribution_directory\client\win32 directory.

  5. Make a backup copy of software_distribution_directory\client\setup.cfg.

  6. Using an ASCII text editor, edit the setup.cfg file entries with the values you want.

    1. Under the [AutoUpdate] heading, specify

      Enabled=Yes

    2. Specify

      ForceUpdate=Yes

      if you want GroupWise to automatically update the users' client software

      or

      ForceUpdate=No

      if you want users to be prompted to update their client software.

    3. Specify the number of grace logins you want to allow a user before forcing an AutoUpdate, for example:

      GraceLoginCount=2

      This entry is ignored if ForceUpdate=No.

    4. If you will be using an IP connection for AutoUpdate, specify

      SetupIPEnabled=Yes

  7. Save the file as setup.cfg. Copy setup.cfg from software_distribution_directory\client to software_distribution_directory\client\win32.

  8. If necessary, modify the addon.cfg files with the values you want. See Modifying Addon.cfg for more information.

  9. Log in to ConsoleOne as an Admin equivalent.

  10. Click Tools > GroupWise System Operations.

  11. Double-click Software Directory Management.

  12. Click the software distribution directory, then click Update.

  13. Select Force Auto-Update Check by GroupWise Components.

    This causes the GroupWise client to check for a new version. 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. If you have set ForceUpdate=Yes, the user will not be prompted before installation begins. If a mapped drive to the software distribution directory is found, the client software is installed from the mapped drive. If a mapped drive to the software distribution directory is not found, GroupWise looks at the IP locations you specified in writeip.ini and installs the client software.

    In the event that no connection to the software distribution directory can be made, the file setupip.err is created in c:\windows of the user's workstation. This file explains why none of the connections could be made.