Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Setting Up the Second SBR/Management Node in a Starter Kit

 

This section describes installing the software on the second SBR/management node host in a Starter Kit cluster, following the initial combined SBR/management node installation. (See Setting Up a Starter Kit’s First SBR/Management Node.)

Caution

If you have not installed the Cluster’s first server yet, do not proceed with the cluster installation.

Populating the JNPRShare Directory

Populating the JNPRShare Directory

Before running the configure script, make a local copy of the configuration files that were created during installation on the first server. (In the following procedures, FTP is used to copy files. You may use whatever distribution mechanism you want to keep the share directories synchronized, so long as all /JNPRshare directories on all servers are readable and writable by the root and hadm accounts.)

To copy the cluster’s base configuration files to this target machine:

  1. Log in as hadm.

  2. Change directories to the install directory on the local server.

    Execute:

    cd /opt/JNPRshare/install/ <cluster_name>

    For example:

    cd /opt/JNPRshare/install/MyCluster

  3. Use FTP binary mode to connect to the first server that was set up and navigate to the radius/install subdirectory of the directory in which the JNPRsbr package was installed (/opt/JNPRsbr/radius/install by default) on the source server.

  4. Execute a get command to transfer the configure <cluster name> .tar file to the local directory.

    For example:

    bin

    get configure.MyCluster.tar

  5. Extract the configuration files from the archive.

    For example:

    tar xvf configure.MyCluster.tar

    The output display includes five files similar to this example:

Configuring Host Software on the Second SBR Carrier and Management Node

Configuring Host Software on the Second SBR Carrier and Management Node

Before starting this procedure, review Before You Install Software. In particular, review requirements for: Setting Up External Database Connectivity (Optional) and Installing the SIGTRAN Interface (Optional), as steps in this procedure require the server to be preconfigured for these capabilities.

To configure SSR software on the second SBR Carrier and management node host in a Starter Kit cluster:

  1. As root, navigate to the directory where you installed the Steel-Belted Radius Carrier package. For information about directory in which Steel-Belted Radius Carrier package is installed, see Unpacking Session State Register Software.

    Navigate to the radius/install subdirectory and run:

    Execute:

    cd /opt/JNPRsbr/radius/install/

  2. Execute the configure script to install the Steel-Belted Radius Carrier server software:

    Execute:

    ./configure

  3. Review and accept the Steel-Belted Radius Carrier license agreement.

    Press the spacebar to move from one page to the next. When you are prompted to accept the terms of the license agreement, enter y.

    Do you accept the terms in the license agreement? [n] y

  4. From the menu of configuration tasks, enter 3 to specify Configure Cluster Node.

  5. Specify the name of the cluster.

    Enter the name exactly as you specified it in Table 9.

    Enter SBR cluster name [MyCluster]: MyCluster

    You are prompted to verify whether you want to proceed, unless the script detects any unusual installation conditions (a pre-existing directory, for example). In some cases, you may be prompted to resolve or ignore them.

  6. The system reads the configuration files that you copied to the server and prompts you to change some settings from the original server’s to adapt them to this server. Enter y to proceed.

  7. Enter a to accept the modified configuration files and continue or v to view them.

    Caution

    We recommend that you enter an r to reject them only if a serious error was made when you provided information. We recommend that you not edit these files.

  8. Specify whether you want to use the JRE installed in your system to enable JDBC plug-ins and JavaScript implementation.

    • If no, press Enter to proceed to the next prompt. SBR Carrier does not support JDBC plug-ins unless you specify a valid JRE path.

    • If yes, type y and press Enter. You are prompted to specify the path where the JRE is installed in your system. The Java Virtual Machine (JVM) architecture should be compatible with SBR Carrier.

      Note

      Java 1.8.0 or a later version is required to access the Web GUI. To support both JDBC plug-ins and Web GUI, it is recommended to use Java 1.8.0 or a later version with the JVM architecture compatible with your SBR Carrier. For example, if you are using the 64-bit version of SBR Carrier, you must use the 64-bit version of Java 1.8.0 or later.

      Note

      If you enter an incorrect JVM path three times, SBR Carrier proceeds to the next step. In this case, you will not be able to use JDBC plug-ins. To specify the valid JVM path, you need to run the configure script again.

  9. Specify the server’s initial admin user.

    Press Enter to accept the default, root.

  10. Specify whether you want to set up Centralized Configuration Management (CCM).

    Then specify the server role.

    1. Because this is not the first server to be installed, if CCM is used, this server cannot be the primary. Enter r to set the role as replica.

    2. Specify whether you want a local replica.ccmpkg file from the primary server.

    3. Specify the primary CCM server’s hostname.

      Enter primary host name:

      For example:

      Enter primary host name: MyNode_1

    4. Specify the primary CCM server’s IP address.

      Enter primary host IPv4 address [172.28.84.35]:

      For example:

      Enter primary host IPv4 address [172.28.84.35]: 198.168.0.1

    5. Specify the primary host secret string.

      Enter primary host secret:

      Type the secret string and press Enter.

    6. Confirm the host secret string.

      Confirm primary host secret:

      Type the secret string again and press Enter.

  11. Specify whether you want to use the auto-restart module that automatically restarts the SBR Carrier server in case of an unexpected shutdown.

    Note

    If Perl version 5 is not installed, the radiusd script will not run, even if enabled by configuration, and SBR Carrier will operate without the auto-restart module running.

  12. Specify whether you want to configure SBR Carrier to provide LDAP server emulation for configuration and statistics using the LCI.

    • If no, press Enter to accept the default.

    • If yes, enter y and press Enter. You are prompted to provide information for LCI configuration.

      1. When you are prompted for the port number, enter the port number that is used for communication between SBR Carrier and the LDAP client.

        Note

        SBR Carrier uses port 667 as the default for LDAP emulation to avoid conflict with other LDAP servers.

      2. The script displays the interfaces available in the system. When you are prompted to enter interface addresses on which Steel-Belted Radius Carrier should listen for LCI requests, enter the addresses you want to use from the Available Interfaces list.

        Note

        SBR Carrier uses all interfaces for listening to LCI requests if you do not enter any interfaces.

      3. Specify whether you want to change the default LCI password to prevent unauthorized LDAP clients from accessing your database.

        • If no, press Enter to accept the default password.

        • If yes, enter y and press Enter. You are prompted to enter a new password.

        Note

        Make sure that the entered password is at least 6 alphanumeric characters and not more than 8 characters in length. The password should not include any special characters other than underscore (’_’).

        Note

        The configure script also checks whether the LDAP utilities (such as ldapdelete, ldapmodify, and ldapsearch) are installed in your system. For Linux, a warning message is displayed if you have not installed any of these utilities in your system. For Solaris, LDAP utilities are shipped with SBR Carrier package.

  13. Specify whether you want to configure Steel-Belted Radius Carrier for use with an Oracle database.

    To support this option, the server must already be configured as an Oracle client (See Setting Up External Database Connectivity (Optional).).

    Configuring for use with generic database

    Do you want to configure for use with Oracle? [n]:

    If no, press Enter.

    If yes, type y and press Enter. You are prompted for version and path information for the Oracle library files.

    Do you want to configure for use with Oracle? [n]: y

    Supported Oracle versions: 10, 11, 12

    What version of Oracle will be used? [10]: 10

    Configuring for use with Oracle 10

    Setting the environment variable ORACLE_HOME

    Enter ORACLE_HOME [/dbms/u10/app/oracle/product/10.2.0]:

    Setting the environment variable LD_LIBRARY_PATH

    Enter path for Oracle shared libraries

    [/dbms/u10/app/oracle/product/10.2.0/lib]:

    Setting the environment variable TNS_ADMIN

    Enter TNS_AMDIN

    [/dbms/u10/app/oracle/product/10.2.0/network/admin]:

Note

You must configure 64-bit Oracle client for 64-bit SBR Carrier.

  1. Specify whether you want the Steel-Belted Radius Carrier server to communicate with an SS7 system using SIGTRAN.

    To support this option, the server must already be configured to support SIGTRAN using Signalware. (See Installing the SIGTRAN Interface (Optional) for an overview, and SIGTRAN Support for Steel-Belted Radius Carrier for specific instructions.)

  2. Specify whether you want to start the GWrelay process while executing the ./sbrd start script.

  3. Specify whether you want to install the optional SNMP module to monitor your Steel-Belted Radius Carrier server from an SNMP management station.

    Do you want to configure SNMP? [n]:

    • If no, press Enter to proceed to the next prompt.

    • If yes, type y and press Enter. The installer prompts you for the information it needs to configure the jnprsnmpd.conf and startsnmp.sh files.

      1. When you are prompted for a community string, enter the community string used to validate information sent from the SNMP subagent on the Steel-Belted Radius Carrier server to your SNMP management station.

        Choose a community string: public

      2. When you are prompted for a range of IPv4 addresses, specify a starting IP address in Classless Inter-Domain Routing format. To specify that only one host may query the agent, enter the IP address of the host followed by /32. To specify that any host on a designated class C network may query the agent, enter the starting address of the network followed by /24.

        Specify the range of IPv4 addresses that may query this agent, such as 1.2.3.0/24.

        Address range: 192.168.70.0/24

      3. If you are using SNMPv2, enter the DNS name or IP address of the trap sink that you want to receive trap information from the SNMP subagent on the Steel-Belted Radius Carrier server.

        SNMPv2 trap sink: 192.168.70.86

      4. Set the SNMP agent port.

        Although you may specify the default SNMP port, 161, we recommend that you specify a different port to avoid contention with other agents that are likely to already be using 161. If you choose an alternate port, make a note of it because your MIB browser needs to be configured to the same setting.

        Specify SNMP agent listening port[161]: 24161

      5. Specify a trap sink address, if required.

        Optionally specify a trap sink address that will receive SNMPv2 trap

        [localhost]: 172.28.72.83 2

        SNMPv2 trap sink port[162]:

        Configuration of SNMP complete.

  4. The script searches for the Java 1.8.0 or later version in the default system path and displays a confirmation message if found.

    If the specific version is not found, the script prompts you to enter the path where the specific Java version is installed in your system.

  5. Specify whether you want to install a custom SSL certificate for the Web GUI.

    • If no, press Enter. A self-signed certificate is created and installed in your server.

    • If yes, enter y and press Enter. You are prompted to enter the absolute path where the SSL certificate is available. For example, /opt/customSSLCert.pfx.

      When you are prompted for the password, enter the password to open the SSL certificate.

  1. Specify whether you want to configure the Steel-Belted Radius Carrier software (both RADIUS and SSR processes as appropriate for the given node type) to autoboot (restart automatically when the operating system is restarted). We recommend that you enable this behavior.

    Enable (e), disable (d), or preserve (p) autoboot scripts [e]: e

    A local /radiusdir/radius/sbrd script is always created, and /opt/JNPRhadm/sbrd is always a symbolic link to this local copy.

    • If you enter e (enable), the configure script copies the local sbrd script to /etc/init.d, where it is automatically invoked by the OS whenever the OS is stopped or started.

    • If you enter d (disable), the configure script removes all copies of the sbrd script from /etc/init.d, thus, disabling autoboot for all versions of Steel-Belted Radius Carrier.

    • If you enter p (preserve), the configure script does nothing, thereby leaving your previous autoboot scripts unchanged.

  2. When prompted, confirm that you want the installation to proceed and to configure Steel-Belted Radius Carrier with the specified settings. When the script finishes, it displays:

  3. Configure the two data nodes in the Starter Kit using the procedure described in Setting Up Data Node Hosts Included with the Starter Kit.