Configuring the server to send announcements to clients that do not conform to the minimum
versionAdded by IBM on November 23, 2011 | Version 1 (Original)
|You can use the ST_OLD_CLIENT_VERSION_WARNING_MESSAGE setting in the STSecurity.ini file to provide additional information to users who attempt to log in to the server from Sametime clients running versions earlier than what is allowed by the specified version level.
You can use the ST_OLD_CLIENT_VERSION_WARNING_MESSAGE setting in the STSecurity.ini file to provide additional information to users who attempt to log in to the server from Sametime clients running versions earlier than what is allowed by the specified version level.
About this task
The ST_OLD_CLIENT_VERSION_WARNING_MESSAGE setting configures the server to automatically respond to login requests from clients that do not conform to the server's minimum version level by sending an announcement containing specified text. The message you specify functions as either a warning message or a disconnection notification, depending on whether the value of the ST_MINIMAL_CLIENT_VERSION setting allows logins from earlier clients. If the ST_MINIMAL_CLIENT_VERSION setting allows logins, use the text of the message to warn users that they need to upgrade and to explain how to obtain and install the client upgrade. If the ST_MINIMAL_CLIENT_VERSION setting does not allows logins, use the text of the message to explain why login was denied.
Note the following before you configure the settings in the STSecurity.ini file:
- All platforms - Double-byte characters are not allowed in the message text or sender name.
- All platforms - If you want to use accented characters (for example, Æ,é,ä,ñ) in the message text or sender name, you should use Notepad on a Windows client or server to edit the file. When you finish making your changes with Notepad, save the STSecurity.ini file as a UTF-8 file (select File-Save As And specify UTF-8 as the Encoding option, then save the file).
- IBM i platform only - It is recommended that you map a network drive to make the STSecurity.ini file on the server accessible from your workstation. Then you can run Notepad from your workstation and update the file directly on your IBM i server. (By default, the file is located in the Sametime installation folder, for example, C:\Lotus\Domino\STSecurity.ini).
Alternatively, you can copy the file from the IBM i server to your client workstation using any convenient means (for example, dragging and dropping from IBM i Navigator or FTP), edit the file on your workstation using Notepad, and then copy the updated file back to the server.
- IBM i platform only - When you have updated the file on your IBM i server, ensure that the file is owned by QNOTES. To update the file ownership, run the following command:
CHGOWN OBJ('server_data_directory/stsecurity.ini') NEWOWN(QNOTES)
Use the following procedure to configure the server to send an announcement to users who attempt to log in from client versions earlier than the specified minimum.
Parent topic: Supporting older Sametime clients during migration
- Use a text editor to open the STSecurity.ini file. By default the file is located in the Sametime installation folder, for example, C:\Lotus\Domino\STSecurity.ini.
|null||(Default) Do not send an announcement.|
|text||Specifies the text of the announcement that is sent in response to login requests from clients that do not conform to the server's security level.|
The ST_FORCE_LOGOUT_OLD_CLIENT_VERSION setting determines whether or not users of old clients are allowed to stay logged in to the community. By default, when this setting is true (a value of 1), old client versions are disconnected. When the setting is false (a value of 0), the users of old clients remain online an usually a message is sent to them.
If the ST_FORCE_LOGOUT_OLD_CLIENT_VERSION setting is set to 0 (allow logins from client versions earlier than the specified minimum), and you provide a value for ST_OLD_CLIENT_VERSION_WARNING_MESSAGE, the text you provide serves as a warning message. The server allows the login and then sends the specified text. You can use the message to provide users with information on upgrading. For example, you can include an address that specifies the location of a download site. After receiving the announcement with the address link, users can click the address link to open the link location.
Note: The VP_SECURITY_ALLOW_USER setting was renamed ST_FORCE_LOGOUT_OLD_CLIENT_VERSION in Sametime 8.5. In order to smooth migration, ST_FORCE_LOGOUT_OLD_CLIENT_VERSION overrides VP_SECURITY_ALLOW_USER from prior versions. If it is not present, then its default value will be 1 and VP_SECURITY_ALLOW_USER or its own default value takes affect.
To include non-ASCII characters in the message text, save the STSecurity.ini file in UTF-8 format.
- Save and close the file.