Installing and Starting the MPLS VPN Solution Software

• MPLS VPN software

• OrbixWeb and Orbix

• Cisco Watchdog

• VPN Console

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

Before You Install the Software

---

Note Running the Netscape browser with MPLS VPN Solution 1.1 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

---

The installation utility employs these user names to designate the owners of the MPLS VPN Solution software and the Orbix software respectively.

Tips In the AdminTool's Home Directory field, be sure to specify the home directory for the vpnadm user as /opt/vpnadm and the home directory for the orbixadm user as /opt/orbixadm.

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

cd opt/orbixadm

rm -rf orbix

Step 3 Insert the MPLS VPN Solution installation CD-ROM.

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.

Step 4 Open a terminal window and log in as root.

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

Step 5 Change directory to the cdrom directory.

cd /cdrom/cdrom0

Step 6 Execute the product installation script:

cdrom> ./vpninstall

The installation script vpninstall is located in the root directory. The MPLS VPN Solution software is installed by default in your home directory. You can change this directory during installation.

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

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

Are OrbixWeb3.2.0.4 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 name (Step 8).

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

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

Step 8 Enter the user name for the owner of Orbix software (orbixadm is the default).

This step assumes that you have already created the user name for Orbix software, as described in Step 1 of this procedure.

Press Enter.

Step 9 Indicate the directory for the Orbix installation.

By default, the installation utility creates a directory called orbix in the home directory of the Orbix user name entered in Step 1.

/opt/orbixadm/orbix/Orbix3

Press Enter for the default directory, or enter a qualified path to the orbix directory.

Step 10 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 11 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 12 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 [y]

• If you want to retain the existing Orbix installation, type n for No and press Enter.

• If you want the MPLS VPN Solution installation utility to install Orbix, accept the default by pressing Enter.

Step 13 Enter the user name for the owner of the MPLS VPN Solution software.

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

Step 14 Confirm the installation directory for the MPLS VPN Solution software.

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 MPLS VPN Solution 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 the new path in all four lines in the csm.properties file.

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

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

If the Repository does exist, the installation utility 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]

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

• If you want the MPLS VPN Solution installation utility to overwrite the existing Repository, type y for Yes and press Enter.

The installation of the Orbix and MPLS VPN Solution software begins.

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

Accept the default by pressing Enter.

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

The browser path specified here is added to the vpn/etc/csm.properties file so the file can find the browser for viewing logs and reports.

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

Accept the default by pressing Enter.

Step 20 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.

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 21 Enter the host name for the server where Cisco IP Manager is installed.

Server name:

The installation utility pings the named server in each case to test connectivity.

Server name:

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 by pressing Enter.

Step 24 MPLS VPN Solution can send e-mail notification when a server restarts.

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 27.

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

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

The default value is the vpnadm username.

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

The product installation is now complete.

Step 28 Exit from root.

exit

Step 3 Ask your system administrator for assistance if necessary.

Step 2 To keep the startup operations conveniently organized, open three terminal windows---one window for the xhost process, one for the VPN Console and Watchdog, and a third window for Orbix.

xhost MPLS_VPN_hostname

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

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

rlogin computer_name -l orbixadm

or

su - orbixadm

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

cd /opt/orbixadm/orbix/Orbix3

Step 4 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 MPLS VPN Solution software (vpnadm).

rlogin computer_name -l vpnadm

or

su - vpnadm

Step 3 Go to the MPLS VPN Solution installation directory.

cd /opt/vpnadm/vpn/

Step 4 Source the environment as required for your shell.

C-Shell: source vpnenv.csh

K-Shell: . ./vpnenv.sh

Step 5 Start the application's Watchdog processes:

startwd

Note To stop the Watchdog process, issue the stopwd -y command.

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

wdclient status

Note This command is recommended, but it is not a required command in the startup sequence.

Step 7 Start the VPN Console:

vpnconsole &

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 VPN Solution User Guide.

To shut down the MPLS VPN Solution software, execute these commands:

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

Step 3 From the window where Watchdog was launched, close the Watchdog by issuing this command:

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 orbixd:

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 Make sure there are no product or Orbix processes running.

ps -ef | grep vpnadm

ps -ef | grep orbixd

Step 3 If vpnadm or orbixd processes are running, kill those processes.

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

cd /opt/vpnadm/

Step 5 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 6 Log out (exit) from the root user.