Issue
How do I mass configure/bulk upload user configuration information on Network Management Cards 2 and 3? NOTE: This is no longer done via the config.ini file.
Product Line
Environment
Cause
As of NMC2 firmware v6.0.6, user configuration/modification is no longer supported or available via the config.ini file. This functionality can now be accomplished via a .csf file which can be uploaded to the NMC2 via FTP or SCP. INIUtil-v3, available in Knowledge Base article FA156117 for uploading/downloading config.ini files in bulk, will now support uploading .csf files (since they cannot be downloaded). Alternatively, a user can write a script to create users via the CLI (which is accessible via the local serial console, Telnet, or SSH).
Resolution
The user can use a .csf configuration file to be uploaded to the NMC2/NMC3 via FTP or SCP. Alternatively, these instructions can be used by the user to create a script that can be used with the NMC2/NMC3 via local serial console, telnet, or SSH.
NOTE: Secure Copy (SCP) users - please review Knowledge Base article FA235654 for important information prior to proceeding.
The NMC2/NMC3 offers a "default settings" configuration (which is availablein the config.ini file as well as all of the other NMC2/NMC3 interfaces - review Knowledge Base article FA175982 for a known issue) which can serve as a template for adding users. If many of your users will have the same preferences (which are now configurable on a per-user basis), you can modify these settings first so that your .csf file requires less data. You can also still configure preferences individually via the .csf file.
To configure the Default User Settings that will apply to most, if not all, of your local users follow the Configuration > Security > Local Users > Default Settings navigation path in the Web UI. See below.
You can also configure this via the CLI using the userdflt command.
Usage: userdflt -- Configuration Options
userdflt [-e <enable | disable>] (Enable)
[-pe <Administrator | Device | Read-Only | Network-Only>]
(user permission)
[-d <user description>]
[-st <session timout>] minute(s)
[-bl <bad login attempts>]
[-el <enable | disable>] (Event Log Color Coding)
[-lf <tab | csv>] (Export Log Format)
[-ts <us | metric>] (Temperature Scale)
[-df <mm/dd/yyyy | dd.mm.yyyy | mmm-dd-yy |
dd-mmm-yy | yyyy-mm-dd>] (Date Format)
[-lg <language code (enUs, etc)>] (User Language)
[-sp <enable | disable>] (Strong Passwords)
[-pp <interval in days>] (Required Password Change Interval)
Once these settings have been modified or if you've chosen to skip this, you'll need to create your .csf file if you're not scripting this. This must be a plain text file which has been modified to a .csf file extension. (Ensure that your system is set to show file extensions to avoid a filename such as userupload.csf.txt.)
Use the syntax of the usercommand to create your .csf user configuration file, shown below. This would be the syntax you follow if you're creating your own script.
NOTE: The .csf file must only contain one command per line.
Usage: user -- Configuration Options
user -n <user>
[-cp <current password>] (Only required for remote access or .csf upload methods while modifying Super User account. Serial access to CLI does not require -cp to modify Super User account)
[-pw <user password>]
[-pe <Administrator | Device | Read-Only | Network-Only>]
(user permission)
[-d <user description>]
[-e <enable | disable>] (Access Enable)
[-st <session timout>] minute(s)
[-sr <enable | disable>] (Serial Remote Auth. Override)
[-el <enable | disable>] (Event Log Color Coding)
[-lf <tab | csv>] (Export Log Format)
[-ts <us | metric>] (Temperature Scale)
[-df <mm/dd/yyyy | dd.mm.yyyy | mmm-dd-yy |
dd-mmm-yy | yyyy-mm-dd>] (Date Format)
[-lg <language code (enUs, etc)>] (User Language)
[-del <user name>]
[-l (shows current user list)]
Example (assuming creating via .csf for upload via FTP or SCP):
user -n newadmin -pw apc -pe administrator -e enable
user -n newdevice -pw apc -pe device -lg enUs -e enable
user -n newdev1 -pw dv1 -pe device -e enable
user -n apc -cp apc -pw 123secretpassword -el enable -ts us
Once your file is complete, save it as <anyname>.csf and upload it to your NMC2/NMC3 via one of the specified methods. To confirm your changes were applied, display the current user list in the CLI by issuing the user -l command, or check the Web UI under Configuration > Security > Local Users > Management to view your system's local users. NOTE: There is no way to export this list to a file unless you do it manually or script it.
Still not working or you have questions?
If you need further assistance or your .csf file is not working, please contact APC Technical Support and be prepared to provide the following information:
How do I mass configure/bulk upload user configuration information on Network Management Cards 2 and 3? NOTE: This is no longer done via the config.ini file.
Product Line
- Network Management Card 2
- Network Management Card 3
Environment
- Users wishing to add Network Management Card 2/3 (NMC2/NMC3) local users in bulk and/or via a configuration file via FTP/SCP.
- Secure Copy (SCP) users - please review Knowledge Base Article FA235654 for important information prior to proceeding.
- Users wishing to add users via script using a local serial console, Telnet, or SSH
Cause
As of NMC2 firmware v6.0.6, user configuration/modification is no longer supported or available via the config.ini file. This functionality can now be accomplished via a .csf file which can be uploaded to the NMC2 via FTP or SCP. INIUtil-v3, available in Knowledge Base article FA156117 for uploading/downloading config.ini files in bulk, will now support uploading .csf files (since they cannot be downloaded). Alternatively, a user can write a script to create users via the CLI (which is accessible via the local serial console, Telnet, or SSH).
Resolution
The user can use a .csf configuration file to be uploaded to the NMC2/NMC3 via FTP or SCP. Alternatively, these instructions can be used by the user to create a script that can be used with the NMC2/NMC3 via local serial console, telnet, or SSH.
NOTE: Secure Copy (SCP) users - please review Knowledge Base article FA235654 for important information prior to proceeding.
The NMC2/NMC3 offers a "default settings" configuration (which is availablein the config.ini file as well as all of the other NMC2/NMC3 interfaces - review Knowledge Base article FA175982 for a known issue) which can serve as a template for adding users. If many of your users will have the same preferences (which are now configurable on a per-user basis), you can modify these settings first so that your .csf file requires less data. You can also still configure preferences individually via the .csf file.
To configure the Default User Settings that will apply to most, if not all, of your local users follow the Configuration > Security > Local Users > Default Settings navigation path in the Web UI. See below.
You can also configure this via the CLI using the userdflt command.
Usage: userdflt -- Configuration Options
userdflt [-e <enable | disable>] (Enable)
[-pe <Administrator | Device | Read-Only | Network-Only>]
(user permission)
[-d <user description>]
[-st <session timout>] minute(s)
[-bl <bad login attempts>]
[-el <enable | disable>] (Event Log Color Coding)
[-lf <tab | csv>] (Export Log Format)
[-ts <us | metric>] (Temperature Scale)
[-df <mm/dd/yyyy | dd.mm.yyyy | mmm-dd-yy |
dd-mmm-yy | yyyy-mm-dd>] (Date Format)
[-lg <language code (enUs, etc)>] (User Language)
[-sp <enable | disable>] (Strong Passwords)
[-pp <interval in days>] (Required Password Change Interval)
Once these settings have been modified or if you've chosen to skip this, you'll need to create your .csf file if you're not scripting this. This must be a plain text file which has been modified to a .csf file extension. (Ensure that your system is set to show file extensions to avoid a filename such as userupload.csf.txt.)
Use the syntax of the usercommand to create your .csf user configuration file, shown below. This would be the syntax you follow if you're creating your own script.
NOTE: The .csf file must only contain one command per line.
Usage: user -- Configuration Options
user -n <user>
[-cp <current password>] (Only required for remote access or .csf upload methods while modifying Super User account. Serial access to CLI does not require -cp to modify Super User account)
[-pw <user password>]
[-pe <Administrator | Device | Read-Only | Network-Only>]
(user permission)
[-d <user description>]
[-e <enable | disable>] (Access Enable)
[-st <session timout>] minute(s)
[-sr <enable | disable>] (Serial Remote Auth. Override)
[-el <enable | disable>] (Event Log Color Coding)
[-lf <tab | csv>] (Export Log Format)
[-ts <us | metric>] (Temperature Scale)
[-df <mm/dd/yyyy | dd.mm.yyyy | mmm-dd-yy |
dd-mmm-yy | yyyy-mm-dd>] (Date Format)
[-lg <language code (enUs, etc)>] (User Language)
[-del <user name>]
[-l (shows current user list)]
Example (assuming creating via .csf for upload via FTP or SCP):
user -n newadmin -pw apc -pe administrator -e enable
user -n newdevice -pw apc -pe device -lg enUs -e enable
user -n newdev1 -pw dv1 -pe device -e enable
user -n apc -cp apc -pw 123secretpassword -el enable -ts us
Once your file is complete, save it as <anyname>.csf and upload it to your NMC2/NMC3 via one of the specified methods. To confirm your changes were applied, display the current user list in the CLI by issuing the user -l command, or check the Web UI under Configuration > Security > Local Users > Management to view your system's local users. NOTE: There is no way to export this list to a file unless you do it manually or script it.
Still not working or you have questions?
If you need further assistance or your .csf file is not working, please contact APC Technical Support and be prepared to provide the following information:
- Your .csf file with any personal information removed, if required
- Firmware version
- Event.txt (and config.ini file if pertaining to default user settings) - instructions to retrieve these are in Knowledge Base article FA156131.
Published for:APC Belgium
