Change the password for the web interface

You can change the current password for the python user account, which is used to access the web interface. You can use any of the methods described below. The password must have a minimum of eight valid, printable, ASCII characters.

Note Each device has a unique, default password printed on the device label. If the password is not on the device label, the default password is dbps. If neither these defaults work, the password may have already been updated. Contact your system administrator for help.

Linux command shell

  1. Connect and log in to the XBee Industrial Gateway device.
  2. At the prompt type: passwd
  3. At the Old Password prompt, enter the current password.
  4. At the New Password prompt, enter the new password.

Web interface

  1. Access the XBee Industrial Gateway web interface.
  2. Select Configuration > Authentication.
  3. In the Current Password field, enter the current password.
  4. In the New Password field, enter the new password.
  5. In the Confirm Password field, re-enter the new password.
  6. Click Apply.

RCI from the Linux command shell

  1. Connect and log in to the XBee Industrial Gateway device.
  2. Type the following, replacing NEW_PASSWORD with the new password you wish to use and CURRENT_PASSWORD with your existing password:

    rci_request '<do_command target="set_password"><login>python</login><password>NEW_PASSWORD</password><current_password>CURRENT_PASSWORD</current_password></do_command>'

    Note If the password contains the following characters, you will need to escape those characters following standard Linux shell conventions: ' (apostrophe), < (less than sign), > (greater than sign).

  3. If successful, the following message appears:

    <rci_reply version="1.1"><do_command target="set_password"></do_command></rci_reply>

    If an error is encountered, the following message appears:

    <rci_reply version="1.1"><do_command target="set_password"><error id="4"><desc>Update failed</desc><hint>password</hint></error></do_command></rci_reply>

    You can check the system logs for more information on the error.

RCI from Python

The rci module in Python can process RCI using the process_request method. It accepts as a single argument an RCI request, and returns the response. The set_password request matches the request used in RCI from the Linux command shell (as described above), but wrapped in the rci_request tag.

Copy and enter the code below, replacing NEW_PASSWORD with the new password you wish to use and CURRENT_PASSWORD with the existing password.

<rci_request>
<do_command target="set_password">
<login>python</login>
<password>NEW_PASSWORD</password>
<current_password>CURRENT_PASSWORD</current_password>
</do_command>
</rci_request>

Note The set_password do_command to change the python password is only available in XBee Industirlal Gateway firmware versions 3.2.30.x and newer.

RCI from Digi Remote Manager

  1. From a web browser, log in to Remote Manager.
  2. Select Documentation > API Explorer. The API console appears.
  3. From the API console, select POST HTTP Method and write the following SCI request, as follows:

    <sci_request version="1.0">
    <send_message>
    <targets>
    <device id="{device_id}"/>
    </targets>
    <rci_request version="1.1">
    <do_command target="set_password">
    <login>python</login>
    <password>NEW_PASSWORD</password>
    <current_password>CURRENT_PASSWORD</current_password>
    </do_command>
    </rci_request>
    </send_message>
    </sci_request>

    Where:

    • {device_id} is the ID of your XBee Industirlal Gateway device.

    • NEW_PASSWORD is the new password you want to use.
    • CURRENT_PASSWORD is the existing password.
  4. Click Send.