Configuring Web Applications for the SRC-VTA

To configure Web applications for the SRC-VTA:

  1. If you have not already done so, create a folder for the SRC-VTA on a host, and copy the EAR file for the SRC-VTA to the VTA folder.
      mkdir vta
      cp <file> /quotavta.ear vta
  2. From the EAR file, extract the file <vtaName>CustCare.war into the folder you created.
      cd vta
      jar xvf quotavta.ear quotaCustCare.war
  3. From the file <vtaName>CustCare.war, extract the file CONSTANTS.incl.
      jar xvf quotaCustCare.war CONSTANTS.incl
  4. Edit the properties in the file CONSTANTS.incl.

    See Properties for VTA Portals for a description of the properties in the CONSTANTS.incl file.

  5. Replace the file CONSTANTS.incl into the file <vtaName>CustCare.war.
      jar uvf quotaCustCare.war CONSTANTS.incl
  6. Replace the file <vtaName>CustCare.war into the EAR file.
      jar uvf quotavta.ear quotaCustCare.war

Properties for VTA Portals

This section describes the properties in the CONSTANTS.incl file.

PERIODIC_QUOTA

  • Quota initially deposited into a subscriber’s periodic account when the subscriber activates the account through the subscriber portal. This value must match the value that the administrator specifies when replenishing periodic accounts. (See Replenishing Periodic Accounts).
  • Value—Integer in the range 1–9223372036854775807 followed by the letter L or calculation in Java code
  • Default—5000000000L

SUBSCRIBER_ACTIVATE_DESCRIPTION

  • Description recorded for a balance change in the periodic account when the subscriber activates the account through the subscriber portal. This description records the change in the account status; however, the actual change in the balance is zero.
  • Value—Text string
  • Default—Activated by subscriber

PERIODIC_QUOTA_INITIAL_TOP_UP_DESCRIPTION

  • Description recorded for a balance change in the periodic account when the subscriber activates the account through the subscriber’s portal. This change in the balance is the value of the PERIODIC_QUOTA property.
  • Value—Text string
  • Default—Periodic replenishment to 5,000 MB

SUBSCRIBER_DEACTIVATE_DESCRIPTION

  • Description for a balance change in the periodic account when the subscriber deactivates the account through the subscriber’s portal. This description records the change in the account status; however, the actual change in the balance is zero. When the periodic account is inactive but the balance is nonzero, the SRC-VTA continues to use the account until the administrator invalidates inactive accounts through the administrator’s portal.
  • Value—Text string
  • Default—Deactivated by subscriber

PERIODIC_QUOTA_INACTIVE_TOP_UP_DESCRIPTION

  • Description for a balance change in inactive periodic accounts when the administrator replenishes periodic accounts through the administrator’s portal. This action sets the balance of inactive periodic accounts to zero.
  • Value—Text string
  • Default—Expiration of deactivated periodic account’s balance

SUBSCRIBER_PURCHASE_DESCRIPTION

  • Description recorded for a balance change in the bought account when the subscriber buys bandwidth through the subscriber portal.
  • Value—Text string
  • Default—Subscriber purchased bandwidth

NIC_PROXY_NAMESPACE

  • Namespace of the NIC proxy. This NIC proxy maps the subscriber's IP address to the identifier that the SRC-VTA uses as the key to the subscriber’s records in the VTA database.
  • Value—Path, relative to the root of the static configuration properties, that defines where the NIC proxy configuration is stored.
  • Guidelines—If you are using the accounting ID to identify the SAE that manages a subscriber, set this property to /NicProxies/AcctIdToSaeNicProxy
  • Default—/NicProxies/IpToIdNicProxy

BOUGHT_QUOTA_ACCOUNT_NAME

  • Name of account that stores bought quota.
  • Value—Text string
  • Guidelines—If you change this value from the default, you must also update the sample Quota VTA configuration to use the same account names and statuses.
  • Default—BoughtQuota

PERIODIC_QUOTA_ACCOUNT_NAME

  • Name of account that stores periodic quota.
  • Value—Text string
  • Guidelines—If you change this value from the default, you must also update the sample Quota VTA configuration to use the same account names and statuses.
  • Default—PeriodicQuota

ACTIVE_STATUS

  • Status string.
  • Value—Text string
  • Guidelines—If you change this value from the default, you must also update the sample Quota VTA configuration to use the same account names and statuses.
  • Default—Active

INACTIVE_STATUS

  • Status string.
  • Value—Text string
  • Guidelines—If you change this value from the default, you must also update the sample Quota VTA configuration to use the same account names and statuses.
  • Default—Inactive

SSPORTAL_SIGNIN_URL

  • URL of the portal login page for the Quota VTA to authenticate users, primarily users with addresses that are assigned externally whose sessions are not detected automatically by the SAE.
  • Value
    • <URL>—URL in the format "http://<server>:<port>/"
    • null—Keyword not enclosed in quotation marks
  • Guidelines—If the URL is specified, the SRC-VTA redirects the subscriber to the portal login page when the SRC-VTA cannot resolve a subscriber by IP address. If the value is null and the SRC-VTA cannot resolve the subscriber by IP address, an unknown subscriber message appears.
  • Default—null