Installing and Starting the VPN Solutions Center Software

• VPNSC: MPLS Solution software

  The VPNSC software includes the VPN Console and the Cisco WatchDog.

• OrbixWeb and Orbix

• TIBCO/Rendezvous software

Note   The software installation works only if your system is running under Solaris 2.6.

1. Install Oracle 8.0.5 and Cisco IP Manager 2.0 on the same workstation before you install the VPN Solutions Center software on its own workstation.

cd /opt/orbixadm
rm -rf orbix

  Orbix is installed during the normal course of the VPN Solutions Center software installation process.

---

Note   Running the Netscape browser with VPN Solutions Center 1.2 requires the Java Plug-in 1.12_004 for Solaris 2.4 to 2.6. You can retrieve this plug-in from the following site: http://java.sun.com/products/plugin/1.1.2/download.html

---

By default, the VPN Solutions Center software is installed in the home directory specified for the vpnadm user ID. Likewise, the Orbix software is installed by default in the home directory specified for the orbixadm user ID.

Step 2   At the command line, enter:

admintool

The Admin Tool widow appears.

Defining the Group for the VPNSC and Orbix User IDs

Step 3   From the Admin Tool menu bar, choose Browse > Groups.

The Groups window appears.

Step 4   Choose Edit > Add.

Step 5   Enter the Group Name.

Step 6   Enter a unique number for the Group ID, then click Apply.

Step 7   Click OK.

Defining the vpnadm User ID

Step 8   From the Groups window, choose Browse > Users.

Step 9   From the Users window, choose Edit > Add.

Step 10   To create the vpnadm user ID, enter vpnadm in the User Name field.

Step 11   In the Primary Group field, enter the same number you set for the Group ID in Step 6.

Step 13   Click OK.

Defining the Orbixadm User ID

Step 14   From the Users window, choose Edit > Add.

Caution When you insert the CD-ROM, the File Manager is invoked automatically. Do not use the File Manager to install the product. Run the installation script from a terminal window.

Invoking the VPN Solutions Center 1.2 Installation Utility

Step 2   Open a terminal window and log in as the root user (su).

Note   Make sure that the root user has full access to the installation directory.

Step 3   Change directory to the cdrom directory.

cd /cdrom/cdrom0

Step 4   Execute the product installation script:

cdrom> ./vpninstall

The installation script vpninstall is located in the root directory. The VPN Solutions Center software is installed by default in the /opt/vpnadm directory.

The general installation instructions are displayed. Press Enter to page through them. Then the installation prompts are displayed.

Note   The complete installation for the VPN Solutions Center software and Orbix software requires 650 MB disk space.

Orbix Installation

Are OrbixWeb 3.2 and Orbix 3.0.1 already installed? y/n [n]

• If Orbix has not been installed, press Enter. The installation utility prompts for the Orbix user ID (see Step 6).

• If Orbix has been installed and you do not wish to reinstall Orbix, type y for yes and press Enter. Proceed to Step 7.

  Steps 11 and 12 below are not displayed in this case.

Step 6   Enter the user ID for the owner of Orbix software (orbixadm is the default).

Step 8   Confirm or change the domain name of the host machine, then press Enter.

The installation utility finds the current domain name and displays it.

Accept this domain name and proceed with the installation? y/n [y]

The installation utility pings the indicated domain to confirm connectivity.

Step 9   Enter the path for the location of the Orbix configuration files.

Press Enter for the default directory (which is now the path entered in the previous step), or enter a new path to the Orbix configuration files.

Step 10   If Orbix directories and files already exist in the Orbix directory, the installation utility asks whether you want to overwrite those directories, or specify a different user name and path for the Orbix software.

/opt/orbixadm/orbix/Orbix3
Overwrite the directory contents? y/n [n]

• If you want to retain the existing Orbix installation, accept the default (No) by pressing Enter

• If you want the VPN Solutions Center installation utility to install Orbix, type y for Yes and press Enter.

Setting Up the vpnadm User and Directories

Step 11   Enter the user ID for the owner of the VPN Solutions Center 1.2 software.

The default user ID for the product software is vpnadm. Press Enter.

Step 12   Confirm the installation directory for the VPN Solutions Center 1.2 software.

Note   The installation directory requires a minimum of 500 MB of free disk space.

Press Enter for the default directory (/opt/vpnadm), or enter a new path for the product installation directory.

The installation utility creates a new directory named "vpn" in this path. Thus, the full directory path to the VPN Solutions Center software installation is /opt/vpnadm/vpn.

This step creates a directory named tmp, if one does not yet exist.

Press Enter for the default directory (/opt/vpnadm/vpn/tmp), or enter a new path for this directory.

Note   Cisco recommends that you create the directory for temporary files on a disk with ample storage space. If you do change the location of the tmp directory, note that the tmp directory path is specified in four places in the /opt/vpnadm/vpn/etc/ csm.properties file. To make sure all temporary files are placed in one directory, be sure to update all four lines in the csm.properties file with the new path.

Setting Up the Directory for the Repository

This step creates a directory named Repository, if one does not yet exist.

   a. Press Enter for the default directory (/opt/vpnadm/Repository), or enter a new path for the Repository directory.

  If the Repository does exist, the VPNSC 1.2 installation utility warns you that the Repository contains files and asks whether you want to overwrite the existing Repository. The default is to not overwrite the Repository.

Note   In most cases, it is inadvisable to overwrite the Repository, which effectively removes it from your product installation.

  Overwrite the Repository directory contents? y/n [n]

   b. If you want to retain the existing Repository, accept the default by pressing Enter.

   c. If you want the VPN Solutions Center installation utility to overwrite the existing Repository, type y for Yes, then press Enter.

Software Installation Begins

The installation of the Orbix and VPN Solutions Center software begins:

Installing Orbix software...Please stand by.
Installing VPNSC 1.2...Please stand by.
Installation may take 20 to 30 minutes.

Csm.Properties File Updated

The VPNSC 1.2 installation utility informs you that the following part of installation will set certain values in the csm.properties file. You can also edit the file manually after installation. The csm. properties file is located in the /opt/vpnadm/vpn/etc directory.

Setting the Port Number for the TIBCO Rendezvous Port

Tips If you install VPN Solutions Center software on more than one workstation within the same network, be sure to use a unique TIBCO port number for each installation.

Do you want to assign a new port to TIBCO Rendezvous? y/n [n]

   a. If you want to accept the default port number (7500), press Enter.

   b. If you want to assign a different port number, type y for Yes, then press Enter.

  You are prompted to enter the TIBCO Rendezvous port number.

Enter the new port for TIBCO Rendezvous
Enter a new value or press ENTER for the default [7500]:

   c. Enter the new port number and press Enter.

Tips You can check to see all the current application/protocol-to-port number assignments by viewing the /etc/services file on the VPNSC workstation. If the default port number of 7500 is already assigned to another application or protocol, be sure to specify an integer that is not in the services file list.

Specifying the Path to the Default Browser

Would you like to specify the default browser for this application? y/n [y]

Accept the default by pressing Enter.

Step 17   Enter the full path for the browser, then press Enter.

The browser path specified here is added to the csm.properties file so that VPNSC can locate the browser for viewing logs and reports.

Configuring Cisco IP Manager for VPNSC 1.2

Configure the application interface to Cisco IP Manager? y/n [y]

Accept the default by pressing Enter.

For the next steps in the installation procedure, note the host name for the Cisco IP Manager Name server and the Network Element Module (NEM) server. These CIPM servers should be installed on the IP Manager host system.

Note   If you do not specify the IP Manager host name in this installation sequence, you will have to manually add this information to the /opt/vpnadm/vpn/etc/ csm.properties file when the installation is complete.

Step 19   When prompted for the host name for the IP Manager Name server for the VPNSC 1.2 domain, enter the name of the server where Cisco IP Manager is installed.

CIPM host name:

The installation utility pings the named server to test connectivity.

CIPM host name:

The installation utility pings the named server to test connectivity.

Updating the Startup Configuration File

Do you want to automatically copy the running configuration to the startup configuration after the product downloads configlets to routers? y/n [y]

Accept the default (yes) by pressing Enter.

Setting Up E-Mail Notification

Would you like to specify the e-mail notification settings? y/n [y]

• If you wish to specify the e-mail notification settings, press Enter and proceed to the next step.

• If you do not wish to define e-mail notification settings, enter n for No. This completes the installation. Proceed to Step 26, "Setting the High and Low Watermarks for Free Disk Space."

Step 23   Enter the host name of the Simple Mail Transfer Protocol (SMTP) host.

Step 24   Enter the username or ID to be displayed in the From field.

The default value is the vpnadm username.

Step 25   Enter the list of e-mail addresses to be automatically notified of server restarts.

Setting the High and Low Watermarks for Free Disk Space

• To indicate the high and low watermarks in megabytes, enter the letter M after the integer; for example, 50M.

• To indicate the high and low watermarks as a percentage of disk space, enter an integer (in the range from 0 to 100) followed by the % symbol; for example, 10%. The defaults are set in percentages.

   a. Enter the high water mark for free disk space.

Enter a new value or press ENTER for the default [20%]:

   b. Enter the low water mark for free disk space.

Enter a new value or press ENTER for the default [10%]:

   c. Enter the e-mail ID to send disk space notifications to.

Enter a new value:

   d. You are prompted to confirm the e-mail ID you entered. Enter y for Yes to confirm the e-mail address.

Are you sure the given email-id is valid? y/n [n]:

Updating the CSHRC File for the vpnadm User

Step 27   You are prompted to update the appropriate shell file for the vpnadm user with the VPNSC 1.2 environmental variables.

Do you want to update vpnadm's cshrc file? y/n [y]

Accept the default (yes) by pressing Enter.

The product installation is now complete.

Exiting From the VPNSC 1.2 Installation Utility

Step 28   To exit from the VPNSC 1.2, installation, exit from the root user.

exit

xhost VPNSC_hostname

The VPNSC_hostname parameter is the name of the VPN Solutions Center workstation. This command configures your system so that the Orbix user (orbixadm) and the VPNSC user (vpnadm) can communicate with your client system.

Step 2   Log in as the owner of the Orbix process (orbixadm).

su - orbixadm

When logged in, you are placed in the /opt/orbixadm directory.

Or if you are logging in remotely, enter this command:

rlogin VPNSC_hostname -l orbixadm

Step 3   Change directory to the directory where Orbix is installed.

cd orbix/Orbix3

You are now in the /opt/orbixadm/orbix/Orbix3 directory.

Step 4   Issue the following command to source the environment as required for your shell:

C-Shell: source setenvs.csh

K-Shell: . ./setenvs.sh

Step 5   Start the Orbix process in the background:

orbixd &

Step 2   Log in as the owner of the VPN Solutions Center software (vpnadm).

su - vpnadm

When logged in, you are placed in the /opt/vpnadm directory.

Or if you are logging in remotely, enter this command:

rlogin VPNSC_hostname -l vpnadm

Step 3   Go to the VPN Solutions Center installation directory.

cd vpn/

You are now in the /opt/vpnadm/vpn directory.

Step 4   Issue the following command to source the environment as required for your shell.

C-Shell: source vpnenv.csh

K-Shell: . ./vpnenv.sh

Step 5   Set the display variable for the VPN Solutions Center workstation.

setenv DISPLAY VPNSC_hostname:0.0

Step 6   Start the application's WatchDog processes:

startwd

To stop the WatchDog process, issue the stopwd -y command.

Step 7   If you would like to confirm that the servers are running, issue the following command:

wdclient status

wdgui &

Note   These commands are recommended, but are not required in the startup sequence.

Step 8   Issue the following command to start the VPN Console:

vpnconsole &

The default username is admin. The default password is admin.

Note   You cannot change the admin username, but you can change the password for the admin user. Additionally, you can add new usernames and assign their associated passwords. For details, see "User Administration" in Chapter 10 of the Cisco VPN Solutions Center: MPLS Solution User Reference, Release 1.2.

For information on MPLS VPN technology and instructions on how to use the VPN Solutions Center VPN Console to provision VPNs and deploy service requests, refer to the Cisco VPN Solutions Center: MPLS Solution Provisioning and Operations Guide, Release 1.2.

To shut down the VPN Solutions Center software, execute these commands:

Step 2   If the Watchdog user interface (wdgui) is running, close it by selecting the window, right-click, then choose Close from the menu.

stopwd -y

Step 4   Log out (exit) from the vpnadm user.

Step 5   From the terminal window from which you launched Orbix, shut down the Name Server:

killit NS

Step 6   Discover the process ID of Orbix:

ps -ef | grep orbixd

Step 7   Shut down the Orbix process by issuing this command:

kill orbixd_process_ID

Step 8   Log out (exit) from the orbixadm user.

Step 2   Log in as root.

Step 3   Make sure there are no product or Orbix processes running.

ps -ef | grep vpnadm

ps -ef | grep orbixadm

Step 4   If vpnadm or orbixadm processes are running, kill those processes.

Step 5   Go to the directory directly above the installation directory:

cd /opt/vpnadm/

Step 6   Remove the vpn directory and its contents.

rm -rf vpn &

Note   You do not need to remove the Repository directory or the Orbix directory.

Step 7   Log out (exit) from the root user.