Home
HCL Sametime® Administration Guide 12.0.1
Configuring
This section provides information on configuring the HCL Sametime server. Configuration tasks are dependent on the deployment environment.
Monitoring your meeting and chat metrics with Grafana
Sametime uses the third-party software, Grafana, to generate insightful graphs and visualizations derived from time-series database (TSDB) data. This section covers the steps on how to use Grafana in your Sametime environment.
Configuring Kubernetes to run Grafana

HCL Sametime® Administration Guide 12.0.1
- Accessibility features for Sametime
  Accessibility features help users who have a disability, such as restricted mobility or limited vision, use information technology products successfully. HCL® strives to provide products with usable access for everyone.
- What's new
  HCL Sametime and HCL Sametime Premium 12.0.1 provide many new features, enhancements and fixes to servers and clients. Additional releases to version 12.0.1 also provides updates to the product.
- Planning
  This section describes the system requirements and server configurations needed for HCL Sametime and HCL Sametime Premium.
- Installing
  This section provides information on installing the servers for Sametime and Sametime Premium.
- Configuring
  This section provides information on configuring the HCL Sametime server. Configuration tasks are dependent on the deployment environment.
  - Adding corporate branding to meeting pages
    You can customize meetings to reflect your company's branding and visual presence.
  - Adding virtual backgrounds to the global library
    By default, you can customize your meetings with virtual backgrounds. As an administrator, you can choose which backgrounds are available to all users.
  - Configuring alternate STUN servers
    Sametime Meetings uses public Google STUN servers by default. To use different STUN servers, you must complete this procedure before installing Sametime Meetings.
  - Setting up business cards
    You can configure the Sametime server so that business card information about an individual displays when a user hovers over a name in a chat window or a contact list. Business card information also displays at the top of an active chat window.
  - Configuring LDAP
    Sametime supports LDAP directory servers as the user repository.
  - Updating the time-to-live index for persistent chat
    The time-to-live (TTL) setting defines how long the chat history is stored in the database. The default value is 90 days. However, administrators can update the value based on the organization's preferred setting.
  - Managing secrets in Kubernetes
    Sensitive information such as passwords, service account names, certificates, and other confidential data needed by Sametime pods are stored in secrets. In addition to helm charts and configuration map, the Sametime configuration is also derived from secrets.
  - Applying configuration changes in Docker or Podman
    Configuration files contain environment variables that can be changed and applied to the Sametime server.
  - Applying configuration changes in Kubernetes
    Configuration files contain environment variables that can be changed and applied to the Sametime server.
  - Chat
    This section contains Chat configuration considerations.
  - Meetings
    This contains configuration steps specific to the HCL Sametime Meetings server.
  - Integrating with other applications
    Integration with an application such as Verse prior to Sametime 12.0 requires the legacy web-client interface. Beginning in Sametime 12.0 the legacy web-client is not enabled by default, but can enabled when needed for integration with other products.
  - Monitoring your meeting and chat metrics with Grafana
    Sametime uses the third-party software, Grafana, to generate insightful graphs and visualizations derived from time-series database (TSDB) data. This section covers the steps on how to use Grafana in your Sametime environment.
    - Configuring Docker and Podman to run Grafana
    - Configuring Kubernetes to run Grafana
  - Push messaging through a proxy
    Depending on your network settings, your firewalls could prevent Sametime proxy from connecting to push networks like Apple Push Notification Service (APNS) and Firebase Cloud Messaging (FCM) through the Internet. Sametime supports the sending of APNS and FCM messages through a proxy server. If you need to send APNS or FCM message through a proxy server in your environment, you need to configure the settings for the messages you want routed through the proxy.
- Securing
  This section provides information on securing your HCL Sametime environments.
- Administering
  This section provides information on administering on Sametime environments.
- Troubleshooting
  This section provides information on troubleshooting and supporting Sametime environments.
- Uninstalling Sametime
  In the event that Sametime must be removed, follow the procedure for the platform that Sametime is installed on.
- Migrating and Upgrading
  This section provides information on migrating data from an earlier release to Sametime 12.
- Notices

Configuring Kubernetes to run Grafana

Before you begin

Install Prometheus. For more information, refer to Installing Prometheus.

Install Grafana in your Kubernetes cluster. For the installation details, refer to Deploying Grafana on Kubernetes. To check if the service was created correctly, run

kubectl get svc -n
                        monitoring

. A list of all the services is displayed. Ensure that the Grafana type is ClusterIP and the port is 3000. Below is an example.


Name	Type	Cluster-IP	External-IP	Port	Age
grafana	ClusterIP	10.97.236.243	<none>	3000/TCP	7m2s

About this task

Before you can create your first dashboard, you need to add your data source.

Note: Only users with the organization Admin role can add data sources.

To run Grafana and import your dashboard, follow these steps:

Procedure

Enable port forwarding for the Grafana service.

kubectl port-forward service/grafana 3000:3000 -n monitoring

When using a remote setup, navigate to the Grafana sign-in page in your browser.
```
<Cluster-IP>:3000
```
Note: 3000 is the default port for Grafana. Alternatively, you can use localhost:3000 if you are on a local machine.
Enter admin for both username and password, and then select Sign In. If successful, you will be prompted to change the password.
Select OK and enter the new password.
From the left panel, hover over + Create and select Import.
Upload the K8_Sametime_Dashboard.json file. For more information, contact HCL Customer Support.

Note: K8_Sametime_Dashboard.json is included in the Sametime Premium install archive. The .json is visible only after unzipping the folder.
Select Prometheus (default) as data source and then select Import.
Save the dashboard.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.