22.1. CP resource

22.1. CP resource
	Chapter 22. CP - Control Port

The Control Port allows to access configuration and supervising functions. The Control Port isn't a physical port, that is there is no connector, but it's a “virtual” port of the Abilis CPX.

22.1.1. CP resource parameters

The Control Port is identified by the mnemonic “CP”, corresponds to the Abilis CPX port 0 and it's provided with the parameters described in this section.

Use the following command to show its parameters.

[11:09:16] ABILIS_CPX:d p cp

RES:Cp ------------------------------------------------------------------------
Run    DESCR:Control_Port
       LOG:NO                PI:ABILIS_CPX:       sesnum:7      ps:512    
       X29A:DFT
       X29B:DFT
       ------------------------------------------------------------------------
       LOGIN-MODE:LEGACY
       PWDU:****************
       PWDA:****************
       PWDS:****************

The most important parameters are:

LOG

Logging functionalities activation/deactivation.

PI

This parameter sets the command interpreter prompt of the Control Port. Information about current local time “[hh:mm:ss]” always precedes the user defined prompt. From 1 to 16 ASCII characters. Space not allowed. Forced to upper case.

	Tip
	Interesting chapter: Section 85.6.9, “How can I change the Abilis prompt name?”.

LOGIN-MODE

Choose login mode [LEGACY, USERS].

LEGACY:
- Login to CP with USER/ADMIN/SUPER.
- Login to SSH/TELNET with respective PWD.
- Case insensitive password verification.
- Clear PWD parameter of SSH/TELNET.
- Disable Abilis user 'super'.
USERS:
- Login to CP/SSH/TELNET with:
  - Abilis user 'super'.
  - Abilis users having CP-LEVEL <> NO and PWD not empty.
- Enable Abilis user 'super'.
- Hide and clear PWD parameter of SSH/TELNET.
- Clear PWD parameter of Abilis user 'super'.
- SSH/TELNET credentials are automatically used for local CP too.

sesnum

Maximum number of connections [4..32].

ps

Maximum packet size [128..2048 byte].

PWDU

User authentication password. Case-insensitive match. Max 16 ASCII characters. Space not allowed. It sets the access password to the CP of the USER level. Once it's configured, the new password will be saved on the Abilis CPX CF/HD, in a encrypted way, using the command save conf.

	Important
	Only for `LOGIN-MODE`:`LEGACY`.

PWDA

Administrator authentication password. Case insensitive match. Max 16 ASCII characters. Space not allowed. It sets the access password to the CP of the ADMINISTRATOR level. Once it's configured, the new password will be saved on the Abilis CPX disk, in a encrypted way, using the command save conf.

	Important
	Only for `LOGIN-MODE`:`LEGACY`.

PWDS

SuperUser authentication password. Case insensitive match. Max 16 ASCII characters. Space not allowed. It sets the access password to the CP of the SUPER-USER level. Once it's configured, the new password will be saved on the Abilis CPX disk, in a encrypted way, using the command save conf.

	Important
	Only for `LOGIN-MODE`:`LEGACY`.

The following command allows the administrator to change the configuration of the resource:

s p cp parameter:value...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:cp; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).

22.1.2. Access levels to the Control Port

It's possible to log into the Control Port by using three different privilege levels:

User login level: “USER” is allowed to execute only some operations for supervising the Abilis CPX working mode; the execution of “USER” not allowed commands will cause the message “COMMAND NOT ALLOWED FOR USER LOGIN LEVEL” to be displayed.
Administrator login level: “ADMINISTRATOR” is allowed, with some restrictions, to execute all the operations for configuring and supervising the Abilis CPX; execution of “ADMINISTRATOR” not allowed commands will cause the message “COMMAND NOT ALLOWED FOR ADMINISTRATOR LOGIN LEVEL” to be displayed.
Super-User login level: SUPERUSER is able to completely manage the system.

Once the CP has been accessed, it's possible to check or modify the privilege level by using the command login.

Here is an example of how to access the Control Port through the Telnet port, with USER privileges:

[192.168.0.1] TELNETS>00-CP
COM

Abilis CPX - Ver. 8.5.1/STD - Build 4238.7 - Branch 8.5 - Abilis-ID 1800310
Monday 28/08/2017 08:38:44 (UTC+2:00)
Logged as USER

[11:29:21] ABILIS_CPX:

The User is asked to specify the requested access level (USER, ADMINISTRATOR or SUPERUSER) and then to insert the corresponding password. If the password is wrong, it will be asked again. After the third wrong try, the connection will be cleared.

[192.168.0.1] TELNETS>00-CP
COM

Abilis CPX - Ver. 8.5.1/STD - Build 4238.7 - Branch 8.5 - Abilis-ID 1800310
Monday 28/08/2017 08:38:44 (UTC+2:00)
Login:user
Password:

INVALID PASSWORD

Password:

INVALID PASSWORD

Password:

CLR F0 AE

[192.168.0.1] TELNETS>