TransNav Xpert Installation Guide

Transcription

1 TransNav Xpert Installation Guide R May 2011 R

2 Copyright 2011 Force10 Networks, Inc. All rights reserved. Force10 Networks reserves the right to change, modify, revise this publication without notice. Trademarks Force10 Networks and E-Series are registered trademarks of Force10 Networks, Inc. Traverse, TraverseEdge, TraversePacketEdge, TransAccess, are registered trademarks of Force10 Networks, Inc. Force10, the Force10 logo, and TransNav are trademarks of Force10 Networks, Inc. or its affiliates in the United States and other countries and are protected by U.S. and international copyright laws. All other brand and product names are registered trademarks or trademarks of their respective holders. Statement of Conditions In the interest of improving internal design, operational function, and/or reliability, Force10 Networks, Inc. reserves the right to make changes to products described in this document without notice. Force10 Networks, Inc. does not assume any liability that may occur due to the use or application of the product(s) described herein.

3 Table of Contents Item Page Chapter 1 System Requirements Prerequisites Minimum Disk Space Requirements Minimum Software Requirements Create Solaris Groups and Users Create Solaris Groups Create EMS User Setting Quotas for TN-Xpert Editing vfstab Create Quota Files Edit emsuser Quotas Editing Kernel Parameters Editing the System Specification File Chapter 2 Oracle Installation and Configuration Overview Oracle 10g Installation Prerequisites for Solaris Adding a User in Oracle Create Oracle Installation Directory Edit Oracle User Profile Install Oracle Oracle 10g ( ) Uninstall Oracle 9i ( ) Uninstall Chapter 3 TN-Xpert Server for Solaris Installation TN-Xpert Server for Solaris Installation Launching Installer Installation Information TN-Xpert Oracle Database Creation Create Database Directories Create the TN-Xpert Database Configure Oracle Automatic Startup or Shutdown at Boot-time TN-Xpert Server for Solaris Upgrade Shut Down TN-Xpert Clients and Server Install the TN-Xpert Server Data Migration Data Migration from R05.0[0 1 2].0[0 1] to R Create a Database Backup SQL Data Migration Migration Fallback Procedure from R to R05.0[0 1 2].0[0 1] Exporting and Importing TN-Xpert Data Exporting TN-Xpert Data from the Oracle Database Importing TN-Xpert Data into the Oracle Database Upgrade Oracle and TN-Xpert Shut Down TN-Xpert Backup the Oracle Database Uninstall Oracle 9i ( ) Install Oracle 10g ( ) Install the TN-Xpert Server Create the TN-Xpert Oracle Database Import the Database Data Data Migration Chapter 4 Redundant TN-Xpert Systems for Solaris Installation and Release Force10 Networks Page iii

4 Configuration Overview Prerequisites Set Up Redundant TN-Xpert Systems Redundant Oracle Installation Redundant TN-Xpert Server Installation Redundant Oracle Database Creation and Configuration Setup Primary and Standby Database Redundant TN-Xpert Server Configuration Chapter 5 TN-Xpert Client for Solaris Installation Prerequisites TN-Xpert Client for Solaris Upgrade TN-Xpert Client for Solaris Installation Launching Installer Installation TN-Xpert Client Uninstall Chapter 6 Installing TN-Xpert Client for Windows Prerequisites TN-Xpert Client for Windows Upgrade TN-Xpert Client for Windows Installation/Upgrade Launching the Installer Installation Chapter 7 TN-Xpert PC for Windows Prerequisites TN-Xpert PC requirements Minimum Disk Space Requirements Overview Oracle Installation and Uninstallation Oracle 9i Installation Oracle 9i Uninstall Install Oracle 10g Oracle 10g Uninstall TN-Xpert PC Installation or Upgrade TN-Xpert PC Installation TN-Xpert Database Creation Configure Service for Oracle 9i Configure Service for Oracle 10g TN-Xpert PC Upgrade Shutdown TN-Xpert PC TN-Xpert PC Installation Data Migration TN-Xpert PC Database Migration from R05.0[0 1 2].0[0 1] to R Create Database Backup SQL Data Migration Procedure Migration Fallback Procedure R to R05.0[ ].0[0 1] Exporting and Importing TN-Xpert Data Exporting TN-Xpert Data from Oracle Database Importing TN-Xpert Data into Oracle Database Upgrade Oracle from 9i to 10g andd TN-Xpert R05.0[ ].0[0 1] Shut down TN-Xpert PC Backup the Oracle Database Uninstall Oracle 9i ( ) Install Oracle 10g ( ) Release Force10 Networks Page iv

5 7.8.8 Install the New Version of TN-Xpert PC Create the TN-Xpert Database Import the Data from the Database Backup Launching and Shutting Down TN-Xpert Launching TN-Xpert Shutting Down TN-Xpert Release Force10 Networks Page v

6 Page vi Force10 Networks Release 5.3.0

7 Chapter 1 System Requirements This document assumes that the workstation already has Solaris installed. Please contact the local Systems Administrator for assistance if Solaris is not installed on the workstation. Once Solaris is installed, a number of custom configuration items must be performed to create users and format partitions. NOTE: In Release 5, the EMS product name was changed from TN-Xpert to TN-Xpert. The user documentation now refers to the EMS Release 5 as TN-Xpert and refer to prior releases as TN-Xpert. This section covers the following topics: Section 1.1 Prerequisites Section 1.2 Create Solaris Groups and Users Section 1.3 Setting Quotas for TN-Xpert Section 1.4 Editing Kernel Parameters 1.1 Prerequisites Prior to installing TN-Xpert, certain minimum requirements must be met. The following table lists the minimum requirements for the Solaris-based server to support a sample system of 100 nodes. Table 1-1 Solaris System Requirements for TN-Xpert OPTIONAL: Hardware RAID controller Tape backup system Solaris 9 Solaris 10 Operating System Sun Solaris 9 Sun Solaris 10 Oracle Version Server ORACLE 9i ( ) or 10g ( ) Standard or Enterprise Edition Netra 240 Medium Configuration Processor UltraSPARC IIIi processor GHz ORACLE 10g ( ) Standard or Enterprise Edition SunFire T1000 Medium Configuration UltraSPARC T1 processors 6 core -1.0 GHz Memory 2 GB RAM, 8 MB of cache 4 GB RAM, 8 MB of cache Hard Drives 73 GB free SCSI hard drive disk space 73 GB free SCSI hard drive disk space Network 100Base-T Ethernet network card 100Base-T Ethernet network card Release Force10 Networks Page 1

8 1.1.1 Minimum Disk Space Requirements It is required that the PC for TN-Xpert has the minimum disk space required for each of the components. Table 1-2 Minimum Disk Space Requirements Name Typical Location Minimal Disk Space Required Description Oracle Installation /opt/oracle 4.0 Gigabytes Location for Oracle server software. Oracle migrdirectory /u01/oradata 2 Gigabyte (or calculated value) EMS Data Directory /u02/oradata 2 Gigabyte (or calculated value) EMS Index Directory /u03/oradata 30 Gigabytes (or calculated value) Stores Oracle system tablespace. Stores EMS application data Stores EMS applications indexes and high volume data such a PM. PM Data Storage Requirements The disk space required relies heavily on the number of nodes being managed as well as the amount of PM data being collected/stored. The minimum requirement is 40 Gigabytes which assumes managing 100 nodes, three TN-Xpert database backups and scheduled PM cleanup every 30 days Minimum Software Requirements The following is a minimum requirement for the Sun workstation that will run the TN-Xpert Server for Solaris. Operating System The Sun workstation must be running the Solaris operating system. Only Solaris 9 or 10 Creating Partitions for Oracle Data (Optional) In a later section of this document, the user will be instructed to perform a procedure for installing the TN-Xpert database instance for Oracle. A prerequisite to that procedure is the creation of files for Oracle to use for storing data. Although these files can be created in a non-dedicated partition, it is recommended that each of these files exist in its own partition (logical or physical). This will allow tuning to be done by the System Administrator or Oracle Database administrator (DBA). This is an optional procedure. Step 1 Calculate the partition sizes using the information in Table 1-3 below. Step 2 Launch the partitioning tool. format (or other system administration tool for creating partitions) Page 2 Force10 Networks Release 5.3.0

9 Step 3 Create the following partitions. Table 1-3 Oracle Data Partition Sizes Name Minimal Size /var /opt 2.5 Gb 4Gb /u01 2 Gb /u02 2Gb /u03 Remaining Disc Space 1.2 Create Solaris Groups and Users Prior to installing TN-Xpert, two Solaris Groups and two Solaris Users must be created. These are typically tasks that are performed by a knowledgeable Systems Administrator. A high level of Solaris knowledge is assumed Create Solaris Groups The following commands require root access. From a terminal window while logged in as the root user, initiate the Solaris Management Console (SMC) and create an emsuser group. Step 1 From the root user prompt, initiate the SMC. # smc Figure 1-1 Solaris Management Console Welcome Window Release Force10 Networks Page 3

10 Step 2 Step 3 Select Management Tools, then click Open. The Management Tool Console displays. Open the Users management tool. In the Navigation pane on the left side of the Management Tools window, select Management Tools, This Computer, System Configuration, and then Users. Enter the root password to add or edit users. Figure 1-2 Add Group Step 4 Table 1-4 Create the group with the following configuration. Write the Group ID in the space provided for future reference during creation of the user below. EMS User Group Group Name Group ID (setting) Group ID (written) Member List emsuser default null Create EMS User The following command requires root access. From a terminal window while logged in as the root user, initiate the Solaris management console (SMC) and create an emsuser user. Step 1 From the root user prompt, initiate the SMC. # smc Page 4 Force10 Networks Release 5.3.0

11 Step 2 From the Action menu, select Add User > With Wizard. Figure 1-3 Add User with Wizard Step 3 Table 1-5 The Add User Wizard dialog box displays. Create the user with the following configuration. Use the Group ID from the previous section. EMS User User Name User ID Primary Group Login Shell (example) Password Home Directory (example) emsuser default Group ID from emsuser KSH Normal Password /var/home/emsuser Figure 1-4 Add User Wizard, Add User Name Release Force10 Networks Page 5

12 Step 4 Add a unique user identification number for the user being added. Figure 1-5 Add User Wizard, Add User ID Number Step 5 Enter the user s password in Step 3 of the Add User Wizard. You can select to either lock the user account or set a password that the user must use the first time they logon. Figure 1-6 Add User Wizard, Set User s Password Page 6 Force10 Networks Release 5.3.0

13 Step 6 Select the Primary Group for the user s password in Step 4 of the Add User Wizard. Figure 1-7 Add User Wizard, Select Primary User Group Step 7 In Step 5 of the Add User Wizard, select the home directory for the user. Figure 1-8 Add User Wizard, Add User Home Directory Release Force10 Networks Page 7

14 Step 8 In Step 6 of the Add User Wizard, set the mail server to enable the user to send and receive mail. Figure 1-9 Add User Wizard, Specify Mail Server Step 9 The final step of the Add User Wizard allows you to review the information entered. Figure 1-10 Add User Wizard, Review Information Page 8 Force10 Networks Release 5.3.0

15 1.3 Setting Quotas for TN-Xpert In order to monitor disk space usage, TN-Xpert requires that a disk quota be enabled for the emsuser user on the file system used to host the TN-Xpert data directory. The quota must be sufficient to hold the minimum data size indicated in the table above for the TN-Xpert data directory. When the maximum quota value is approached by the emsuser user, a standing alarm will be present on the TN-Xpert server Editing vfstab The file /etc/vfstab must be edited and the entries for both /var and /opt need to be edited. Step 1 Step 2 Step 3 Log in as the root user. Edit the file /etc/vfstab. # vi /etc/vfstab Replace the dash - at the end of the FS type /var. and /opt with the letters rq Create Quota Files Quota files must be created in both the /var and /opt directories. Step 1 Step 2 Step 3 Log in as the root user. Create a file called quotas in the /var directory. # cd /var # touch quotas # chmod 600 quotas Create a file called quotas in the /opt directory. # cd /opt # touch quotas # chmod 600 quotas Edit emsuser Quotas TN-Xpert must have quota block limits set for both the /var and /opt directories. Step 1 Log in as the root user. Step 2 By issuing the edquota command, the default editor will be invoked and a file can either be created or edited. The following lines should be added to the file invoked by issuing the edquota command. # edquota emsuser Release Force10 Networks Page 9

16 Step 3 Step 4 In a text editor, enter the following lines as listed: fs /var blocks <soft = , hard = > inodes <soft = 0, hard = 0> fs /opt blocks <soft = , hard = > inodes <soft = 0, hard = 0> Save the changes. 1.4 Editing Kernel Parameters Prior to installing Oracle, a few system settings must be either added or edited to certain minimum values Editing the System Specification File This section is to verify that the kernel parameters that are currently setup on the workstation are the sufficient to support Oracle. The system specification file must be searched for the following settings for shared memory and semaphores. Step 1 Step 2 Edit the /etc/system file. # vi /etc/system Search the file for the following settings. If a parameter is found and is set to a lower value than the value shown below, set the value to the value shown. If a parameter is found and is already set to a higher value than the value shown below, leave the value as it is. If a parameter is not found, enter the value as shown. NOTE: Check each of the following parameters and verify that the =XXXX number at the end of each string is equal to or more than the values indicated in the following examples. set shmsys:shminfo_shmmax= Step 3 set shmsys:shminfo_shmmin=1 set shmsys:shminfo_shmmni=100 set shmsys:shminfo_shmseg=10 set semsys:seminfo_semmns=1024 set semsys:seminfo_semmni=100 set semsys:seminfo_semmsl=256 set semsys:seminfo_semopm=100 set semsys:seminfo_semvmx=32767 set noexec user statck=1 set noexec user stack log=1 Save changes and exit using the following command: ESC:wq! Page 10 Force10 Networks Release 5.3.0

17 Step 4 Reboot the machine for the changes to take effect (only needed if changes were made). # init 6 NOTE: User must be logged in as supervisor level to issue init commands. Release Force10 Networks Page 11

18 Page 12 Force10 Networks Release 5.3.0

19 Chapter 2 Oracle Installation and Configuration This chapter describes the initial configuration of the Oracle database and creation of the TN-Xpert databases on a Solaris operating system. Backup, Purge, and Restoration Utilities are discussed along with some basic Oracle administration procedures. Users can install Oracle 10g for either a Solaris or Windows operating system. For installation of the Oracle database server on a Windows operating system, see Section 7.3 Oracle Installation and Uninstallation. Refer to the following sections: 2.1 Overview 2.2 Oracle 10g Installation Prerequisites for Solaris Adding a User in Oracle Create Oracle Installation Directory Edit Oracle User Profile Install Oracle 2.3 Oracle 10g ( ) Uninstall 2.4 Oracle 9i ( ) Uninstall 2.1 Overview TN-Xpert server for Solaris uses the Oracle relational database management system (RDBMS) to manage both TN-Xpert persistent data and cached data. By caching network data in the local database, TN-Xpert provides optimal performance to the end-users and generates less traffic on the network. The TN-Xpert database also stores information that does not exist, or no longer exists, in the network (such as TN-Xpert account information and PM history data). In order to use the TN-Xpert application, the user must have Oracle software installed and must follow the database installation procedure described in this chapter. 2.2 Oracle 10g Installation This document assumes that an Oracle DBA is available to perform the Oracle installation and preparation for installation. NOTE: The recommended Oracle 10g version is defined in Chapter 1, Section 1.1 Prerequisites. This is the only Oracle 10g version tested with TN-Xpert. Release Force10 Networks Page 1

20 2.2.1 Prerequisites for Solaris Verify and configure the current Solaris system s kernel parameter settings and OS patches to support Oracle 10g. Step 1 Step 2 Edit /etc/system file using vi. # vi /etc/system Search the file for the following settings. If a parameter is found and is set to a lower value than the value shown below, set the value to the value shown. If a parameter is found and is already set to a higher value than the value shown below, leave the value as it is. If a parameter is not found, enter the value as shown. NOTE: Check each of the following parameters and verify that the =XXXX number at the end of each string is equal or more than the values indicated in the following examples. set shmsys:shminfo_shmmax= Step 3 Step 4 set shmsys:shminfo_shmmin=1 set shmsys:shminfo_shmmni=100 set shmsys:shminfo_shmseg=10 set semsys:seminfo_semmns=1024 set semsys:seminfo_semmni=100 set semsys:seminfo_semmsl=256 set semsys:seminfo_semopm=100 set semsys:seminfo_semvmx=32767 set noexec_user_stack=1 set noexec_user_stack_log=1 Save changes and exit using the following command; ESC:wq! Reboot the machine for the changes to take effect (only needed if changes were made). # init 6 NOTE: User must be logged in as root to issue init commands. Step 5 Check the Solaris s OS patches needed for Oracle 10g. Page 2 Force10 Networks Release 5.3.0

21 The system must meet the following minimum software requirements: The version of Solaris must be Solaris 9 or Solaris 10. The following packages must be installed: SUNWarc SUNWlibms SUNWi1of SUNWbtool SUNWsprot SUNWi1cs SUNWhea SUNWsprox SUNWi15cs SUNWlibm SUNWtoo SUNWxwfnt The following patches must be installed: Patches for Solaris 9: : SunOS 5.9: Kernel Patch : SunOS 5.9: Math Library (libm) patch To ensure the system meets these requirements, follow these steps: Step 1 To determine which version of Solaris is installed, enter the following command: # uname -r Step 2 Step 3 Step 4 If a package is not installed, then install it. See your operating system or software documentation for information about installing packages. To determine whether an operating system patch is installed, enter a command similar to the following: # /usr/sbin/patchadd -p grep patch_number If an operating system patch is not installed, download it from the following Web site and install it: This document assumes that an Oracle database administrator (DBA) is available to prepare for and then perform the Oracle installation. Release Force10 Networks Page 3

22 2.2.2 Adding a User in Oracle Step 1 Enter the Solaris management console (SMC) command to bring up the SMC Welcome window. # smc Figure 2-1 Solaris Welcome Window Step 2 Login as root user in a terminal shell. Figure 2-2 Log in as Root User Page 4 Force10 Networks Release 5.3.0

23 . TransNav Xpert Installation Guide Add a User Group Step 3 Add a user group named dba (Database administrator) by selecting the Admin menu and selecting Add Group. A list of groups appears in the top right pane. Figure 2-3 Groups Step 4 The Add Group dialog box displays. Click the General tab. Figure 2-4 Add Group Release Force10 Networks Page 5

24 Step 5 Step 6 Enter dba in the Group Name field. Select a Group ID Number or assign an ID according to local practices and then click OK. Create A User Step 7 Click the User Accounts icon in the Navigation pane (Management Tools > This Computer > System Configuration > Users > User Accounts). The current user accounts display in the right pane. Enter the new user information using the wizard. Use this table as a reference. Table 2-1 Oracle User (example) Name User ID Primary Group Login Shell Password Home Directory oracle oracle (default) Group ID from dba KSH Normal /var/home/oracle Step 8 From the Action menu, select Add User > With Wizard to display the Add User Wizard dialog box. Step 1 is to add the user s name, full name and a description such as an office location or phone number. Figure 2-5 Add User Wizard, Add User Name Step 9 Step 10 Enter the User s password in Step 3 of the Add User Wizard. You can select to either lock the user account or set a password that the user must use the first time they logon. Page 6 Force10 Networks Release 5.3.0

25 Figure 2-6 Add User Wizard, Set User s Password Step 11 Select the Primary Group for the user s password in Step 4 of the Add User Wizard. Figure 2-7 Add User Wizard, Select Primary User Group Step 12 In Step 5 of the Add User Wizard, select the home directory for the user. Figure 2-8 Add User Wizard, Add User Home Directory Release Force10 Networks Page 7

26 Step 13 In Step 6 of the Add User Wizard, set the mail server to enable the user to send and receive mail. Figure 2-9 Add User Wizard, Specify Mail Server Step 14 The final step, Step 7, of the Add User Wizard allows you to review the information entered. Figure 2-10 Add User Wizard, Review Information Step 15 Select Finish to send the new user data. A window appears indicating the user was created successfully Create Oracle Installation Directory The Oracle installation directory needs to be created by the root user or similar user with system level access. Once it is created, the ownership of the directory needs to be changed to the oracle user. The following procedure uses /opt/oracle/product/10g as the installation directory. Step 1 Step 2 Log in as root user. Create an oracle directory beneath the opt directory. Page 8 Force10 Networks Release 5.3.0

27 NOTE: Make sure an oracle directory does not already exist in the opt directory. If it does, remove it using the rm command (i.e., rm -r oracle). # cd /opt Step 3 Step 4 Step 5 # mkdir oracle Change the owner of the directory to oracle. # chown oracle:dba oracle Open a new terminal window and login as the oracle user. su - oracle Create a product/10g directory beneath the /opt/oracle directory. $ cd /opt/oracle $ mkdir product $ cd product $ mkdir Edit Oracle User Profile The profile of the oracle user must be edited to support the specific installation of TN-Xpert. Step 1 Log in as oracle user. Step 2 Change to the oracle home directory. $ cd Step 3 Step 4 Step 5 $ pwd /var/home/oracle (or appropriate directory) Edit the.profile file. $ vi.profile Comment out all of the existing lines in the.profile file and add the following lines specific to this installation. The following example is for the default installation shown in this documentation and the commands are KORN shell specific. PATH=/opt/oracle/product/10.2.0/bin:/usr/sbin:/usr/bin:/ usr/ccs/bin:/usr/ucb:. export PATH ORACLE_SID=emsdb export ORACLE_SID ORACLE_BASE=/opt/oracle export ORACLE_BASE ORACLE_HOME=/opt/oracle/product/10g 2.0 export ORACLE_HOME Save the changes using the following commands: ESC Release Force10 Networks Page 9

28 Step 6 : (goes to a : prompt) wq <enter> (goes to a $ prompt) Run the new.profile to make the new settings effective...profile Install Oracle Once the directory structure and environment have been set properly, the Oracle Standard Edition must be installed. It is assumed that an Oracle database administrator or other knowledgeable person is available to perform this installation. Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Step 7 Step 8 Step 9 Step 10 Step 11 Log in as oracle user. Verify that the oracle user has access to nm, make, ld and ar by using the which command and verifying that the appropriate path for each program is returned. $ which nm make ld ar The system should respond with the following strings. If something other than these strings appears, the profile is incorrect. /usr/ccs/bin/nm /usr/ccs/bin/make /usr/ccs/bin/ld /usr/ccs/bin/ar Use the echo command to check for oracle SID and ORACLE HOME. echo $ORACLE_SID $ORACLE_HOME The system response should appear as follows: emsdb /opt/oracle/product/ Use the id command to verify the Oracle user. The ID to verify in the dba group is uid=1001 (oracle) gid=101 (dba). id To ensure the display is set correctly so users can monitor the software load progress and respond to the windows that appear during installation, enter the following command sequences from the terminal window to test the display using the system xclock function. /usr/openwin/bin/xclock The xclock should appear on the screen. If it fails to do so, enter the following command: export DISPLAY=[your IP address] (i.e., :0.0) Repeat Step 7 and check the xclock display. If the following message appears Client Not Authorized to Connect to Server, go to the root terminal window and enter the following command: /usr/openwin/bin/xhost + Again, repeat Step 7. The xclock displays. Close the xclock and continue. Page 10 Force10 Networks Release 5.3.0

29 Step 12 Install the Oracle database using the following guidelines. Figure g Welcome Message Step 13 Specify the path of the Oracle inventory directory. Make sure the Oracle user has write permissions for this directory. Select dba as the Operation System group. Click Next to proceed. Destination is <ORACLE_HOME> Figure 2-12 Specify Inventory Directory Release Force10 Networks Page 11

30 Step 14 Select the type of installation. Valid values are Enterprise Edition, Standard Edition (default) and Custom. Select the Standard Edition and click Next to continue. Figure 2-13 Oracle Universal Installer Step 15 Edit the Oracle home name. Enter the name for the installation and the full path where you want to install the product. Figure 2-14 Specify File Location Step 16 The installer verifies the system requirements and verifies the environment meets the minimum installation and configuration requirements. If any warning or manual checks appear, consult your Solaris/Oracle administrator to make the necessary upgrades or configuration changes until the warnings or manual checks no longer exist. Page 12 Force10 Networks Release 5.3.0

31 Figure 2-15 Product Specific Prerequisite Checks Step 17 Choose the Oracle installation directory. Choose the /opt/oracle/product/10g directory. Click OK to set the changes and continue. Figure 2-16 Choose Directory Step 18 The Summary window appears. Click Install to start the software installation. Release Force10 Networks Page 13

32 Figure 2-17 Installation Summary Step 19 The Install window displays indicating the progress of the installation. When the installation is complete, click Next to continue. Figure 2-18 Installation Progress Step 20 Execute the configuration steps. Open a terminal window, login as the root user, and run the scripts (indicated below). When the scripts have completed, return to the Execute Page 14 Force10 Networks Release 5.3.0

33 Configuration Scripts window and click OK. The Execute Scripts window automatically displays during installation. Figure 2-19 Execute Configuration Scripts Execute the following environment variable configuration scripts: -bash-3.00#./root.sh Running Oracle10 root.sh script... The following environment variables are set as: ORACLE_OWNER= oracle ORACLE_HOME= /opt/oracle/product/ Enter the full pathname of the local bin directory: [/usr/ local/bin]: The file "dbhome" already exists in /usr/local/bin. Overwrite it? (y/n) [n]: n The file "oraenv" already exists in /usr/local/bin. Overwrite it? (y/n) [n]: n The file "coraenv" already exists in /usr/local/bin. Overwrite it? (y/n) [n]: n Creating /var/opt/oracle/oratab file... Entries will be added to the /var/opt/oracle/oratab file as needed by the Database Configuration Assistant when a database is created. Finished running generic part of root.sh script. Release Force10 Networks Page 15

34 Now product-specific root actions will be performed. When the configuration scripts have completed, return to the Execute Configuration Scripts window and click OK to exit. Step 21 When the Oracle installation is complete and the configuration scripts have been run, click Exit and then Yes to exit. Figure 2-20 End of Installation 2.3 Oracle 10g ( ) Uninstall NOTE: Always use the Oracle Universal Installer to remove Oracle software. Do not delete any Oracle home directories without first using the Installer to remove the software. Step 1 Login as the root user. Use the following command to see all of the Oracle processes that are running: ps ef grep ora Step 2 Login as the root user. Kill all of the Oracle processes that are running in Step 1. example: kill 9 pid where pid is process id which is probably a number Step 3 Login as the Oracle user. Set the ORACLE_HOME environment variable to specify the path of the Oracle home directory to be removed. example: $ ORACLE_HOME=/opt/oracle/product/ $ export ORACLE_HOME Page 16 Force10 Networks Release 5.3.0

35 Step 4 Step 5 Login as the Oracle user. Uninstall the Oracle components using the Oracle Universal Installer from the desktop GUI. 4a Open a terminal console. Enter the following command: $ORACLE_HOME/oui/bin/runInstallerc 4b In the Welcome window, click Deinstall Products. In the Inventory window, select the Oracle home and all products to be removed, then click Remove. NOTE: If you choose to remove Oracle JVM, the Oracle Universal Installer removes all installed products that depend on Oracle JVM, including the Oracle database. Step 6 Step 7 Step 8 Step 9 Step 10 Step 11 A confirmation window displays to confirm you want to uninstall the products and their dependant components. Click Yes. The Installer displays a progress indicator as it removes the software. When the products have been deleted, click Cancel to exit from the Installer. Login as the Oracle user. Delete the Oracle Universal Installer directories within the Oracle user home directory. rm rf $ORACLE_HOME/oui rm rf $ORACLE_HOME/ouiInventory rm -rf $ORACLE_HOME/jre Login as the Oracle user and delete the $ORACLE_HOME folder where Oracle resides. rm rf /opt/oracle Login as the root user and delete the Oracle files within the /var folder. rm rf /var/opt/oracle 2.4 Oracle 9i ( ) Uninstall NOTE: Always use the Oracle Universal Installer to remove Oracle software. Do not delete any Oracle home directories without first using the Installer to remove the software. Step 1 Login as the root user. To see all of the Oracle processes that are running, enter the following command: ps ef grep ora Step 2 Login as the root user. Manually kill all the running Oracle processes identified in Step 1. e.x kill 9 pid (where pid is the process id, which is probably a number) Step 3 Login as the Oracle user. Set the ORACLE_HOME environment variable to specify the path of the Oracle home directory to be removed. e.x$ ORACLE_HOME=/opt/oracle/product/9.0.1 $ export ORACLE_HOME Release Force10 Networks Page 17

36 Step 4 Login as the Oracle user. Use the following steps to uninstall the Oracle components using the Oracle Universal Installer from the desktop GUI. 4a Open a terminal console. Enter the following command to open the Oracle Universal Installer. $ORACLE_HOME/oui/bin/runInstaller 4b In the Welcome window, click Deinstall Products. 4c In the Inventory window, select the Oracle home and all the products to be removed. Click Remove. NOTE: If you choose to remove Oracle JVM, the Oracle Universal Installer removes all installed products that depend on Oracle JVM, including the Oracle database. 4d A confirmation window displays to confirm that you want to uninstall the products and their dependant components. Click Yes. 4e A progress indicator displays as the software is removed. when the software deletion has completed, click Cancel to exit the Installer, then click Yes. Step 5 Step 6 Step 7 Login as the Oracle user. Delete the Oracle Universal Installer directories within the Oracle user home directory. rm rf $ORACLE_HOME/oui rm rf $ORACLE_HOME/ouiInventory rm -rf $ORACLE_HOME/jre Login as the Oracle user and delete $ORACLE_HOME folder where Oracle resides. rm rf /opt/oracle Login as the root user and delete the Oracle files within the /var folder. rm rf /var/opt/oracle Page 18 Force10 Networks Release 5.3.0

37 Chapter 3 TN-Xpert Server for Solaris Installation NOTE: In Release 5, the EMS product name was changed from TN-Xpert to TN-Xpert. With that, the user documentation refers to EMS Release 5 as TN-Xpert and refers to prior releases as TN-Xpert. For new TN-Xpert installations, please refer to sections: 3.1 TN-Xpert Server for Solaris Installation 3.2 TN-Xpert Oracle Database Creation For upgrading from a pre-release 5.0 TN-Xpert release, see Section 3.3 TN-Xpert Server for Solaris Upgrade. This chapter includes these sections: 3.1 TN-Xpert Server for Solaris Installation 3.2 TN-Xpert Oracle Database Creation 3.3 TN-Xpert Server for Solaris Upgrade 3.4 Data Migration from R05.0[0 1 2].0[0 1] to R Exporting and Importing TN-Xpert Data 3.6 Upgrade Oracle and TN-Xpert 3.1 TN-Xpert Server for Solaris Installation NOTE: This procedure is for a new installation. For upgrading from a previous TN-Xpert (a TN-Xpert release) refer to Section 3.3 TN-Xpert Server for Solaris Upgrade. This section describes the installation process for TN-Xpert Server on Solaris. Java Runtime Environment (JRE) is bundled with the installers, so no Java virtual machine is required from the target system to run the installer Launching Installer The following instructions are for installing the TN-Xpert Server for Solaris using the.bin install program installed on your Solaris machine. Download the TN-Xpert software from the Force10 website ( or from the Infocenter. Save it to a directory on a server that is easily accessible to all users. NOTE: You must be logged in as a root user to issue install commands. Step 1 Launch the server installer for Solaris. Step 1 For new installations, launch the server installer: *./server.bin. In the case of an upgrade from a previous release, launch update.bin. NOTE: Use the update.bin shell script only if a previous version of the TN-Xpert exists. 1a Launch the server installer for new installations: #./server.bin 1b Launch the server installer for upgrading from a previous release: Release Force10 Networks Page 1

38 #./update.bin Installation Information The TN-Xpert installer will show screens in the following order. Step 1 This splash screen appears for a few seconds as the software starts to load. Figure 3-1 TN-Xpert Server Splash Screen Step 2 The Introduction screen defines the release of TN-Xpert to be installed. Select Next to continue the installation. Figure 3-2 TN-Xpert Introduction Screen Step 3 The License Agreement contains the TN-Xpert License agreement statement. After reading the License Agreement, select I accept the terms of the License Agreement and Install to continue. Page 2 Force10 Networks Release 5.3.0

39 Figure 3-3 License Agreement Screen Step 4 The Choose Install Directory screen appears and defaults to the /opt/tn-xpert/server directory. An alternate directory can be selected by either typing in a valid path, or selecting Choose to browse the existing file structure. Select Restore Default Folder to reset the selection to the /opt/tn-xpert/server directory. Select Install to proceed. Figure 3-4 TN-Xpert Install Directory Screen Step 5 A Status screen displays showing the progress of the installation. The installation takes 1 to 3 minutes. The process can be aborted by selecting Cancel. Release Force10 Networks Page 3

40 Step 6 On the next screen, select the TCP port number and the Server TID. Force10 recommends using the default values for both fields. If the Server Port value is changed, it must be greater than Each TN-Xpert client installation must know the value of the TCP port used by the server to communicate with it. The Server TID should be one word and no more than 20 characters long. Figure 3-5 TN-Xpert Server Properties, Server Port and TID Step 7 From the Oracle Database Information screen, select the IP address and TCP port number to use to communicate with Oracle. Enter the IP address of the workstation that has Oracle installed as the Database Server Host Name. Typically, this is the same machine where TN-Xpert Server is installed. Force10 recommends the Database Server Port be left as the default. If the Server Port value is changed, Oracle recommends that the value be greater than Figure 3-6 TN-Xpert Oracle Database Information Screen Page 4 Force10 Networks Release 5.3.0

41 Step 8 Next, the Run Control Scripts screen displays. Select whether or not to automatically create run control scripts that will launch TN-Xpert when the workstation boots. Select Yes to automatically create the control scripts for startup and shutdown. Click Next to continue. Figure 3-7 TN-Xpert Run Control Scripts Option Screen Step 9 The second Run Control Scripts screen allows users to select the names of the scripts to be created for start up and shut down. Release Force10 Networks Page 5

42 NOTE: The TN-Xpert server is intended to run as a daemon process and automatically start up when the system reboots. This requires appropriate run control scripts be created in the /etc/rc#.d directories (where # is a number from 0 to 9). If the run control scripts are automatically created, script names in the format S[0-9][0-9]TN-Xpert for server startup and K[0-9][0-9]TN-Xpert for server shutdown must be provided. The installer first creates a script file called /etc/init.d/tn-xpert, and then creates links to it in the /etc/rc0.d and /etc/rc3.d directories. The startup script s sequence number must be greater than the Oracle script to ensure Oracle starts before the TN-Xpert server when the system reboots. Similarly, the shutdown script s sequence number must be less than the Oracle script sequence number to ensure the TN-Xpert server shuts down before Oracle. These run control scripts are removed at uninstall time. If the installer does not automatically create these run control scripts, the scripts must be manually created later. Figure 3-8 TN-Xpert Run Control Scripts Entry Screen Step 10 The Install Complete screen displays when the installation is complete. Select Done to exit. The TN-Xpert server can now be launched manually or automatically by rebooting the workstation if the launch scripts were created. Figure 3-9 TN-Xpert Server Installation Complete Screen Page 6 Force10 Networks Release 5.3.0

43 3.2 TN-Xpert Oracle Database Creation WARNING! Creating a database will destroy any previously existing database. If performing a software upgrade, database creation is not needed. Skip this section and perform the server upgrade procedure in Section 3.3 TN-Xpert Server for Solaris Upgrade. The previously installed Oracle database must have the TN-Xpert database added to it. The TN-Xpert database must be configured for specific installation parameters. This section gives step-by-step instructions on how to copy and install the TN-Xpert database files to the proper directory Create Database Directories The directories for the Oracle databases and the Oracle installation must be created prior to creating the TN-Xpert Oracle database. Create Oracle Data Directories The Oracle data directories can optionally be created in partitions created specifically for them. If specific partitions were not created for the Oracle data directories, they can be created anywhere on the disk that has enough space. This procedure assumes the partitions have already been created. Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Step 7 Step 8 Step 9 Log in as root user. Create an Oracle system tablespace file. # cd /u01 (or user specified directory) # mkdir oradata Change the owner of the directory to oracle. # chown oracle:dba oradata Create an Oracle TN-Xpert application data file. # cd /u02 (or user specified directory) # mkdir oradata Change the owner of the directory to oracle. # chown oracle:dba oradata Create an Oracle index/high volume data file. # cd /u03 (or user specified directory) # mkdir oradata Change the owner of the directory to oracle. # chown oracle:dba oradata (Optional) Check each user mounting point for /oradata and oracle.dba are listed. ls -d1 /u0*/oradata Ensure that these directories are owned by the oracle user and dba group. Release Force10 Networks Page 7

44 3.2.2 Create the TN-Xpert Database NOTE: Verify the TN-Xpert server is installed prior to making the following steps. Use the following steps to create the Oracle database. Step 1 Step 2 Log on to the target machine as the oracle user. During the TN-Xpert installation, a file called oracle-install.tar was installed in the TN-Xpert installation directory. Copy the oracle-install.tar from the TN-Xpert server installation base directory to your <HOME> Oracle home directory. NOTE: <HOME> is the Oracle user home directory where you want to extract the oracle-install.tar archive. In the default configuration, <TN-Xpert_Inst_Dir> = /opt/tn-xpert/server. Make sure you are in the Oracle user home directory (enter cd ; first). $ cp <TN-Xpert_Inst_Dir>/oracle-install.tar <HOME> Step 3 Step 4 Step 5 Enter the command below to extract the oracle-install.tar archive. $ tar xvf oracle-install.tar Visually verify that the emsdb directory appears in the home directory by entering the following command: ls -1 emsdb Change permissions for the emsdb directory. chmod -R 755 emsdb Step 6 Change directory to <HOME>/emsdb/admin/create. General example: $ cd <HOME>/emsdb/admin/create Specific example: $ cd /var/home/oracle/emsdb/admin/create Step 7 Run the script with all required parameters as shown (type entire command on one line). General example create_ems_database.sh <ORACLE_HOME> ORACLE_DATA_DIR TN- Xpert_DATA_DIR TN-Xpert_INDEX_DIR Specific example $./create_ems_database.sh /opt/oracle/product/ / u01/oradata /u02/oradata /u03/oradata Step 8 To monitor the progress from another window, enter the following command from <HOME>/emsdb/admin/create: tail -f *.log NOTE: This may take 30 to 45 minutes to complete. Once the creation is complete, log on to sqlplus using the emsuser account to make sure that the emsuser user is successfully created. Step 9 Start the Oracle listener: lsnrctl start Page 8 Force10 Networks Release 5.3.0

45 Step 10 Step 11 Log on to sqlplus as the emsuser user: $ sqlplus emsuser/emsuser@emsdb If the system is connected, the terminal goes to the SQL prompt. The creation is successfully completed. Exit. > exit Configure Oracle Automatic Startup or Shutdown at Boot-time Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Step 7 Step 8 Log in as a root user. Copy the file <HOME>/emsdb/admin/pfile/dbora.init to /etc/init.d/ dbora.init Edit the file /etc/init.d/dbora.init as follows: Change <ORACLE_HOME> to the correct <ORACLE_HOME> in your environment. Save the file. Change the directory to /etc/rc3.d Make a soft link S97dbora under /etc/rc3.d to point to /etc/init.d/dbora.init example: ln -s /etc/init.d/dbora.init S97dbora Change directory to /etc/rc0.d Make a soft link K14dbora under /etc/rc0.d to point to /etc/init.d/dbora.init example: ln -s /etc/init.d/dbora.init K14dbora NOTE: Force10 recommends using the numbers S97 and K14. If either S97 or K14 are already in use by other processes, then use any available number by following this rule: The number used in /etc/rc3.d/s#dbora must smaller than the number assigned to the /etc/rc3.d/ S#tn-xpert, and the number used in /etc/rc0.d/k#dbora must greater than the number assigned to the /etc/rc0.d/k#tn-xpert. Generally, TN-Xpert should start after the database is ready and the TN-Xpert should cleanly shut down before the database goes down. Step 9 If Oracle version is in use in your environment, you must update the dbstart and dbshut scripts to use the correct shell to allow Oracle to start up. The dbstart and dbshut scripts reside under the Oracle home bin directory. $ORACLE_HOME/bin example /opt/oracle/product/10.2.0/bin Add the following line as the first line in each of the files (dbstart and dbshut) to use the correct shell for executing the scripts: #!/bin/ksh Release Force10 Networks Page 9

46 3.3 TN-Xpert Server for Solaris Upgrade Use this procedure only if you are upgrading TN-Xpert from R05.0[0 1 2].0[0 1] to R To upgrade TN-Xpert from a release prior to R , you must first upgrade to R then upgrade to R For more information on upgrading to R , see the TN-Xpert Installation Guide for R Shut Down TN-Xpert Clients and Server Make sure that the previously installed TN-Xpert Client and Server for Solaris are shut down. To shutdown the previously installed Server follow these steps: Step 1 Step 2 Step 3 Log in as emsuser. Be sure to enter the dash. su - emsuser Go to the TN-Xpert server bin directory. cd <TN-Xpert home>/server/bin example: cd /opt/tn-xpert/server/bin Shut down the TN-Xpert server../emsserver stop Install the TN-Xpert Server Follow the steps described in Section 3.1 TN-Xpert Server for Solaris Installation to install the new version of the TN-Xpert server Data Migration Data migration is required to migrate the data from the previous release. To migrate the data from TN- Xpert R05.0[0 1 2].0[0 1] follow the steps mentioned in Section 3.4. To check teh TN-Xpert Server version prior to migration: Step 1 Log in as emsuser. Be sure to enter the dash. su - emsuser Step 2 Step 3 Go to the TN-Xpert server directory. cd <TN-Xpert home>/server/bin example: cd /opt/tn-xpert/server/bin To display the TN-Xpert server version./emsserver -version Page 10 Force10 Networks Release 5.3.0

47 3.4 Data Migration from R05.0[0 1 2].0[0 1] to R NOTE: This procedure is for migration from R05.0[0 1 2].0[0 1] to R only. NOTE: If performing a new software install, perform the steps in Section 3.1 TN-Xpert Server for Solaris Installation and skip this section. If performing an upgrade, this procedure will migrate the data Prerequisite: The TN-Xpert server R is already installed and the Oracle database is operational Create a Database Backup Before migrating the data, back up the database to handle migration failure. Ensure that there is enough disk space for the database backup. Step 1 Step 2 Step 3 Log in as oracle user using the following command (be sure to use the dash): su - oracle Ensure the ORACLE_HOME is set correctly by issuing the following command which indicates what it is set to: echo $ORACLE_HOME If the ORACLE_HOME is not set correctly, use the following command; export ORACLE_HOME=< ORACLE_HOME > example: export ORACLE_HOME=/opt/oracle/product/ Step 4 Ensure the ORACLE_SID is set correctly by issuing the following command which indicates what it is set to: echo $ORACLE_SID Step 5 If the ORACLE_SID is not set correctly, use the following command: export ORACLE_SID=< ORACLE_SID > example: export ORACLE_SID=emsdb NOTE: Ensure that the database is running. If it is not, start the database before continuing. Step 6 Step 7 Step 8 Step 9 Go to the Oracle user s home directory by typing cd with no argument: cd Enter the following command: cd emsdb/bkup/bin Run the database backup script to backup the database:./full_export.sh $ORACLE_SID login/password $ORACLE_HOME example:./full_export.sh emsdb emsuser/emsuser /opt/oracle/ product/ SWhen the backup is complete, copy the backup dump (which is in the same directory) to a secured location. Release Force10 Networks Page 11

48 3.4.2 SQL Data Migration This procedure is for SQL data migration. Step 1 Step 2 Step 3 Step 4 Step 5 Login as oracle user using the following command. Be sure to use the dash: su - oracle Copy the oracle-install.tar from the TN-Xpert R server directory to the current directory. cp <TN-Xpert home>/server/oracle-install.tar. example: cp /opt/tn-xpert/server/oracle-install.tar. Untar the new oracle-install.tar using the following commands: tar xvf oracle-install.tar chmod -R 755 emsdb Go to the migration directory. cd emsdb/migration/r5.0+ Run the migration script../ems_migration.sh $ORACLE_SID $ORACLE_HOME NOTE: ORACLE_SID is the name of the database to be migrated. ORACLE_HOME is where the Oracle software is installed. example: ems_migration.sh emsdb /opt/oracle/product/ Step 6 Step 7 Upon completion of the database migration, review the ems_migration.log to ensure there is no error. After the migration has been completed, the emsserver can be started../emsserver start Migration Fallback Procedure from R to R05.0[0 1 2].0[0 1] This procedure should be used if the data migration from R05.0[0 1 2].0[0 1] to R fails unexpectedly. Step 1 Step 2 Step 3 Login to the standby site as oracle user using the following command. Be sure to use the dash. su - oracle Copy the oracle-install.tar from the TN-Xpert R05.0X.XX server directory to the current directory. cp < TN-Xpert home>/server/oracle-install.tar. example: cp /opt/tn-xpert/server/oracle-install.tar. Untar the oracle-install.tar using the following commands: tar xvf oracle-install.tar chmod -R 755 emsdb Page 12 Force10 Networks Release 5.3.0

49 Step 4 Step 5 Change the directory to the proper directory. cd emsdb/bkup.bin Restore the database using the backup that was created just prior to the data migration. The path to backup files must be specified while running the restoration script. Run the user_import.sh script to import the database for recovery../user_import.sh $ ORACLE_SID $ ORACLE_HOME login/password full_path_of_backup_file FROM_USER TO_USER example: /var/home/oracle/emsdb/bkup/bin/emsdb exp emsuser emsuser NOTE: Fallback to the R05.0[0 1 2].0[0 1] database is complete. Only data pertaining to the emsuser is restored. Step 6 Upon successful completion of the database restoration, login as emsuser and start up the TN-Xpert server. /opt/tn-xpert/server/bin/emsserver start 3.5 Exporting and Importing TN-Xpert Data Exporting TN-Xpert Data from the Oracle Database Step 1 Step 2 Shut down TN-Xpert before exporting data from the Oracle database. Change the directory to the backup bin. Enter the following command: cd <Home>\emsdb\bkup\bin NOTE: <HOME> is the Oracle user home directory. example: cd /var/home/oracle/emsdb/bkup/bin Step 3 Step 4 Run the database backup script to backup the database:./full_export.sh $ORACLE_SID login/password $ORACLE_HOME example:./full_export.sh emsdb emsuser/emsuser /opt/oracle/ product/ Upon completion of the backup, copy the backup dump to a secured location Importing TN-Xpert Data into the Oracle Database Step 1 Step 2 Shut down TN-Xpert before importing data to the Oracle database. Change the directory to the backup bin. Enter the following command: cd <Home>\emsdb\bkup\bin NOTE: <HOME> is the Oracle user home directory. example: cd /var/home/oracle/emsdb/bkup/bin Release Force10 Networks Page 13

50 Step 3 Restore the database using the backup dump previously created. The path to the backup file must be specified while running the restoration script. Run the user_import.sh script to import the database for recovery../user_import.sh $ORACLE_SID $ORACLE_HOME login/password full_path_of_backup_file FROM_USER TO_USER example:./user_import.sh $ORACLE_SID $ORACLE_HOME emsuser/ emsuser /var/home/oracle/emsdb/bkup/bin/emsdb exp emsuser emsuser 3.6 Upgrade Oracle and TN-Xpert NOTE: If you need to upgrade TN-Xpert from a release prior to R , you must first upgrade to R , and then upgrade to R For information on upgrading to R , see the TN- Xpert Installation Guide for R Shut Down TN-Xpert Shut down the TN-Xpert Server and Client Backup the Oracle Database Follow the procedure in Section Exporting TN-Xpert Data from the Oracle Database Uninstall Oracle 9i ( ) Follow the procedure in Chapter 2, Section 2.4 Oracle 9i ( ) Uninstall Install Oracle 10g ( ) Follow the procedure in Chapter 2, Section 2.2 Oracle 10g Installation Install the TN-Xpert Server Follow the steps described in Section 3.1 TN-Xpert Server for Solaris Installation to install the new version of the TN-Xpert server. Page 14 Force10 Networks Release 5.3.0

51 3.6.6 Create the TN-Xpert Oracle Database Follow the steps described in Section 3.2 TN-Xpert Oracle Database Creation to create the TN-Xpert database in Oracle Import the Database Data Use the procedure in Section Importing TN-Xpert Data into the Oracle Database to import the database that was exported in Section Backup the Oracle Database Data Migration Data migration is required to migrate the data from the previous release. To migrate the data from TN-Xpert R05.0[0 1 2].0[0 1], follow the steps mentioned in Section 3.4. To check the TN-Xpert Server version prior to migration: Step 1 Log in as emsuser. Be sure to enter the dash. su - emsuser Step 2 Step 3 Go to the TN-Xpert server bin directory/ cd < TN-Xpert home >/server/bin example: cd /opt/tn-xpert/server/bin To display the TN-Xpert Server version../emsserver -version Release Force10 Networks Page 15

52 Page 16 Force10 Networks Release 5.3.0

53 Chapter 4 Redundant TN-Xpert Systems for Solaris Installation and Configuration Refer to the following sections: 4.1 Overview 4.2 Prerequisites 4.3 Set Up Redundant TN-Xpert Systems 4.4 Redundant Oracle Installation 4.5 Redundant TN-Xpert Server Installation 4.6 Redundant Oracle Database Creation and Configuration Setup Primary and Standby Database 4.7 Redundant TN-Xpert Server Configuration 4.1 Overview Redundant TN-Xpert systems are used for achieving fault tolerance. A standby TN-Xpert System hardware/software platform will be available for continuing operations should the primary fail. The TN-Xpert operations can continue on another piece of hardware with limited interruption in service should the primary fail. All data is kept synchronized between the two units in real-time or near real-time. The switchover between units requires some degree of user intervention. A redundant TN-Xpert system is based on database replication features provided by the Oracle Enterprise version. The replication mechanism guarantees that the standby site has the same data as the production database so, that in the event of disaster at the primary site, operation can continue at the standby site. TN-Xpert continuously monitors the primary and standby site status and generates alarms if problems are detected. NOTE: The Primary/Standby feature is only available with the Oracle Enterprise Edition. 4.2 Prerequisites Prior to installing TN-Xpert, certain minimum requirements must be met. The following table lists the minimum requirements for the Solaris-based server to support a sample system of 100 nodes. Table 4-1 Solaris System Requirements for TN-Xpert Solaris 9 Solaris 10 Operating System Sun Solaris 9 Sun Solaris 10 Oracle Version Server ORACLE 9i ( ) or 10g ( ) Standard or Enterprise Edition Netra 240 Medium Configuration ORACLE 10g ( ) Standard or Enterprise Edition SunFire T1000 Medium Configuration Release Force10 NetworksPage 1

54 Table 4-1 Solaris System Requirements for TN-Xpert Processor UltraSPARC IIIi processor GHz OPTIONAL: Hardware RAID controller Tape backup system UltraSPARC T1 processors 6 core -1.0 GHz Memory 2 GB RAM, 8 MB of cache 4 GB RAM, 8 MB of cache Hard Drives Solaris 9 Solaris GB free SCSI hard drive disk space 73 GB free SCSI hard drive disk space Network 100Base-T Ethernet network card 100Base-T Ethernet network card 4.3 Set Up Redundant TN-Xpert Systems NOTE: Only the basic setup is provided here. For other setups, refer to Chapter 13 of the TN-Xpert Users Guide. The redundant TN-Xpert systems consists of a primary and a standby site. Refer to Figure 4-1 for details. The primary and standby site setups are partly similar. Each site consists of a Solaris machine with the Oracle Enterprise Edition and TN-Xpert server installed. On the primary site, the Oracle database runs in the primary mode and the TN-Xpert server runs in the regular mode. On the standby site, the Oracle database and TN-Xpert server run in standby mode. Client 1 VLXpert Client Client 2 VLXpert Client Primary Site Standby Site VLXpert/Oracle Host 1 VLXpert Server Monitor VLXpert/Oracle Host 2 VLXpert Standby Oracle Primary Replication Oracle Standby Figure 4-1 Setup Redundant TN-Xpert Systems For the above setup, complete Sections 4.4 to 4.7. Page 2 Force10 Networks Release 5.3.0

55 4.4 Redundant Oracle Installation Install Oracle 10g Enterprise Edition on the Primary and Standby servers. 4.5 Redundant TN-Xpert Server Installation Install the TN-Xpert Server on Primary and Standby servers. For more information on creating the database, see Chapter 3 TN-Xpert Server for Solaris Installation, NOTE:.The database creation must be done individually on the primary and standby machines. 4.6 Redundant Oracle Database Creation and Configuration Prerequisite: Databases have been created on primary and standby machines Setup Primary and Standby Database Before the primary and standby databases can be created, both primary and standby sites must be set up to communicate to each other via Oracle Net. The setup configures the Oracle parameters and turn the primary database into an archive log mode -- a mode that continuously produces archive logs -- which is used to recover the standby database. To set up and create the primary and the standby databases, refer to the steps in Table 4-2. Table 4-2 Primary and Standby Database Procedure Steps Steps Command Description Primary Standby 1 Primary site setup configure_ems_primary.sh setup 2 Standby site setup configure_ems_standby.sh setup 3 Primary database is now available for usage 4 Hot backup primary database configure_ems_primary.sh backup 5 FTP hot backup to the standby site configure_ems_primary.sh ftp 6 Create standby database configure_ems_standby.sh create 7 View primary database stat configure_ems_primary.sh transfer_archive 8 View standby database stat configure_ems_standby.sh stat Release Force10 NetworksPage 3

56 Table 4-3 Example Command Outputs for Primary and Standby Database Steps Main Command configure_ems_primary.sh Sub Command and Outputs setup dms2 /u01/oradata /u02/oradata /u03/oradata Directory structure is created Command completed. Connected to an idle instance. ORACLE instance started. Total System Global Area bytes Fixed Size bytes Variable Size bytes Database Buffers bytes Redo Buffers bytes Database mounted. Database altered. Statement processed. Database log mode Archive Mode Automatic archival Enabled Archive destination /var/home/oracle/emsdb/admin/arch Oldest online log sequence 260 Next log sequence to archive 262 Current log sequence 262 Database altered. configure_ems_standby.sh configure_ems_primary.sh configure_ems_primary.sh setup dms3 /u01/oradata /u02/oradata /u03/oradata Directory structure is created Command completed. backup Hot backup started for emsdb on Thu Aug 26 16:12:46 CDT 2004 log mode = ARCH Hot backup completed at /u03/oradata/bkup/hot_bkup/emsdb/ for emsdb on Thu Aug 26 16:18:17 CDT 2004 ftp oracle dms2 /u03/oradata/bkup/hot_bkup/emsdb/ remote user password: Starting ftp... Local directory now /u03/oradata/bkup/hot_bkup/emsdb/ ftp ended. Page 4 Force10 Networks Release 5.3.0

57 Table 4-3 Example Command Outputs for Primary and Standby Database Steps (continued) Main Command configure_ems_standby.sh create Database emsdb is not running. Connected to an idle instance. ORACLE instance started. Sub Command and Outputs Total System Global Area bytes Fixed Size bytes Variable Size bytes Database Buffers bytes Redo Buffers bytes Database altered. Database altered. Command completed. configure_ems_primary.sh configure_ems_primary.sh transfer_archive stat Connected. DATABASE_ROLE OPEN_MODE PRIMARY READ WRITE STATUS TARGET DESTINATION LAG_TIME_MINS ERROR VALID STANDBY standby_emsd 0 b Database log mode Archive Mode Automatic archival Enabled Archive destination /var/home/oracle/emsdb/admin/arch Oldest online log sequence 264 Next log sequence to archive 266 Current log sequence 266 configure_ems_standby.sh stat Connected. DATABASE_ROLE OPEN_MODE SWITCHOVER_STATUS PHYSICAL STANDBY MOUNTED TO PRIMARY Database log mode Archive Mode Automatic archival Enabled Archive destination /var/home/oracle/emsdb/admin/arch Oldest online log sequence 264 Next log sequence to archive 265 Current log sequence 266 Release Force10 NetworksPage 5

58 4.7 Redundant TN-Xpert Server Configuration NOTE: The procedures described below require the configuration of TN-Xpert server properties. For information about using the configuration tool, see Section 13.5 TN-Xpert Post Configuration Setup in the TN-Xpert Users Guide. Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Configure the TN-Xpert Primary Server properties to point to the primary database. Configure the TN-Xpert Primary Server s property Standby Server Host IP as the TN-Xpert Standby Server s IP (TN-Xpert/Oracle Host 2 IP address). Configure the TN-Xpert Standby Server properties to point to the standby database. Configure the TN-Xpert Standby Server property Standby Server Host IP as the TN-Xpert Primary Server s IP (TN-Xpert/Oracle Host 1 IP address). Start the TN-Xpert Standby Server on the standby machine. emsserver standby Start the TN-Xpert Primary Server on the primary machine. emsserver start Page 6 Force10 Networks Release 5.3.0

59 Chapter 5 TN-Xpert Client for Solaris Installation This document assumes that the workstation already has Solaris installed. Please contact your local System Administrator for assistance if Solaris is not installed on the workstation. Once Solaris is installed, a number of custom configuration items must be performed to create users and format partitions. This chapter covers the following topics: 5.1 Prerequisites 5.2 TN-Xpert Client for Solaris Upgrade 5.3 TN-Xpert Client for Solaris Installation 5.4 TN-Xpert Client Uninstall 5.1 Prerequisites Prior to installing TN-Xpert Client for Solaris, certain minimum requirements must be met. The following is a list of minimum requirements for the Sun workstation that will run the TN-Xpert Client for Solaris. Sun Solaris 9 or 10 operating system Sun SPARC station ULTRA MHz processor 512 MB RAM 60 MB free disk space 100Base-T/TX Ethernet network card The TN-Xpert application running on Solaris should have the recommended patches applied to run properly. Go to for more information. 5.2 TN-Xpert Client for Solaris Upgrade If this TN-Xpert Client for Solaris installation is upgrading a previous installation of TN-Xpert Client for Solaris, the user should follow these additional steps: Step 1 Make sure the previously installed TN-Xpert Client and Server for Solaris are not running. If they are, close both the client and server applications. Step 2 Proceed with the TN-Xpert Client for Solaris installation described in Section 5.3. Be aware that the software will prompt the user to uninstall the existing client software in Section Installation. To manually initiate a software version removal, go to Section 5.4 TN-Xpert Client Uninstall. 5.3 TN-Xpert Client for Solaris Installation This section describes the installation process for TN-Xpert Client for Solaris. The Java Runtime environment is bundled with the installers, so no Java virtual machine is required from the target system to run the installer. NOTE: Before performing a software upgrade on an NE, users must first upgrade the TN-Xpert software to avoid a loss of connectivity. Release Force10 Networks Page 1

60 5.3.1 Launching Installer The following instructions are for installing the TN-Xpert Client for Solaris. Step 1 Step 1 Step 2 Download the TN-Xpert Client build from the Force10 Infocenter or website ( to a location on a server that can be easily accessed by users. From a terminal window, log in as the root user. Run the TN-Xpert Client for Solaris installation using the following commands: # cd cdrom/ems/tn-xpert/solaris # ls Installation #./client.bin The installer will show windows in the following order. Step 1 This screen appears for a few seconds as the software starts to load. Figure 5-1 TN-Xpert Client Splash Screen Page 2 Force10 Networks Release 5.3.0

61 Step 2 The Introduction dialog box defines the release of TN-Xpert that will be installed. Select Next to continue with the installation. Figure 5-2 TN-Xpert Client Installation Introduction Dialog Box Step 3 The License Agreement contains the TN-Xpert License agreement statement. After reading the License Agreement, select I accept the terms of the License Agreement and Next to continue. Figure 5-3 TN-Xpert Client License Agreement Dialog Box NOTE: If performing a software upgrade, proceed to Step 5. Step 4 The Choose Install Folder dialog box defaults to the /opt/tn-xpert/client directory. An alternate directory can be selected by either typing in a valid path, or selecting Choose to browse the existing file structure. Click Restore Default Folder to reset the selection to the /opt/tn-xpert/client directory. Select Next to proceed with the installation in the selected folder. Release Force10 Networks Page 3

62 Figure 5-4 TN-Xpert Client Install Folder Selection Screen Step 5 The Choose Link Location dialog box displays with options allowing you to select where to create the links. NOTE: This steps creates an easy launch option for the TN-Xpert client. A tn-xpertclient link is created in the /user/local/bin directory, allowing the TN-Xpert client to be launched from any directory. If the link does not exist, the TN-Xpert client must be launched by invoking the emsclient program. Figure 5-5 Choose Link Location Step 6 Step 7 Select Install to proceed with the installation. The Status dialog box shows the status of the installation. The installation can be aborted by selecting Cancel. Page 4 Force10 Networks Release 5.3.0

63 Figure 5-6 TN-Xpert Client Installation Status Dialog Box Step 8 The Client Properties dialog box allows the user to select the IP address and port for communicating with the TN-Xpert server. Select Next to proceed with the installation in the selected directory. If the TN-Xpert server resides on another workstation, use the IP address of that workstation. This should take 1 to 2 minutes to install. Figure 5-7 TN-Xpert Client Properties Dialog Box Step 9 The Install Complete dialog box displays to indicate that the installation is complete and successful. Select Done to quit the installer. The TN-Xpert Client can now be launched. Release Force10 Networks Page 5

64 5.4 TN-Xpert Client Uninstall Use the following procedure to manually initiate the uninstaller for total removal of the TN-Xpert Client software. Step 1 Step 2 Step 3 Log in as a root user. From a terminal window, launch the uninstaller script by entering the following command at the root prompt: # /opt/tn-xpert/client/uninstallerdata/uninstall_tn- Xpert_client The Uninstall TN-Xpert Client screen displays. Click Uninstall to begin the removing the TN-Xpert Client software. Figure 5-8 Uninstall TN-Xpert Client Screen Page 6 Force10 Networks Release 5.3.0

65 Step 4 When the software is removed, the Uninstall Complete screen displays. Click Done to exit. Figure 5-9 Uninstall Complete Screen Release Force10 Networks Page 7

66 Page 8 Force10 Networks Release 5.3.0

67 Chapter 6 Installing TN-Xpert Client for Windows This document assumes the PC already has Windows XP or Windows 2000 installed. Please contact the local System Administrator for assistance if Windows is not installed on the PC. Once Windows is installed, a number of custom configuration items must be performed to create users and format partitions. 6.1 Prerequisites Prior to installing TN-Xpert Client for Windows, certain minimum requirements must be met. The following is a list of minimum requirements for the PC to run the TN-Xpert Client for Windows. Windows based Client Windows XP or Windows 2000 SP2 Pentium III MHz processor 512 MB RAM 630 MB free disk space 100Base-T/TX Ethernet network card 6.2 TN-Xpert Client for Windows Upgrade If this TN-Xpert Client for Windows installation is upgrading a previous installation of TN-Xpert Client for Windows, the user should follow these additional steps: Step 1 Step 2 Make sure the previously installed TN-Xpert Client for Windows is not running. If it is, close the client application. Proceed with the TN-Xpert Client for Windows installation. 6.3 TN-Xpert Client for Windows Installation/Upgrade This section describes the installation process for TN-Xpert Client for Windows. The Java Runtime environment is bundled with the installers, so no Java virtual machine is required from the target system to run the installer. NOTE: Before performing a software upgrade on an NE, users should first upgrade the TN-Xpert software to avoid a loss of connectivity on TN-Xpert Launching the Installer The following instructions are for installing the TN-Xpert Client for Windows. Step 1 Step 2 Download the TransNav Xpert Management System (Windows) software from the Force10 Networks Infocenter or website ( The software build should be downloaded to a directory on a server that is easily accessible by users. Select the TN-Xpert directory. Release Force10 NetworksPage 1

68 Step 3 Select the Windows directory and double click the client.exe icon to initiate the installer Installation Upon initiation of the install.exe file, the InstallAnywhere window appears to initialize the TN-Xpert Client installation. The following screens appear. Step 1 The Introduction screen defines the release of TN-Xpert being installed. Select Next to continue the installation. Figure 6-1 TN-Xpert Client Installation Introduction Screen Step 2 The License Agreement contains the TN-Xpert License agreement statement. After reading the License Agreement, select I accept the terms of the License Agreement and Next to continue. Figure 6-2 TN-Xpert License Agreement NOTE: If performing a software upgrade, proceed to Step 4. Page 2 Force10 Networks Release 5.3.0

69 Step 3 The Choose Install Folder screen defaults to the C:\Program Files\TN-Xpert\client folder. An alternate folder can be selected by either typing in a valid path, or selecting Choose to browse the existing file structure. Click Restore Default Folder to reset the selection to the default (C:\Program Files\TN-Xpert\client) folder. Select Next to proceed with the installation in the selected directory. Figure 6-3 TN-Xpert Client Install Folder Selection Screen (new install only) Step 4 The Choose Shortcut Folder screen displays with options to install a shortcut to the TN-Xpert Client. The installation options are: In a new Program Group (default) In an existing Program Group In the Start Menu On the Desktop In the Quick Launch Bar Other Don t create icons Create Icons for all Users Release Force10 NetworksPage 3

70 . TransNav Xpert Installation Guide Select the option where you want to install the shortcut and click Install to continue. See Figure 6-4. Figure 6-4 TN-Xpert Client Shortcut Folder Selection Screen Step 5 The Status screen shows the status of the installation. To abort the installation, select Cancel. Figure 6-5 TN-Xpert Client Installation Status Screen Page 4 Force10 Networks Release 5.3.0

71 Step 6 The Client Properties screen allows the user to select the IP address and port for communicating with the TN-Xpert Server and its backup (stand-by) server. Enter the IP address of that workstation. Figure 6-6 TN-Xpert Client Properties Screen NOTE: If the IP address changes after installation, the installer must manually change the IP address. Step 7 The Install Complete screen displays when the installation is successfully completed. Select Done to quit the installer. Figure 6-7 TN-Xpert Client Installation Complete Screen Release Force10 NetworksPage 5

72 Page 6 Force10 Networks Release 5.3.0

73 Chapter 7 TN-Xpert PC for Windows This chapter describes the installation of TN-Xpert PC for Windows, the installation and initial configuration of the Oracle database, and creation of the TN-Xpert PC databases, including these topics. 7.1 Prerequisites 7.2 Overview 7.3 Oracle Installation and Uninstallation 7.4 TN-Xpert PC Installation or Upgrade 7.5 TN-Xpert Database Creation 7.6 TN-Xpert PC Upgrade 7.7 TN-Xpert PC Database Migration from R05.0[0 1 2].0[0 1] to R Exporting and Importing TN-Xpert Data 7.9 Launching and Shutting Down TN-Xpert 7.1 Prerequisites Prior to installing TN-Xpert PC for Windows, certain minimum requirements must be met. The following is a list of minimum component requirements for the PC that will run the TN-Xpert PC for Windows TN-Xpert PC requirements Windows 2000 SP2 or Windows XP Pentium III - 1 GHz processor or better Oracle 9i ( ) or Oracle 10g ( ) Personal Edition 1GB RAM 2GB Available Disk Space 100Base-T/TX Ethernet network card Minimum Disk Space Requirements The PC for TN-Xpert must have the minimum disk space required for each component. PM Data Storage Requirements The required disk space relies heavily on the number of nodes being managed as well as the amount of PM data being collected/stored. The minimum requirement is 15 Gigabytes which assumes managing 32 nodes, three TN-Xpert database backups and a scheduled PM cleanup every 30 days. Release Force10 Networks Page 1

74 7.2 Overview The TN-Xpert PC program is a standalone product. When media sense is enabled and the ethernet cable on the PC is removed, TN-Xpert may shut down. A message displays indicating connectivity was lost to the server. Use one of the following options There are to resolve this issue: Place a hub between the PC and the NE Disable the media sense on the PC using the instructions on the following website: NOTE: There are some side effects of disabling the Media Sensing feature. For example, if you have a machine with two network adapters and you have the Media Sensing feature enabled, if one network adapter does not work, it is unbound and associated routes are removed so all traffic goes through the other network adapter (assuming a default gateway is there). Also, if you are a roaming (portable) user, the Media Sensing feature is what provides the ability to connect to any network and have everything work without restarting, release and renewing. After disabling Media Sense and restarting, Windows still shows the Network Disconnected icon on the Task Bar and the ipconfig command still shows a Media State...: Cable Disconnected message when the cable is disconnected. However, the Network Interface is bound to TCP/IP. You can verify this by looking at the route table using the route print command and viewing the interface IP address. You can able ping the IP address assigned to the NIC. 7.3 Oracle Installation and Uninstallation NOTE: If Oracle software is already installed, skip this section and go to Section 7.4 TN-Xpert PC Installation or Upgrade Oracle 9i Installation Step 1 After the Oracle CD is inserted, the program will auto launch. The following window appears. Click Install/Deinstall Products. Page 2 Force10 Networks Release 5.3.0

75 Figure 7-1 Oracle9i Main Window Step 2 The Welcome screen appears. Click Next to continue. Figure 7-2 Oracle Welcome Screen Step 3 The File Location screen appears. Use the defaults (Path = Oracle Home) or change if desired. Release Force10 Networks Page 3

76 Figure 7-3 File Location Screen Step 4 The Available Products screen appears. Use the defaults and select Next to continue. Figure 7-4 Available Products Screen Page 4 Force10 Networks Release 5.3.0

77 Step 5 The Installation Types screen appears. Select Personal Edition and click Next to continue. Figure 7-5 Installation Types Screen Step 6 The Database Configuration screen appears. Select Software Only and click Next to continue. Figure 7-6 Database Configuration Screen Release Force10 Networks Page 5

78 Step 7 A Summary screen appears. The Summary indicates all of the user selections to this point. Click Install to start the installation download. This process takes approximately 30 minutes for the first disc. Figure 7-7 Summary Screen Step 8 A dialog box displays to prompt when to insert the next disc. Insert the second disc when prompted, then insert the third installation disc when prompted. Figure 7-8 Disc Request Screen Page 6 Force10 Networks Release 5.3.0

79 Step 9 When the End of Installation screen appears, select Exit. Figure 7-9 End of Installation Screen Step 10 Remove the last disc from the CD drive and return it to its proper storage container. Repeat this procedure for each PC being utilized Oracle 9i Uninstall Step 1 Step 2 Step 3 Launch a DOS window and go to the following directory: cd [TN-Xpert home]\emsdb\admin\create example: cd c:\program files\tn-xpert\standalone\emsdb\admin\create To remove the database, enter the following string:..\..\bin.win\sh remove_ems_database.sh %ORACLE_SID% %ORACLE_HOME% example:..\..\bin.win\sh remove_ems_database.sh emsdb C:\oracle\ora90 Before uninstalling Oracle, stop all Oracle services. To see what Oracle services exist, from the Start menu, select Control Panel, Administrative Tools, and then Services. NOTE: Verify all Oracle services have been stopped. Release Force10 Networks Page 7

80 . TransNav Xpert Installation Guide Figure 7-10 Oracle Services List Page 8 Force10 Networks Release 5.3.0

81 Step 4 From the Start menu, select All Programs, Oracle Installation Products, and then Universal Installer. Uninstall all of the products within the Oracle suite. The file Oracle Installation Products cannot be uninstalled. Figure 7-11 Oracle Installer Programs Figure 7-12 Oracle Product Inventory Release Force10 Networks Page 9

82 Figure 7-13 Oracle UnInstaller Welcome Screen Step 5 From the Start menu, select Run. In the Run dialog box, enter regedit. Select and delete the HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE entry. Figure 7-14 Start > Run Menu Selections Page 10 Force10 Networks Release 5.3.0

83 Step 6 Select HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services. Delete all of the entries about Oracle. Figure 7-15 Select Oracle Entries to Delete Step 7 Select HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ Eventlog\Application. Delete all of the entries about Oracle. Figure 7-16 Delete Oracle Entries Release Force10 Networks Page 11

84 Step 8 Open a Windows Explorer window. Right click My Computer and select Properties, Select the Advanced tab, then click Environment Variables. Figure 7-17 Select Environment Variables Step 9 Delete the Oracle related system variables: ORACLE_HOME and ORACLE_SID. Figure 7-18 Environment Variables Page 12 Force10 Networks Release 5.3.0

85 Step 10 Step 11 Step 12 Step 13 Step 14 Delete all of the files in the \Program Files\Oracle folder. Reboot the PC. Delete all of the Oracle files. (For example, if C:\oracle, delete the whole folder) Delete all of the Oracle-related files in the Windows directory such as ORACLE.ini, oradimxx.ini, oraodbc.ini, etc. These files will be modified when you reinstall Oracle. Delete all of the Oracle-related configurations in the win.ini file Install Oracle 10g Step 1 Launch the Oracle 10g installer. The selection screen appears. Select Advanced Installation and the click Next to continue. Figure 7-19 Select Installation Method Screen Release Force10 Networks Page 13

86 Step 2 The Select Installation Type window appears. Select the Personal Edition and click Next to continue. Figure 7-20 Select Installation Type Screen Step 3 The Specify Home Details screen appears. Use the Path shown or change if desired. Select Next to continue. Figure 7-21 Specify Home Details Screen Page 14 Force10 Networks Release 5.3.0

87 Step 4 The Product-Specific Prerequisite Checks screen appears. The installer will auto check for prerequisite, Click Next to continue. If DHCP is enabled, a Warning message displays. Click Yes to acknowledge the warning, then click Next to continue. Figure 7-22 Product-Specific Prerequisite Checks Screen Step 5 The Select Configuration Option screen displays. Select Install database Software only and click Next to continue. Figure 7-23 Select Configuration Option Screen Release Force10 Networks Page 15

88 Step 6 A Summary screen appears. The Summary indicates all of the user selections to this point. Click Install to start the installation download. This will take while to complete. Figure 7-24 Oracle Installer Summary Screen Step 7 An Install screen indicating the progress of the Oracle database installation. This will take while to complete. Page 16 Force10 Networks Release 5.3.0

89 Figure 7-25 Oracle Installation Indicator Screen Step 8 When the installation is complete, an End of Installation screen displays. Click Exit to exit the installer program Oracle 10g Uninstall Step 1 Step 2 Step 3 Launch a DOS window and go to the following directory: cd [TN-Xpert home]\emsdb\admin\create example cd c:\program files\tn-xpert\standalone\emsdb\admin\create To remove the database enter the following string:..\..\bin.win\sh remove_ems_database.sh %ORACLE_SID% %ORACLE_HOME% example..\..\bin.win\sh remove_ems_database.sh emsdb C:\oracle\product\10.2.0\db_1 Go to Start -> Control Panel -> Administrative Tools -> Services and stop all of the Oracle services. Release Force10 Networks Page 17

90 Figure 7-26 Oracle Services List NOTE: Make sure all of the Oracle services have been stopped. Step 4 Select Start, then select All Programs, Oracle Installation Products, Universal Installer. Uninstall all of the Oracle suite products except Oracle Installation Products that cannot be uninstalled. Figure 7-27 Oracle Installer Programs Page 18 Force10 Networks Release 5.3.0

91 Figure 7-28 Oracle Uninstaller Welcome Screen Step 5 Step 6 From the Uninstaller Welcome screen, click Deinstall Products. The Inventory dialog box displays. Click Remove to uninstall the Oracle products listed on the Inventory dialog box. After the uninstall is complete, click Close to exit. Figure 7-29 Oracle Products Inventory Screen Release Force10 Networks Page 19

92 Step 7 Step 8 Step 9 From the Start menu, select Run. Enter Regedit and click OK. The Registry Editor screen displays. Select and delete the HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE entry. Select the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services entry. Delete all of the Oracle entries. Figure 7-30 Delete Oracle System Service Entries Step 10 Select the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ Eventlog\Application entry. Delete all of the Oracle entries. Figure 7-31 Delete Oracle Eventlog Entries Page 20 Force10 Networks Release 5.3.0

93 Step 11 Step 12 Close the Registry Editor. Open a Windows Explorer window and right click My Computer. Select Properties. The System Properties screen displays. Select the Advanced tab and click Environment Variables at the bottom of the screen. Figure 7-32 Select Environment Variables Step 13 Step 14 Step 15 Step 16 Step 17 Step 18 Step 19 Step 20 Step 21 Delete the Oracle-related system variables: ORACLE_HOME and ORACLE_SID. Delete all of the Oracle-related path variables. Click OK to exit the Environment Variables dialog box. Click OK to exit the System Properties dialog box. From Windows Explorer, open the C:\\Program Files\Oracle directory. Delete all of the files in that directory. Close Windows Explorer. Reboot the PC. Delete all of the Oracle files. (we assume C:\oracle here, delete the whole folder.) Delete all of the Oracle-related files in the Windows directory, here C:\Windows we assume, ORACLE.ini, oradimxx.ini, oraodbc.ini etc. However, they will be modified when you reinstall Oracle later. Delete all of the Oracle-related configurations within the win.ini file. Release Force10 Networks Page 21

94 7.4 TN-Xpert PC Installation or Upgrade For new TN-Xpert PC installations, refer to Sections TN-Xpert PC Installation and 7.5 TN-Xpert Database Creation. For upgrading from a previous TN-Xpert PC release, refer to Section 7.6 TN-Xpert PC Upgrade. This section describes the process for installing TN-Xpert Server TN-Xpert PC Installation This section describes the process for installing TN-Xpert PC. Java Runtime environment is bundled with the installers. No Java virtual machine is required from the target system to run the installer. Step 1 Download the TN-Xpert PC build from the Force10 Infocenter or website to a file on a local server that is easily accessible for users. Step 2 Open the root directory and select the TN-Xpert PC file. Step 3 For a new installation, click the install.exe file. For an upgrade from a previous release, click on the update.exe file. The following window appears briefly as the InstallAnywhere software loads the files. NOTE: Run the update.exe file only if a previous version of the TN-Xpert exists. Figure 7-33 Install Anywhere Window Page 22 Force10 Networks Release 5.3.0

95 Step 4 An Introduction screen appears. Click Next to continue. Figure 7-34 Introduction Screen Step 5 A License Agreement screen appears. Read the agreement carefully and click to accept the terms. Click Next to continue. Figure 7-35 License Agreement Screen Release Force10 Networks Page 23

96 Step 6 The Choose Install Folder screen appears and defaults to the location where the TN-Xpert directory will be installed. The default is the C:\Program Files\TN- Xpert\standalone directory. Select an alternate directory by typing in a valid path or selecting Choose to browse the existing file structure. Select Restore Default Folder to reset the selection to the default value. Click Next to continue. Figure 7-36 Choose Install Folder Screen (New Install Only) Page 24 Force10 Networks Release 5.3.0

97 Step 7 The Choose Shortcut Folder screen appears requesting a storage location for the TN-Xpert product icons. Select an option and click Install to continue. Figure 7-37 Choose Shortcut Folder Screen Step 8 An installation progress screen appears to show the progress of the software installation. When the installation successfully completes, an Install Complete screen appears. Click Done to exit. 7.5 TN-Xpert Database Creation Warning! Creating a database will destroy any previously existing database. If performing a TN-Xpert software upgrade, database creation is not needed. Skip Section 7.5 TN- Xpert Database Creation and perform the upgrade procedure in Section 7.6 TN- Xpert PC Upgrade. Step 1 Step 2 Launch a DOS window and go to the following directory: cd [TN-Xpert home]\emsdb\admin\create example: cd c:\program files\tn-xpert\standalone\emsdb\admin\create Enter the following string:..\..\bin.win\sh create_ems_database.sh [oracle home] [user defined data directory] example for Oracle 9i:..\..\bin.win\sh create_ems_database.sh C:\oracle\ora90 C:\oracle example for Oracle 10g:..\..\bin.win\sh create_ems_database.sh C:\oracle\product\10.2.0\db_1 C:\oracle\product\ This process takes approximately 30 to 45 minutes to complete. Release Force10 Networks Page 25

98 7.5.1 Configure Service for Oracle 9i Step 3 Go to the system Control Panel, then select System. The System Properties dialog box displays. Click the Advanced tab and select Environmental Variables. Figure 7-38 System Properties Screen Page 26 Force10 Networks Release 5.3.0

99 . TransNav Xpert Installation Guide Step 4 From the Environmental Variables screen, in the System Variables pane, select New. Figure 7-39 Environmental Variables Screen Step 5 When the New System Variable dialog box appears, enter ORACLE_HOME as the Variable name and C:\oracle\ora(release number) as the Variable value where (release number) is the Oracle release number. Click OK to continue. Repeat this step if necessary for the ORACLE_SID system variable. Enter ORACLE_SID as the Variable name and emsdb as the Variable value. Figure 7-40 New System Variable Screen Release Force10 Networks Page 27

100 Step 6 From the Control Panel, select Administrative Tools, then Services, and then the Oracle listener (in this example, OracleOra90TNSListener). Figure 7-41 TNS Listener Properties Screen Step 7 Step 8 Step 9 In the Startup Type parameter, change the value from Manual to Automatic. Click OK. Reboot the computer to activate the new settings. Page 28 Force10 Networks Release 5.3.0

101 7.5.2 Configure Service for Oracle 10g Step 3 Go to the system Control Panel, then select System. The System Properties dialog box displays. Click the Advanced tab and select Environmental Variables. Figure 7-42 System Properties Screen Release Force10 Networks Page 29

102 . TransNav Xpert Installation Guide Step 4 From the Environmental Variables screen, in the System Variables pane, select New. Figure 7-43 Environmental Variables Screen Step 5 When the New System Variable dialog box appears, enter ORACLE_HOME as the Variable name and C:\oracle\product\(release number)\db_1 as the Variable value where (release number) is the Oracle release number. Click OK to continue. Figure 7-44 New System Variable Screen Repeat this step if necessary for the ORACLE_SID system variable. Enter ORACLE_SID as the Variable name and emsdb as the Variable value. Page 30 Force10 Networks Release 5.3.0

103 . TransNav Xpert Installation Guide Figure 7-45 New System Variable Screen Step 6 From the Control Panel, select Administrative Tools, then Services, and then the Oracle listener (in this example, OracleOraDb10g_home1TNSListener). Figure 7-46 TNS Listener Properties Screen Step 7 Step 8 Step 9 In the Startup Type parameter, change the value from Manual to Automatic. Click OK. Reboot the computer to activate the new settings. Release Force10 Networks Page 31

104 7.6 TN-Xpert PC Upgrade Use this procedure only if you are upgrading TN-Xpert from R05.0[0 1 2].0[0 1] to R To upgrade TN-Xpert from a release prior to R , you must first upgrade to R and then upgrade to R For more information upgrading to R , see the TN-Xpert Installation Guide for R Shutdown TN-Xpert PC Make sure that the previously installed TN-Xpert PC is shut down. To shutdown TN-Xpert PC: Step 1 From the system tray, verify if TN-Xpert PC is running. This is indicated by an icon similar to the one shown below. Right click the icon and select shutdown. Figure 7-47 TN-Xpert PC Icon TN-Xpert PC Installation Install the new version of TN-Xpert PC. For more information, see Section TN-Xpert PC Installation Data Migration Data migration is required to migrate the data from the previous release. To migrate the data from TN- Xpert R05.0[0 1 2].0[0 1], follow the steps mentioned in Section 7.7 TN-Xpert PC Database Migration from R05.0[0 1 2].0[0 1] to R TN-Xpert PC Database Migration from R05.0[0 1 2].0[0 1] to R NOTE: This procedure is for migration from R05.0[0 1 2].0[0 1] to R only. NOTE: If performing a new software install, user should perform Section 7.4 TN-Xpert PC Installation or Upgrade and skip this section. If performing an upgrade, this procedure will migrate the data from the old version into the new load. Prerequisite: The TN-Xpert release R is already installed and the Oracle database is operational. Page 32 Force10 Networks Release 5.3.0

105 7.7.1 Create Database Backup Before upgrading the TN-Xpert software and migrating the data, backup the database. Ensure there is enough disk space for the database backup. Step 1 Step 2 Ensure the database is running. Ensure the ORACLE_HOME and ORACLE_SID are set correctly by going to the Control Panel of the PC and selecting System. The System Properties screen displays. Click the Advanced tab and select Environmental Variables. For information on configuring the Oracle values, see Section Configure Service for Oracle 10g. Figure 7-48 System Variable Window Step 3 Step 4 Step 5 Change the directory to the TN-Xpert backup bin by typing the following command: cd <TN-Xpert Home>\emsdb\bkup\bin example: cd C:\Program Files\TN-Xpert\standalone\emsdb\bkup\bin Run the database backup script to backup the database:..\..\bin.win\sh full_export.sh %ORACLE_SID% login/passwd example:..\..\bin.win\sh full_export.sh emsdb emsuser/ emsuser c:\oracle\ora90 Upon completion of the backup, copy the backup dump to a secured location SQL Data Migration Procedure Step 1 Step 2 Go to the migration directory of the newly installed TN-Xpert software using the following command: cd <TN-Xpert Home>\standalone\emsdb\migration\R5.0+ example: cd C:\Program Files\tn-xpert\standalone \emsdb\migration\r5.0+ Run the migration script:..\..\bin.win\sh ems_migration.sh %ORACLE_SID% %ORACLE_HOME% example:..\..\bin.win\sh ems_migration.sh emsdb c:\ ora- cle\ora90 Release Force10 Networks Page 33

106 Step 3 Step 4 Upon completion, review the ems_migration.log to ensure there are no errors. After successful completion, start teh TN-Xpert PC from the menu Migration Fallback Procedure R to R05.0[ ].0[0 1] Step 1 Step 2 Go to the TN-Xpert database backup bin directory: cd <TN-Xpert Home>\emsdb\bkup\bin example: cd C:\Program Files\TN-Xpert\standalone\emsdb\bkup\bin Restore the database using the backup dump created just before the data migration. The path to backup file must be specified to run the restoration script...\..\bin.win\sh user_import.sh %ORACLE_SID% %ORACLE_HOME% login/passwd full_path_of_dump_file <FROM_USER> <TO_USER> example:..\..\bin.win\sh user_import.sh emsdb c:\oracle\ora90 emsuser/emsuser full_path_of_dump_file emsuser emsuser NOTE: The Fallback to R05.0[ ]. 0[0 1] database procedure is complete. Only data pertaining to the ems database user is restored. 7.8 Exporting and Importing TN-Xpert Data Exporting TN-Xpert Data from Oracle Database Step 1 Step 2 Step 3 Step 4 Shut down TN-Xpert prior to exporting data from the Oracle database. For more information, see Section Shutting Down TN-Xpert. Change to the TN-Xpert backup bin directory by typing the following command: cd <TN-Xpert Home>\emsdb\bkup\bin example: cd C:\Program Files\tn-xpert\standalone\emsdb\ bkup\bin Run the database backup script to backup the database:..\..\bin.win\sh full_export.sh %ORACLE_SID% login/passwd %ORACLE_HOME% example for Oracle 10g:..\..\bin.win\sh full_export.sh emsdb emsuser/emsuser c:\oracle\product\10.2.0\db_1 Upon completion of the backup, copy the backup dump to a secured location. Page 34 Force10 Networks Release 5.3.0

107 7.8.2 Importing TN-Xpert Data into Oracle Database Step 1 Step 2 Step 3 Shut down TN-Xpert prior to importing data from the Oracle database. For more information, see Section Shutting Down TN-Xpert. Change to the TN-Xpert backup bin directory by typing the following command: cd <TN-Xpert Home>\emsdb\bkup\bin example: cd C:\Program Files\tn-xpert\standalone\emsdb\bkup \bin Restore the database using the backup dump that was created just before data migration. The path to backup file needs to be specified while running the restoration script...\..\bin.win\sh user_import.sh %ORACLE_SID% %ORACLE_HOME% login/passwd full_path_of_dump_file <FROM_USER> <TO_USER> example:..\..\bin.win\sh user_import.sh %ORACLE_SID% %ORACLE_HOME% emsuser/emsuser <_PATH_>\emsdb exp emsuser emsuser Upgrade Oracle from 9i to 10g andd TN-Xpert R05.0[ ].0[0 1] NOTE: Use the steps in this procedure only if you are upgrading from Oracle 9i to 10g and from TN-Xpert R05.0[ ].0[0 1] to TN-Xpert R To upgrade TN-Xpert from a release prior to R , you must first upgrade to R and then upgrade to R For more information upgrading to R , see the TN-Xpert Installation Guide for R Shut down TN-Xpert PC For more information, see Section Shutting Down TN-Xpert Backup the Oracle Database For more information, see Section Backup the Oracle Database Uninstall Oracle 9i ( ) For more information, see Section Oracle 9i Uninstall. Release Force10 Networks Page 35

108 7.8.7 Install Oracle 10g ( ) For more information, see Section Install Oracle 10g Install the New Version of TN-Xpert PC For more information, see Section TN-Xpert PC Installation Create the TN-Xpert Database For more information, see Section Configure Service for Oracle 10g Import the Data from the Database Backup For more information, see Section Importing TN-Xpert Data into Oracle Database. Import the database exported in Section Backup the Oracle Database. 7.9 Launching and Shutting Down TN-Xpert Launching TN-Xpert Use the following procedure to launch TN-Xpert on a local computer. Step 1 Step 2 From the Start menu, select Programs. Search for TN-Xpert Group. Click it to launch TN-Xpert. A new icon appears in the system tray on the lower right side of the computer screen that represents TN-Xpert PC. Double-click the icon to launch the TN-Xpert PC GUI. Figure 7-49 TN-Xpert PC Icon Page 36 Force10 Networks Release 5.3.0

109 7.9.2 Shutting Down TN-Xpert Use the following procedure to shut down TN-Xpert. Step 1 If TN-Xpert is running, right-click the icon in the system tray and select shutdown to shutdown the TN-Xpert PC. Figure 7-50 TN-Xpert PC Icon Step 2 The TN-Xpert PC icon is automatically removed from the system tray when TN-Xpert PC is shut down. Release Force10 Networks Page 37