Handling Accounts

CSRC does not implement the level of policy management needed to automatically disable service based on policy violations. Instead CSRC provides a tool that you can use to suspend access to the Internet and deny access to the User Registrar. The csrc_deactivate command is a command-line executable that de-activates an account, and then prevents that account from being used.

csrc_deactivate
{-account account_id | -userid user_id}
-cmsvc cm_service_name
-csrcadm csrc_adm_name 
-csrcadmpw csrc_adm_pw
-reason reason_string
 

The csrc_deactivate command de-activates a subscriber, and in order to resubscribe, the subscriber must be requalified. The csrc_deactivate command works in the following manner:

1. CSRC validates the CSRC administrator's name and password (from the command line or stdin) against the admin database. If an administrator with that name does not exist, or the password does not match, the csrc_deactivate command displays an error message and exits. (This step uses the -csrcadm and -csrcadmpw command-line arguments.)

2. CSRC reads a Subscriber object using the account ID or user name that you entered from the command line (using the -csrcadm or -csrcadmpw command-line arguments). CSRC reads a Modem object using the account ID or user name. CSRC reads Computer objects on the modem. CSRC reads a Service object based on the command-line argument -cmsvc.

3. If the subscriber is already disabled, the csrc_deactivate command returns and does not reset the cable modem. If CSRC cannot find the Service object or Modem object, the csrc_deactivate command displays an error.

4. CSRC updates the Modem object so that Modem.ServiceList is appended to Modem.PrevServiceList and Service is appended to Modem.ServiceList, as specified by the command-line argument -cmsvc. Also, Modem.ClientClass is set to the value of Service.CMClientClass.

5. CSRC updates each computer object behind a modem so that Computer[I].ClientClass is set to the value of Service.CompClientClass.

6. CSRC updates the Subscriber object so that Subscriber.IsDisabled equals TRUE and Subscriber.DisabledReason is set to the contents of the command-line argument -reason.

7. CSRC resets the cable modem.

csrc_reactivate
{-account account_id | -userid user_id}
-cmsvc cm_service_name
-csrcadm csrc_adm_name
-csrcadmpw csrc_adm_pw
 

Table 9-3: The csrc_reactivate Command Arguments

Argument	Description
-account account_id	Specifies the account identifier of the subscriber to re-activate. This is the account number that identifies the customer in the site's billing system and is a key into the CSRC LDAP data store. You must use this argument if you do not specify the -userid argument.
-userid user_id	Specifies the user identifier of the subscriber to re-activate. This is the user identifier used to identify a customer to CSRC and a key into the CSRC LDAP data store. You must use this argument if you did not specify the -account argument. CSRC displays an error if you do not specify either the -account or the -userid argument.
-cmsvc cm_service_name	Specifies the name of the service to use to re-activate this subscriber. You must specify this argument.
-csrcadm csrc_adm_name	Specifies the administrator name to validate CSRC access. The csrc_adm_name must be a valid CSRC administrator. If you do not specify this argument CSRC reads it from stdin.
-csrcadmpw csrc_adm_pw	Specifies the password for the administrator to validate CSRC access. The csrc_adm_pw must be the valid password for the administrator listed in the csrcadm argument. If you do not specify this argument CSRC reads it from stdin.

1. CSRC validates the CSRC administrator's name and password (from the command line or stdin) against the admin database. If an administrator with that name does not exist, or the password does not match, the csrc_reactivate command displays an error message and exits. (This step uses the -csrcadm and -csrcadmpw command-line arguments.)

2. CSRC reads a Subscriber object using the account ID or user name that you entered from the command line (using the -csrcadm or -csrcadmpw command-line arguments). CSRC reads a Modem object using the account ID or user name. CSRC reads Computer objects on the modem. CSRC reads a Service object based on the command-line argument -cmsvc.

3. If the subscriber is already disabled, the csrc_reactivate command returns and does not reset the cable modem. If CSRC cannot find the Service object or Modem object, the csrc_reactivate command displays an error.

4. CSRC updates the Modem object so that Modem.ServiceList is appended to Modem.PrevServiceList and Service is appended to Modem.ServiceList, as specified by the command-line argument -cmsvc. Also, Modem.ClientClass is set to the value of Service.CMClientClass.

5. CSRC updates each computer object behind a modem so that Computer[I].ClientClass is set to the value of Service.CompClientClass.

6. CSRC updates the Subscriber object so that Subscriber.IsDisabled equals FALSE.

7. CSRC resets the cable modem.

csrc_resetcm
{-account account_id | -userid user_id}
{-ipaddress ip_address| -macaddress mac_address}
-csrcadm csrc_adm_name 
-csrcadmpw csrc_adm_pw
 

Table 9-5: The csrc_deactivate Command Arguments

Argument	Description
-account account_id	Specifies the account identifier of the subscriber's cable modem to reset. This is the account number that identifies a customer to your company's billing system and is a key into the CSRC LDAP data store. You must use this argument if you do not specify the -userid argument.
-userid user_id	Specifies the user identifier of the subscriber's cable modem to reset. This is the user identifier that identifies a customer to CSRC and is a key into the CSRC LDAP data store. You must use this argument if you do not specify -account. CSRC displays an error you do not specify the -account or the -userid argument.
-ipaddress ip_address	Specifies the IP address of a subscriber's cable modem to reset. If you want to reset all the IP addresses associated with a specific subscriber, use the value all. CSRC checks that the IP address belongs to the subscriber before resetting the modem.
-macaddress mac_address	Specifies the MAC address of a specific cable modem. If you want to reset all the IP addresses associated with a specific subscriber, use the value all. CSRC checks that the MAC address belongs to the subscriber before resetting the modem.
-csrcadm csrc_adm_name	Specifies the administrator's name to validate CSRC access. The csrc_adm_name must be a valid CSRC administrator. If you do not specify this argument, CSRC reads it from stdin.
-csrcadmpw csrc_adm_pw	Specifies the administrator's password to validate CSRC access. The csrc_adm_pw must be the valid password for the administrator. If you do not specify this argument, CSRC reads it from stdin.

The csrc_resetcm command works in the following manner:

1. CSRC validates the CSRC administrator's name and password (from the command line or stdin) against the admin database. If an administrator with that name does not exist, or the password does not match, the csrc_resetcm command displays an error message and exits. (This step uses the -csrcadm and -csrcadmpw command-line arguments.)

2. CSRC reads a Subscriber object using the account ID or user name that you entered from the command line (using the -csrcadm or -csrcadmpw command-line arguments). CSRC reads a Modem object using the account ID or user name. CSRC reads Lease objects based on Modem objects. CSRC validates the MAC address or IP address against the Modem objects or Lease objects. If the cable modem's MAC address or IP address does not belong the subscriber, the csrc_resetcm command returns an error and does not reset the cable modem.

3. CSRC requires the write community string to reset the modem. It can get the write community string from the Modem object. If it is not there, it searches the default Config Object. If CSRC cannot find the write community string, it returns an error, and aborts the reset command.

4. CSRC resets the cable modem.