Bradmin Professional 4: User'S Guide
Bradmin Professional 4: User'S Guide
User’s Guide
ENG
Version A
Copyright
©2019 Brother Industries, Ltd. All rights reserved.
Information in this document is subject to change without notice. The software described in this document is
furnished under a license agreement. The software may be used or copied only in accordance with the terms of
those agreements. No part of this publication can be reproduced in any form or by any means without prior written
permission of Brother Industries, Ltd.
Trademarks
Brother is either a trademark or a registered trademark of Brother Industries, Ltd.
Any trade names and product names of companies appearing on Brother products, related documents and any
other materials are all trademarks or registered trademarks of those respective companies.
Important Note
Some functions may not be available depending on the model.
i
Table of Contents
1 Introduction............................................................................................................................................. 1
1.1 Overview .................................................................................................................................. 1
1.2 System Requirements .............................................................................................................. 2
2 Manage Devices..................................................................................................................................... 3
2.1 Discover New Devices ............................................................................................................. 3
2.2 Group and Filter Devices.......................................................................................................... 4
2.3 View Device Status .................................................................................................................. 4
2.4 Perform Actions and Tasks ...................................................................................................... 4
3 Actions.................................................................................................................................................... 5
3.1 Get Device Status .................................................................................................................... 5
3.2 Open Web Interface ................................................................................................................. 5
3.3 Add Devices to Groups ............................................................................................................ 5
3.4 Remove Devices from Groups ................................................................................................. 5
3.5 Export the Details of Selected Devices .................................................................................... 5
3.6 Delete Devices from the Device List ........................................................................................ 5
4 Instant Tasks .......................................................................................................................................... 6
4.1 Password Settings.................................................................................................................... 6
4.2 Update Device Firmware.......................................................................................................... 6
4.3 Reboot Devices ........................................................................................................................ 7
4.4 Edit Device Settings ................................................................................................................. 7
4.5 Activate Custom Software Solutions ........................................................................................ 7
4.6 Send Files to Devices............................................................................................................... 8
4.7 Back Up Settings ...................................................................................................................... 8
4.8 Reset Network Settings ............................................................................................................ 9
5 Scheduled Tasks .................................................................................................................................. 10
5.1 Device Log ............................................................................................................................. 10
5.2 Device Notification.................................................................................................................. 10
5.3 Device List .............................................................................................................................. 10
5.4 Device Master Settings .......................................................................................................... 10
5.5 Assign Device Log/Device Notification Profiles ...................................................................... 11
6 Task Monitoring .................................................................................................................................... 12
6.1 Check the Task Status ........................................................................................................... 12
6.2 Monitor Tasks ......................................................................................................................... 13
6.3 Autoconfiguration ................................................................................................................... 14
7 Application Settings .............................................................................................................................. 16
7.1 General................................................................................................................................... 16
7.2 Configure the Device Discovery Settings ............................................................................... 16
7.3 Configure the Network Settings.............................................................................................. 18
7.4 Configure the Email Server Settings ...................................................................................... 18
7.5 Secure the Application with a Password ................................................................................ 18
7.6 Device Master Settings .......................................................................................................... 19
7.7 Create a Device Log Profile ................................................................................................... 19
7.8 Create a Device Notification Profile........................................................................................ 20
ii
7.9 Create a Device List Profile .................................................................................................... 21
7.10 Information ........................................................................................................................... 21
7.11 Back Up and Restore the Application's Settings and Data................................................... 21
8 Troubleshooting and Support ............................................................................................................... 22
8.1 If You Cannot Discover the Device ........................................................................................ 22
8.2 Insufficient Access Permissions ............................................................................................. 22
8.3 Troubleshooting...................................................................................................................... 23
iii
1 Introduction
1.1 Overview
BRAdmin Professional 4 is an application for managing devices and monitoring their status.
● Devices
This screen appears upon startup and displays the device names, device status, and other information.
- To create device groups, click New group in the left pane.
- To create smart filters, click New smart filter in the left pane.
- To perform actions or execute tasks, select one or more devices, and then select the action or task you want
from the right pane.
● Tasks
View a list of tasks, in-progress or pending, as well as a log of completed tasks. Select a specific task from the list
to view more information and available actions in the right pane.
1
To expand the list of available actions or tasks in the right pane, click Show all.
● Application Settings
Click in the upper-right to change the application settings and to create or edit task profiles.
2
2 Manage Devices
Click Devices in the top menu bar to display the Device list where you can manage your devices.
To schedule automatic device discovery, configure the schedule settings in Application settings >
Device discovery.
Click Discover devices to add any new network-connected and USB-connected Brother devices to the
device list based on the discovery method and settings. For more information, see 7.2 Configure the Device
Discovery Settings.
- Discover Specific Devices
• To find specific devices in the list, enter a keyword in the search box.
• To update the device status, click .
Click Discover specific devices… to add a specific network-connected device (based on its IP or node
name) or USB-connected device (Keyboard Shortcut: Insert).
3
2.2 Group and Filter Devices
Create a device group or filter in the left pane, and then select it to list specific devices:
- Smart filters
Select devices that meet the criteria of the smart filter. Click New smart filter and list the criteria you want in the
Conditions: field, such as model name, serial number, or location. You can also import a specific text file listing
the filtering criteria you want.
- Groups
Select the devices you grouped together. To add a device to an existing group, select the target device and click
Add to groups in the right pane. For more information, see 3.3 Add Devices to Groups.
Ready
Connection error
Attention
Error
Unconfigured device
• To view information about a single device, select it, and then click Details in the right pane.
• The available actions and tasks may vary depending on the selected device.
For more information about the right pane, see 1.1 Overview.
4
3 Actions
Perform the following actions by right-clicking the device and selecting the option you want or by selecting the
device and using the right pane:
The CSV files list only the items visible in the Device list, according to their order.
5
4 Instant Tasks
Perform the following Instant tasks by right-clicking on the device and selecting the task you want or by selecting
the device and using the right pane:
• Unlike scheduled tasks, Instant tasks take immediate effect. For more information, see 5 Scheduled Tasks.
• (Network-Connected Devices only) You must have the selected device's password to perform an instant
task.
• If an instant task is unavailable for the selected machine, it may not be supported.
If the “Already set” error occurs, the password has already been used. Try a different new password.
Avoid using the following passwords as your administrator password:
• access
• initpass
• The "Pwd" located on the back of your machine
To check for the latest firmware version without automatically updating it, clear the Update to the latest
version. check box.
6
4.3 Reboot Devices
1. Select one or more devices.
2. Click Reboot device.
3. Type the Device password for password-protected devices.
4. Click Reboot device.
7
3. Do one of the following:
If you have a license file: Select the License file: radio button, and then type the file name in the field below, or
click the Browse… button to select the license file.
If you have license codes: Select the License code (20 digit number): radio button, and then type the license
codes in the field below.
Multiple codes can be entered, one license code per line.
4. Click the Browse… button next to the Save the result file to: field and specify where to save the result file.
You can also copy and paste folder paths into this field.
5. Click Apply.
To send device settings files such as EDPK files, a device password is required.
To save the settings of the target device as a DPK file, or an encrypted EDPK file, do the following:
1. Select one or more devices.
2. Click Back up settings in the right pane.
3. Click the Browse… button next to the Save to: field and specify where to save the backed-up settings file. You
can also copy and paste folder paths into this field.
8
4. In the Backup setting items: field, select either All, or Selected: to specify the necessary items.
5. Click Back up.
• Do not change the file name if you want to deploy the backup file via a USB flash drive.
USB deployments require a specific file name format.
• To perform this task, a device password is required.
9
5 Scheduled Tasks
The following tasks provide you with the necessary device information according to the predetermined schedule.
10
5.5 Assign Device Log/Device Notification Profiles
To perform the Device log/Device notification tasks, assign a task profile to one or more devices.
1. Select one or more devices from the Device list. The right pane appears.
2. Click Settings from either the Device log or Device notification menu.
3. Select the profile you want to assign from the Profiles: field.
4. Click Apply.
11
6 Task Monitoring
To monitor the status of active tasks and check the results of completed tasks, click Tasks in the top menu bar.
The following task categories are listed in the left pane:
- Instant tasks
- Device log
- Device notification
- Device list
- Device master settings
- Autoconfiguration
The number displayed next to each task category indicates the number of active tasks.
• To filter the tasks in the Task log by status, select the status from the Task log drop-down list.
• To search for a task in the Task log, enter its keyword in the search box.
• The notification icon and footer area indicate whether you have a newly created task. The footer also
indicates whether an Action is ongoing or completed and if an error has occurred.
Notification Icon
12
6.2 Monitor Tasks
To monitor, stop, or retry Instant tasks, click Instant Tasks and then do one of the following:
1. Select an active task in the Current task field and click one of the following in the right pane:
• Details: Check the task’s status and details.
• Stop: Stop the task.
2. Select a completed or interrupted task in the Task log field and click one of the following in the right pane:
• Details: Check the status of completed tasks or try to perform a task again if it was interrupted by an error.
• Delete: Delete a task.
To manage tasks, click Device log, Device notification, Device list, or Device master settings and then do one
of the following:
1. Select an active or inactive task profile in the Current task field and click one of the following in the right pane:
• Settings: Display and edit the task’s settings.
• Send test Email: Send a test email.
• Deactivate/Activate: Deactivate active tasks or activate inactive tasks.
• Run now: Run the task immediately.
2. Select a completed or interrupted task profile in the Task log field and click one of the following in the right
pane:
• Details: Check the status of completed tasks.
• Open application log: Check the task details.
• Delete: Delete the selected Task log item.
13
6.3 Autoconfiguration
Use this task to find devices that meet the set criteria and automatically configure them (for example, Password
settings and Update firmware). You can also schedule discovery by selecting a specific day and time.
Unlike the other profiles created in Application settings, the Autoconfiguration profiles are created by opening
the Tasks screen, and then clicking New autoconfiguration task….
You can monitor the existing Autoconfiguration tasks in the Tasks screen.
14
4. Specify the target devices or their discovery criteria. Click of the Target: field, and then do one of the
following:
• To use the filtering criteria of the Smart filter, click Smart filter… (For more information, see 2.2 Group and
Filter Devices.)
• To specify the discovery criteria, select Model name…, Node name…, IP address…, Serial number…, or
MAC address…. You can then import a list of the criteria exported from BRAdmin Professional 3/4 by
clicking Import….
5. Specify the timing for applying in Trigger.
You can specify as “At the time of discovery” or any time in the “Time specification”.
• If you select the “Time specification”, the Device discovery settings becomes grayed out.
• If you select the “At the time of discovery” and have not configured the Device discovery settings, the
Scheduled discovery is not configured. This task works only by manual discovery. message appears.
Click Device discovery settings and configure the schedule.
(For more information, see 7.2 Configure the Device Discovery Settings.)
6. Assign tasks for the target devices in the Set automation flow… field.
- To add tasks or actions: Click Set automation flow....
- To change the current tasks or actions: Click Edit.
7. Click Create.
To monitor the autoconfiguration tasks, click Autoconfiguration and then do one of the following:
1. Select an active or inactive task profile from the Current task field, and click one of the following in the right
pane:
- Settings: Display and edit the task’s settings.
- Deactivate/Activate: Deactivate active tasks or activate inactive tasks.
- Delete: Delete the selected task.
- Run now: Run the selected task immediately.
2. Select a completed or interrupted task profile from the Task log field and click one of the following in the right
pane:
- Details: Check the details of unsuccessful tasks.
- Delete: Delete the selected Task log item.
15
7 Application Settings
Application settings allow you to create and edit task profiles. You can also configure settings within the BRAdmin
Professional application.
Click to open the Application settings window.
7.1 General
To modify the general application settings, select General:
- Change Language
From the Language: drop-down list, select the language you want to use.
16
BRAgent runs on a computer that is on a different local network than the computer you are using. It discovers
devices and then passes the discovery results to BRAdmin Professional 4.
To perform Device discovery regularly, configure both Discovery method and Discovery schedule.
Discover device upon application startup is enabled by default. If the Device list shows no devices upon the
application startup, the application automatically discovers the devices.
• To edit the setting items specified by of each field above, select the item and click .
• To delete the setting items specified by of each field above, select the item and click .
17
7.3 Configure the Network Settings
18
7.6 Device Master Settings
1. Click of the Profiles: field to open the Profile settings screen.
• To edit the settings of an existing profile, select the profile from the Profiles: field, click , and then
change the setting items you want.
• To delete an existing profile, select the profile from the Profiles: field and click .
2. Type the profile name in the Profile name: field if you want to change the default profile name.
3. Type the password in Device password: field.
4. To always update the device's firmware automatically, select the Update to the latest firmware check box.
5. Type the setting file name you want in Settings file: or click the Browse… button to specify the setting files.
6. Specify the Schedule: as Every day or Weekly:.
7. Specify the Starting time:.
8. Click OK to close the Application settings screen.
• To edit the settings of an existing profile, select the profile from the Profiles: field, click , and then
change the setting items you want.
• To delete an existing profile, select the profile from the Profiles: field, and then click .
2. Type the profile name in the Profile name: field if you want to change the default profile name.
3. Click of the Schedule: field.
4. The Schedule setting window appears. Select the specific time, day, or period you want.
5. Configure the settings in the Send/Save log tab.
• To receive the log via email, select the Send Email:
check box.
• Click of the Destination address (To): field to type
the email address to which the device log is sent.
• Type the sender address in the Sender address
(From): field.
• Type the subject of the email in the Subject: field if you
want to change the default subject.
• To save device log files, select the Save a file: check
box to specify the destination folder.
19
6. Click the Log file tab.
• Type the log file name in the Log file name: field if you
want to change the default log file name.
• Select log entry items you need from the Information
contained in the log file: options.
• Select the file format from the File format: drop-down
list and type the data format in the Date format: field.
7. Click OK to close the Profile settings screen.
20
7.9 Create a Device List Profile
1. Type the file name in the File name: field if you want to change the default file name.
2. Click of the Schedule: field to set the schedule for acquiring the list.
3. To receive the list via email, select the Send Email: check box.
• Click of the Destination address (To): field to type the email address to which the list is sent.
• Type the sender address in the Sender address (From): field.
• Type the subject of the email in the Subject: field if you want to change the default email subject.
4. To save the device list files, select the Save a file: check box to specify the destination folder.
• To include the computer’s name in the file name, include the “%PCNAME%” string in the File name: field.
• To include the date in the “yyyy-MM-dd_HHmm” format in the file name, include the “%DATE%” string in
the File name: field.
• A file name can contain both the computer name and the date. Example: If your computer’s name is “AAA”,
the “machinelog_%PCNAME%_%DATE%” string produces the “machinelog_AAA_2019-08-21_1113” file
name.
• To edit the setting items specified by of each field above, select the item and click .
• To delete the setting items specified by of each field above, select the item and click .
7.10 Information
The following information of the BRAdmin Professional 4 application is available:
- To check the tool's application log in the case of errors, from the Application log: menu, click Open.
- To view the version information, from the About this application: menu, click Version.
- To check the application version, click Check for software updates. You can update the software if a newer
version is available.
- To check the license information, click License.
21
8 Troubleshooting and Support
If you cannot discover one or more devices, see 8.1 If You Cannot Discover the Device.
For further details, check the application log from the Information menu (see 7.10 Information.)
If the problem persists, contact your local Brother technical support team.
22
8.3 Troubleshooting
Error Solution
The admin password for the target device was entered incorrectly too many
Admin account locked
times. Wait until the password lock of the target device is released.
Already activated The function you want to activate on the device has already been activated.
The device password has already been changed from the default login
Already set
password. Make sure that the password is the default login password.
Cannot convert to PJL Make sure you use a PJL conversion table compatible with the input data.
Make sure you use a PJL conversion table compatible with the settings file you
Cannot convert to Setting file
want.
Connection error Make sure the target device is connected and available to transfer the data.
One or more settings in the settings file have not been applied. Check the log
Deploy results mismatch
file for more information.
Device internal error Reboot the target device and try again.
Device is busy Wait until the target device finishes its current job.
One or more settings in the settings file have not been applied. Check the log
Failed to modify
file for more information.
File not found Make sure you specify the file path correctly, and then try again.
Make sure that there is enough space in the destination folder, or that the files
File write error
in the destination folder can be overwritten.
The schema version of the target device is older than the schema version of
Firmware Update required
the JSON settings file. Update the device’s firmware.
Firmware-update is disabled Make sure the device Firmware-update setting is enabled.
Internal error Make sure all settings are correct and then try again.
Make sure the content and structure of the settings file are correct, and then try
Invalid deploy setting file
again.
Invalid file error Make sure you select the correct DJF file or the correct target device.
License error Make sure you enter the correct license code (20 digits).
The schema version of the JSON settings file is older than the schema version
New version schema required
of the target device.
Not discovered Make sure the target device is connected and available to transfer the data.
Make sure all the target devices support the function/command you want, or
Not supported
select the target devices that support that function/command.
Password incorrect Make sure you enter the correct password.
Make sure you have the permission to access the specified folder or output
Permission error
folder.
When specifying the device identifier, make sure you specify the serial number
Serial number mismatch
that matches the serial number of the target device.
Make sure your network connection is active so that you can update the tool to
Server communication error
the latest version.
This activation session has expired after more than 24 hours of inactivity. Try to
Session timeout
activate the solution or function you want again.
SNMP communication error Make sure you specify the SNMP settings correctly.
Make sure your SNMP settings are correct. Try again when the target device is
SNMP v3 security error
unlocked.
The license code was entered incorrectly too many times.
Wait until the lock of the license server is released.
Unauthorized access error
Make sure your license code is in the correct format (20 digits) and has not
been used yet.
23