Subscriber Manager Integration

Table Of Contents

Subscriber Manager Integration

How to Install, Uninstall, and Upgrade the DHCP Lease Query LEG

Installing the DHCP Lease Query LEG on the SM

Uninstalling the DHCP Lease Query LEG from the SM Server

Upgrading the DHCP Lease Query LEG

Subscriber Manager Integration

This module describes the procedures for installing, uninstalling, and upgrading the DHCP Lease Query LEG on the SM.

Note This module is relevant if you are using the Subscriber Manager server on your network. You should install the DHCP Lease Query LEG on the SM server and not on the SCE device.

• How to Install, Uninstall, and Upgrade the DHCP Lease Query LEG

How to Install, Uninstall, and Upgrade the DHCP Lease Query LEG

• Installing the DHCP Lease Query LEG on the SM

• Uninstalling the DHCP Lease Query LEG from the SM Server

• Upgrading the DHCP Lease Query LEG

Installing the DHCP Lease Query LEG on the SM

SUMMARY STEPS

1. Install the DHCP Forwarder application

2. Install the PQI file of the DHCP Lease Query LEG

3. Edit the DHCP Lease Query LEG configuration files

4. Edit the SM configuration file p3sm.cfg and set the subscriber introduction mode to be pull mode

5. Load the configuration files to the SM using the p3smCLU

6. Add a resource to the Veritas Cluster Server

DETAILED STEPS

Step 1 Install the DHCP Forwarder application

The DHCP Forwarder application bridges between the LEG and the DHCP server. See Installing the DHCP Forwarder, page 6-1.

Step 2 Install the PQI file of the DHCP Lease Query LEG

a. Run the p3inst command-line utility (CLU) from the SM CLU directory ~pcube/sm/server/bin

Example:

>p3inst --install -f leaseq.pqi

Note After the installation of the PQI file, the SM restarts itself automatically.

Step 3 Edit the DHCP Lease Query LEG configuration files

The DHCP Lease Query LEG includes two configuration files under ~pcube/sm/server/root/config :

•leaseq.cfg —Configures general attributes of the LEG

•dhcp_pkg.cfg —Configures rules for policy assignment

It is recommended to edit the files according to the configuration required at first use.

Step 4 Edit the SM configuration file p3sm.cfg and set the subscriber introduction mode to be pull mode

Example:

[SM General] # The following parameter defines whether the SM introduces # the subscribers to # the SCEs immediately after the subscriber's # login operation (push-mode) or when the SE requests # subscriber information specifically (pull-mode). # Optional values: [pull, push]. Default: push. introduction_mode=pull
Step 5 Load the configuration files to the SM using the p3smCLU

This command-line utility loads the new configuration to the SM and activates it.

Example:

>p3sm --load-config
Step 6 Add a resource to the Veritas Cluster Server

This can be done only on SM Cluster setups. To add a resource, see Adding a DHCP Forwarder Resource, page 6-3.

Uninstalling the DHCP Lease Query LEG from the SM Server

SUMMARY STEPS

1. Run the p3instcommand-line utility from the SM CLU directory ~pcube/sm/server/bin

2. Uninstall the DHCP Forwarder Veritas Cluster Agent.

3. Uninstall the DHCP Forwarder application. See Uninstalling the DHCP Forwarder, page 6-2.

DETAILED STEPS

Step 1 Run the p3instcommand-line utility from the SM CLU directory ~pcube/sm/server/bin

Example:

>p3inst --uninstall -f leaseq.pqi

Note After the uninstall process, the SM restarts itself automatically.

Step 2 Uninstall the DHCP Forwarder Veritas Cluster Agent.

This can be done only on SM Cluster setups. See Removing a DHCP Forwarder Resource, page 6-5.

Step 3 Uninstall the DHCP Forwarder application. See Uninstalling the DHCP Forwarder, page 6-2.

Upgrading the DHCP Lease Query LEG

The DHCP Lease Query LEG must be upgraded as part of the SM upgrade process, because previous versions of the DHCP Lease Query LEG are incompatible with the SM 3.x version. The upgrade for the DHCP Lease Query LEG should be performed together with the upgrade process of the SM.

SUMMARY STEPS

1. Backup the configuration files of the DHCP Lease Query LEG.

2. Uninstall the DHCP Lease Query LEG by running the p3inst CLU

3. Perform an upgrade of the SM

4. Install the new version of the DHCP Lease Query LEG by running the p3instCLU

5. Restore the configuration files of the DHCP Lease Query LEG

6. Load the new configuration of the SM by running the p3sm CLU

DETAILED STEPS

Step 1 Backup the configuration files of the DHCP Lease Query LEG.

The original configuration files are deleted by the uninstall process in the next step.

Step 2 Uninstall the DHCP Lease Query LEG by running the p3inst CLU

Example:

>p3inst --uninstall -f lease-query-pqi

Note After the uninstall process, the SM restarts automatically.

Step 3 Perform an upgrade of the SM

The SM upgrade procedure is described in the Cisco SCMS Subscriber Manager User Guide .

Step 4 Install the new version of the DHCP Lease Query LEG by running the p3instCLU

Example:

>p3inst --install -f lease-query-pqi
Step 5 Restore the configuration files of the DHCP Lease Query LEG

Step 6 Load the new configuration of the SM by running the p3smCLU

Example:

>p3sm --load-config