Systemwalker Desktop Patrol Installation Guide

4.2.3 Procedures for Version Upgrade of SS

4.2.3.1 Restrictions and Notes

• The IP address and host name must have the same values in the pre-upgrade environment and post-upgrade environment.

• To upgrade in an environment where the Systemwalker Desktop Patrol SS coexists with the Systemwalker Desktop Keeper Relay Server, it is necessary to first uninstall both SS and the Relay Server, and then install the products starting from the one with the newer version.

• If CS and SS coexist, back up SS before upgrading the CS version.

• It is not possible to upgrade from V15.0.0 or earlier if a certificate for which DSA was specified as the key generation algorithm has been registered in the Relay Server.
  Refer to "Settings for HTTPS communication" in the Installation Guide and create the RSA certificate again using the key generation algorithm before performing the upgrade.

4.2.3.2 Version Upgrade from V14.3.0/V14.3.1

1. Back up SS.

   Refer to the following for details:

   "Data to be Backed up/Restored and Backup/Restoration Methods" in the Installation Guide

2. Uninstall SS.

   Refer to the following for details:

   "Uninstall SS" in the Installation Guide

3. Install SS again.

   Refer to "2.8.1 Install SS" for details.

4. Copy the file (config.properties) backed up in V14.3.0 or V14.3.1 to the following restoration destination:

   ssInstallDir\etc\config.properties

5. Configure the operating environment for SS.

   For each smart device (Android or iOS), configure as described in the sections below.

4.2.3.2.1 Configuration based on managed smart devices

Configure the settings below based on the operating system of the managed smart device.

Android

1. Enable management of Android devices.

   Execute swss_config.exe (SS environment setup command) with the /Android.enabled option.

2. Configure the settings for HTTPS communication and build the certificate environment.

   Refer to "4.2.3.2.2 Settings for HTTPS communication" for details.

   This step is also performed if iOS devices are managed. If managing both Android and iOS devices, perform this step only once.

3. Execute SWDTP_ctrl.exe (batch starting/stopping services command) to start Systemwalker Desktop Patrol.

iOS

Point

Steps 1 to 4 can be performed in a single command execution.

Note

Notes regarding coexistence with the Systemwalker Desktop Keeper Relay Server

• The following options of swss_config.exe (SS environment setup command) in steps 1 to 5, are only used in Systemwalker Desktop Patrol.

  • /cs.host

  • /cs.port

  • /Android.http.port

  • /Android.https.port

  • /Android.enabled

  • /usercert.enabled

  • /iOS.enabled

• The following options of swss_config.exe are common options also used in Systemwalker Desktop Keeper.

  • /iOSmgr.host

  • /iOSmgr.port

  • /iOS.profile.port

  • /iOS.https.port

  • /iOS.connect.host

  • /iOS.connect.port

  • /iOS.connect.profile.port

• The items set in steps 6 and 7 are also used in Systemwalker Desktop Keeper.

• For items also used in Systemwalker Desktop Keeper, specify the same values in both products.

  After the common items are set in Systemwalker Desktop Patrol, specifying different values in the items in Systemwalker Desktop Keeper will result in the settings initially configured in this product changed to the new values specified in Systemwalker Desktop Keeper.

  Conversely, after the common items are set in Systemwalker Desktop Keeper, specifying different values in the items in this product will result in the settings initially configured in Systemwalker Desktop Keeper changed to the new values specified in this product.

1. Enable management of iOS devices.
   Execute swss_config.exe (SS environment setup command) with the /iOS.enabled option.

2. Specify the IP address or host name of CS.
   Execute swss_config.exe with the /cs.host option.

3. Specify the server or reverse proxy to be connected from iOS devices.
   Execute swss_config.exe with the /iOS.connect.host, /iOS.connect.port, and /iOS.connect.profile.port. options.

4. Specify the IP address or host name of the iOS management database.
   Execute swss_config.exe with the /iOSmgr.host option.

   If iOS devices are being managed only by Systemwalker Desktop Patrol, specify CS.

   But if they are also being managed by Systemwalker Desktop Keeper, specify either CS or the Systemwalker Desktop Keeper management server that is operating the iOS management database. Once set, do not change this value.

5. If necessary, change the port number.
   Refer to "How to Modify the Port Number" in the Reference Manual for details.

6. Configure the settings for HTTPS communication and build the certificate environment.
   Refer to "4.2.3.2.2 Settings for HTTPS communication" for details.
   This step is also performed if Android devices are managed. If managing both Android and iOS devices, perform this step only once.

7. Execute swss_ImportAppleCert.bat (registering Apple Inc. certificates command) to install the MDM certificate prepared in "2.2 Advance Preparation".

8. Execute SWDTP_ctrl.exe (batch starting/stopping services command) to start Systemwalker Desktop Patrol.

4.2.3.2.2 Settings for HTTPS communication

To use HTTPS communication between SS and the smart device CT, configure the settings as shown below. The configuration procedure differs depending on whether HTTPS communication was performed in V14.3.0 or V14.3.1.

Note

If this product coexists with the Relay Server of Systemwalker Desktop Keeper V15.0.0 or later and a certificate is registered in Systemwalker Desktop Keeper after another certificate is registered in Systemwalker Desktop Patrol, then the certificate registered in Systemwalker Desktop Keeper will be the one used for HTTPS communication between iOS smart devices and SS.

If HTTPS communication was performed in V14.3.0 or V14.3.1

1. Execute SWDTP_ctrl.exe (batch starting/stopping services command) to stop Systemwalker Desktop Patrol.

2. Execute swss_importcert.exe (registering certificates command) to register the CA certificate that was backed up in V14.3.0 or V14.3.1.

3. Execute swss_keystore.exe (backing up and restoring server certificates command) to restore information on the server certificate that was backed up in V14.3.0 or V14.3.1.

If HTTPS communication was not performed in V14.3.0 or V14.3.1

Refer to "Settings during installation" in "2.8.2.2 Settings for HTTPS Communication" and configure the settings.

Refer to the Reference Manual for details on these commands.

4.2.3.3 Version Upgrade from V15.0.0

1. Back up SS.

   Refer to the following for details:

   "Data to be Backed up/Restored and Backup/Restoration Methods" in the Installation Guide

2. Uninstall SS.

   Refer to the following for details:

   "Uninstall SS" in the Installation Guide

3. Install SS again.

   Refer to "2.8.1 Install SS" for details.

4. Execute SWDTP_restore.exe (batch restore command) to restore Systemwalker Desktop Patrol.

5. Configure the operating environment for SS.

   For each smart device (Android or iOS), configure as described in the sections below.

4.2.3.3.1 Configuration based on managed smart devices

Configure the settings below based on the operating system of the managed smart device.

Android

1. Enable management of Android devices.
   Execute swss_config.exe (SS environment setup command) with the /Android.enabled option.

2. Execute SWDTP_ctrl.exe (batch starting/stopping services command) to start Systemwalker Desktop Patrol.

iOS

Point

Steps 1 to 4 can be performed in a single command execution.

Note

Notes regarding coexistence with the Systemwalker Desktop Keeper Relay Server

• The following options of swss_config.exe (SS environment setup command) in steps 1 to 5, are only used in Systemwalker Desktop Patrol.

  • /cs.host

  • /cs.port

  • /Android.http.port

  • /Android.https.port

  • /Android.enabled

  • /usercert.enabled

  • /iOS.enabled

• The following options of swss_config.exe are common options also used in Systemwalker Desktop Keeper.

  • /iOSmgr.host

  • /iOSmgr.port

  • /iOS.profile.port

  • /iOS.https.port

  • /iOS.connect.host

  • /iOS.connect.port

  • /iOS.connect.profile.port

• The items set in steps 6 and 7 are also used in Systemwalker Desktop Keeper.

• For items also used in Systemwalker Desktop Keeper, specify the same values in both products.

  After the common items are set in Systemwalker Desktop Patrol, specifying different values in the items in Systemwalker Desktop Keeper will result in the settings initially configured in this product changed to the new values specified in Systemwalker Desktop Keeper.

  Conversely, after the common items are set in Systemwalker Desktop Keeper, specifying different values in the items in this product will result in the settings initially configured in Systemwalker Desktop Keeper changed to the new values specified in this product.

1. Enable management of iOS devices.
   Execute swss_config.exe (SS environment setup command) with the /iOS.enabled option.

2. Specify the IP address or host name of CS.
   Execute swss_config.exe with the /cs.host option.

3. Specify the server or reverse proxy to be connected from iOS devices.
   Execute swss_config.exe with the /iOS.connect.host, /iOS.connect.port, and /iOS.connect.profile.port. options.

4. Specify the IP address or host name of the iOS management database.
   Execute swss_config.exe with the /iOSmgr.host option.

   If iOS devices are being managed only by Systemwalker Desktop Patrol, specify CS.

   But if they are also being managed by Systemwalker Desktop Keeper, specify either CS or the Systemwalker Desktop Keeper management server that is operating the iOS management database. Once set, do not change this value.

5. If necessary, change the port number.
   Refer to "How to Modify the Port Number" in the Reference Manual for details.

6. Configure the settings for HTTPS communication and build the certificate environment.
   Refer to "2.8.2.2 Settings for HTTPS Communication" for details.
   This step is not necessary if HTTPS communication was performed in V15.0.0.

7. Execute swss_ImportAppleCert.bat (registering Apple Inc. certificates command) to install the MDM certificate prepared in "2.2 Advance Preparation".

8. Execute SWDTP_ctrl.exe (batch starting/stopping services command) to start Systemwalker Desktop Patrol.

Refer to the Reference Manual for details on these commands.

4.2.3.4 Upgrading from V15.0.0A or Later

1. Back up SS

   Refer to the following for details:

   "Data to be Backed up/Restored and Backup/Restoration Methods" in the Installation Guide

2. Uninstall SS.

   Refer to the following for details:

   "Uninstall SS" in the Installation Guide

3. Install SS again.

   Refer to "2.8.1 Install SS" for details. Specify the same path used for the installation before upgrade.

4. Enable the management of the Android or iOS devices.

   Execute swss_config.exe (SS environment setup command) with the /Android.enabled or /iOS.enabled option.

5. Execute SWDTP_restore.exe (batch restore command) to restore Systemwalker Desktop Patrol.

6. Execute swss_ImportAppleCert.bat (registering Apple Inc. certificates) to install the MDM certificate prepared in "2.2 Advance Preparation".

7. Execute SWDTP_ctrl.exe (batch starting/stopping services command) to start Systemwalker Desktop Patrol.

Refer to the Reference Manual for details on these commands.