Configuring the class file on the Sametime server

About this task

Follow these steps to add the class to the Sametime Community Server and configure Sametime for the new file.

Note: When you compile your class file, use Java 1.8 which matches the Domino server version 11.

Procedure

  1. Compile the Java source code file to produce the Java class file.
  2. Copy the compiled class file (StLdapCustomized.class) to the "java" subdirectory of the Sametime server installation directory.
    The default path for the class file is: c:\Program Files\HCL\Domino\java
  3. Use a text editor to open the sametime.ini file, which is stored in the Domino® installation directory.

    In Microsoft™ Windows™, the default location for this file is: C:\Program Files\HCL\Domino

  4. Add or modify the following statements to the [Config] section of the file:
    Make sure your file contains all three statements when you finish:

    ST_JAVA_CLASS_PATH= verify that the custom_class_directory folder is part of this path

    ST_JAVA_JVM_PATH=java_jvm_install_path

    ST_JAVA_CUSTOM_PATH=custom_class_directory

    where: custom_class_directory indicates the path to the new custom Java class.

  5. Save and close the sametime.ini file.
  6. Launch the Notes or Administration client.
  7. Click Open > Application > Open an Application.
    • Server name field: Enter the name of the Sametime Community server.
    • File name field: stconfig.nsf
  8. Double-click the LDAPServer document to open it, then double-click inside the document to place in edit mode.
  9. If you are adding a custom Java class that defines a search filter, click Searching and do the following:
    • In the Search filter for resolving person names settings, enter the class name and method name for a Person filter, using this format: Classname.methodname()

      Following the earlier code example for a Person filter, you would enter StLdapCustomized.peopleResolveFilter() for the new class.

    • In the Search filter for resolving group names settings, enter the class name and method name for a Group filter, using this format: Classname.methodname()

      For example, you might have named your class like this: StLdapCustomized.groupsResolveFilter().

  10. If you are adding a custom Java class that formats search results, locate The attribute of the person entry that defines the user's name settings, and enter the class name and method name, using this format: Classname.methodname()

    Following the earlier code example for formatting search results, you would enter StLdapCustomizedAttributes.displayName(givenName, sn) for the new class.

  11. If you are adding a custom Java class that defines an authentication, policy or business card filter, do the following:

    In the Search filter to use when resolving a user name to a distinguished name settings, enter the class name and method name for this filter, using this format: Classname.methodname()

    Following the earlier code example for this filter, you would enter StLdapCustomized.authenticationFilter() for the new class.

  12. If you are adding a custom Java class that defines a Policy filter, do the following:

    In the GroupMembership settings , enter the class name and method name for a group membership filter, using this format:Classname.methodname().

    Following the earlier code example for a this filter, you would enter StLdapCustomized.groupMembershipFilter() for the new class.

  13. After you have added all of your custom Java classes, click Update.
  14. Restart the Sametime Community Server for the changes to take effect.