More Configurations

This page provides information on the command line utility you can use with Hipchat Server and describes other configurations you can do on Hipchat Server. 

Hipchat command line utility

You can do a variety of actions, like upgrade, export your data, control networking, and more in Hipchat Server's command line interface (CLI). 

To see the list of available commands type hipchat at the admin@hipchat prompt:

admin@hipchat:~$ hipchat

 

The Hipchat CLI also includes a namespace called labs which we'll use to distribute beta versions of command-line-only tools for you to use. For more details, see Hipchat Labs.

tip/resting Created with Sketch.

For help using any of the commands, type the command like hipchat upgrade at the prompt:

admin@hipchat:~$ hipchat upgrade

The Hipchat Server CLI returns explanations of all the arguments available for the command.

 

Setting network time

Hipchat Server uses network time protocol (NTP) with the following default servers:

  • 0.atlassian.pool.ntp.org
  • 1.atlassian.pool.ntp.org

To change the servers, type the following command:

hipchat service --ntp-servers time1.example.com,time2.example.com

where time1.example.com,time2.example.com are the servers you want to use

Configuring email notifications

You can configure email notifications via the hipchat email utility: 

  • To show the current settings: 

    hipchat email -w
  • To show the help menu and what can be changed: 

    hipchat email -h 
  • For example, to change the sender email and the sender name to respectively hipchat@example.com and Hipchat Notifications:

    hipchat email -s hipchat@example.com -n "HipChat Notifications"

Enabling monitoring

You can configure Hipchat Server with a recipient email address for system alerts using the OVF alerts email property or the command line.

To configure email alerts through the command line, open the command line and enter:

hipchat email --alerts-email alerts@example.com

Expand for a list of alert triggers...

An alert email is sent when any of the following conditions are met:

System Utilization

  • Memory utilization over 98% for three cycles
  • Swap file utilization over 10% for three cycles
  • CPU (user) utilization over 95% for three cycles
  • CPU (system) utilization over 95% for three cycles
  • CPU (wait) utilization over 99% for three cycles

Services

  • 'gearman' over 30% CPU utilization
  • 'mysql' becomes unavailable after three attempts within five cycles
  • 'nginx' over 20% CPU utilization for five cycles
  • 'ntpd' becomes unavailable
  • 'php5' restarts three times within five cycles
  • 'punjab' unavailable for three cycles, or over 45% CPU for three cycles
  • 'redis' unavailable three times within five cycles, or over 35% CPU for three cycles
  • 'rsyslog'  over 75% CPU for three cycles

Hipchat Server implements SNMP v2c using standard Ubuntu MIBs that can be enabled by the command line. 

  • To turn SNMP on or off, type:
    hipchat service -n "on" OR "off"
  • To set up the community string, type:
    hipchat service -c <communitystring>
    Example: hipchat service -c public
  • To add TRAP recipient server list, type:

    hipchat service -t trap.server.com
    Example: snmp1.exmaple.com,snmp2.example.com

    Note: Add \ prior to a special character as in dollar\$ign 

Enabling SMS notifications

To enable your users to receive SMS Notifications, use a Twilio account. 

  1. Start a Twilio trial or log into your Twilio account.
  2. In the Hipchat Server web interface, click Server admin > Notifications.
  3. In the fields provided, paste your Twilio credentials and phone number.
  4. Click Modify.
  5. To test SMS notifications, click Account settings, then Notifications in the left menu.
  6. Next to SMS, click Add phone.

Disabling phone-home signal

Hipchat Server sends a daily heartbeat “phone home” to help Atlassian improve the product. This can be disabled at the command line by running this command:

hipchat license --phone-home off 

Last modified on Nov 30, 2017

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.