Cisco Active Network Abstraction Administrator Guide 3.6 Service Pack 4 - Utility Scripts [Cisco Active Network Abstraction]

Table Of Contents

Utility Scripts

Restarting Cisco ANA Gateway

Restarting a Cisco ANA Unit

Changing Passwords for Cisco ANA Database and Workflow Scheme

Running a Command On All Cisco ANA Units

Utility Scripts

This appendix describes the Cisco ANA utility scripts.

•Restarting Cisco ANA Gateway—Describes how to restart the gateway from the UNIX command line.

•Restarting a Cisco ANA Unit—Describes how to restart a unit from the UNIX command line.

•Changing Passwords for Cisco ANA Database and Workflow Scheme—Describes how to change the password for the Cisco ANA database and the workflow scheme sheer.

•Running a Command On All Cisco ANA Units—Describes the script used to execute a given command on all units.

Restarting Cisco ANA Gateway

The user can restart the gateway from the UNIX command line.

To restart the gateway:

Step 1 Open a Telnet session to the Cisco ANA gateway, and log into the machine.

Step 2 Run the script:
~sheer/Main/mvm.csh
Note When the gateway is restarted, all clients are reconnected.

Note The server status can be verified using Cisco ANA Manage.

Restarting a Cisco ANA Unit

Restarting a unit stops all AVM processes on that unit and restarts them.

Given that the system saves part of its information within the process memory, restarting a unit causes some of the information to disappear. Therefore, it takes as long as the longest full polling cycle for the system to recover all information that was stored in the process memory prior to the restart. Data that was saved in persistent storage before restarting is available immediately.

Restarting a machine can cause some of the VNEs running on the machine to be reported as unreachable. This is due to handshake protocols with the unit that fail due to the unavailability of the VNEs.

Restarting a machine stops all active queries, flows, and transactions that are currently being run within the VNEs that run on the restarted Cisco ANA unit.

To restart a unit:

Step 1 Open a Telnet session to the Cisco ANA unit and log into the machine.

Step 2 Run the script:
~sheer/Main/mvm.csh
Changing Passwords for Cisco ANA Database and Workflow Scheme

The passwords for user sheer and the workflow scheme sheer are established during Cisco ANA installation. In releases prior to Cisco ANA 3.6 Service Pack 4, these passwords cannot be modified by editing their associated files because the passwords are encrypted.

Beginning with Cisco ANA 3.6 Service Pack 4, a script is included that allows you to change the passwords for the Cisco ANA database and the workflow scheme.

Note This script changes only the password that Cisco ANA uses to connect to the database; it does not change the Oracle password for the user sheer.

Before You Begin

•Change the Oracle password of the user sheer before changing the Cisco ANA database password as described in this procedure.

•Shut down Cisco ANA on the gateway. If you do not, Cisco ANA will be shut down by the procedure.

To change the user sheer password for the Cisco ANA database or for the workflow scheme sheer:

Step 1 Open a Telnet session to the Cisco ANA gateway and log in as user sheer.

Step 2 At the prompt, enter the command:
sheer@server12 [~]%DatabasePasswordChange.pl 
+ This application changes the database references in ANA.
+ IF YOU DECIDE TO CONTINUE, ANA WILL BE SHUT DOWN.
Step 3 When prompted, enter Y to continue or N to exit the procedure:
Are you sure you want to continue? (Y,N) [default N] Y 
Step 4 As the script proceeds, enter the required information:

•Oracle IP address

•Oracle SID

•New password for the Cisco ANA database

•Oracle listener port number

For example:
Please provide the following database parameters:
  - Would you like to use a remote database? (y or n) [default n] y 
  - Please enter Oracle IP address [default 172.20.68.73] 172.20.68.74 
  - Enter the Oracle sid: MCDB
  - Enter the password for the scheme sheer: 
  - Enter the Oracle Listener port: 1521
Step 5 When prompted, indicate whether you would like to modify attributes for the workflow scheme sheer:
  - Use defaults for WorkFlow Scheme? (Y,N) [default Y] 
Step 6 If you do not use the default values for the workflow scheme, enter the required information:

•Oracle SID

•Oracle IP address

•Oracle listener port number

•New password for workflow scheme sheer

For example:
Please enter WorkFlow scheme DB parameters
  - Enter the Oracle sid: MCDB 
  - Would you like to use a remote database? (y or n) [default n] y 
  - Please enter Oracle IP address [default 172.20.68.121] 127.0.0.1 
  - Enter the Oracle Listener port: 1521 
  - Enter the password for the scheme sheer: 
After you enter this information, the system updates the associated files:
  - updating avm11.xml
  - updating avm66.xml
Done. Please restart ANA with mvm.csh.
Step 7 Restart Cisco ANA by running the script:
~sheer/Main/mvm.csh 
Running a Command On All Cisco ANA Units

The script rall.csh is a utility used to run a given command on all units (not on the gateway), as follows:
~sheer/Main/rall.csh <script> 
Where <script> is the script name.

The following script example restarts all units (not the gateway).
~sheer/Main/rall.csh mvm.csh 

	Cisco Active Network Abstraction Administrator Guide 3.6 Service Pack 4
	Utility Scripts
Cisco Active Network Abstraction Administrator Guide 3.6 Service Pack 4 Preface Introducing Cisco ANA Getting Started with Cisco ANA Manage Deploying Cisco ANA Using Cisco ANA Manage Tables Managing Cisco ANA Units Managing AVMs and VNEs Managing Global Settings Managing Links Managing Workflows Managing Security Managing the Event Listener System Health Diagnostics System Security Events Backup and Restore Utility Scripts Golden Source Registry Ports Used by Cisco ANA Drools Rules Engine VNE Persistency Mechanism Index	Download this chapter Utility Scripts Download the complete book PDF of Cisco Active Network Abstraction Administrator Guide 3.6 Service Pack 4 (PDF - 3 MB) Table Of Contents Utility Scripts Restarting Cisco ANA Gateway Restarting a Cisco ANA Unit Changing Passwords for Cisco ANA Database and Workflow Scheme Running a Command On All Cisco ANA Units Utility Scripts This appendix describes the Cisco ANA utility scripts. •Restarting Cisco ANA Gateway—Describes how to restart the gateway from the UNIX command line. •Restarting a Cisco ANA Unit—Describes how to restart a unit from the UNIX command line. •Changing Passwords for Cisco ANA Database and Workflow Scheme—Describes how to change the password for the Cisco ANA database and the workflow scheme sheer. •Running a Command On All Cisco ANA Units—Describes the script used to execute a given command on all units. Restarting Cisco ANA Gateway The user can restart the gateway from the UNIX command line. To restart the gateway: Step 1 Open a Telnet session to the Cisco ANA gateway, and log into the machine. Step 2 Run the script: ~sheer/Main/mvm.csh Note When the gateway is restarted, all clients are reconnected. Note The server status can be verified using Cisco ANA Manage. Restarting a Cisco ANA Unit Restarting a unit stops all AVM processes on that unit and restarts them. Given that the system saves part of its information within the process memory, restarting a unit causes some of the information to disappear. Therefore, it takes as long as the longest full polling cycle for the system to recover all information that was stored in the process memory prior to the restart. Data that was saved in persistent storage before restarting is available immediately. Restarting a machine can cause some of the VNEs running on the machine to be reported as unreachable. This is due to handshake protocols with the unit that fail due to the unavailability of the VNEs. Restarting a machine stops all active queries, flows, and transactions that are currently being run within the VNEs that run on the restarted Cisco ANA unit. To restart a unit: Step 1 Open a Telnet session to the Cisco ANA unit and log into the machine. Step 2 Run the script: ~sheer/Main/mvm.csh Changing Passwords for Cisco ANA Database and Workflow Scheme The passwords for user sheer and the workflow scheme sheer are established during Cisco ANA installation. In releases prior to Cisco ANA 3.6 Service Pack 4, these passwords cannot be modified by editing their associated files because the passwords are encrypted. Beginning with Cisco ANA 3.6 Service Pack 4, a script is included that allows you to change the passwords for the Cisco ANA database and the workflow scheme. Note This script changes only the password that Cisco ANA uses to connect to the database; it does not change the Oracle password for the user sheer. Before You Begin •Change the Oracle password of the user sheer before changing the Cisco ANA database password as described in this procedure. •Shut down Cisco ANA on the gateway. If you do not, Cisco ANA will be shut down by the procedure. To change the user sheer password for the Cisco ANA database or for the workflow scheme sheer: Step 1 Open a Telnet session to the Cisco ANA gateway and log in as user sheer. Step 2 At the prompt, enter the command: sheer@server12 [~]%DatabasePasswordChange.pl + This application changes the database references in ANA. + IF YOU DECIDE TO CONTINUE, ANA WILL BE SHUT DOWN. Step 3 When prompted, enter Y to continue or N to exit the procedure: Are you sure you want to continue? (Y,N) [default N] Y Step 4 As the script proceeds, enter the required information: •Oracle IP address •Oracle SID •New password for the Cisco ANA database •Oracle listener port number For example: Please provide the following database parameters: - Would you like to use a remote database? (y or n) [default n] y - Please enter Oracle IP address [default 172.20.68.73] 172.20.68.74 - Enter the Oracle sid: MCDB - Enter the password for the scheme sheer: - Enter the Oracle Listener port: 1521 Step 5 When prompted, indicate whether you would like to modify attributes for the workflow scheme sheer: - Use defaults for WorkFlow Scheme? (Y,N) [default Y] Step 6 If you do not use the default values for the workflow scheme, enter the required information: •Oracle SID •Oracle IP address •Oracle listener port number •New password for workflow scheme sheer For example: Please enter WorkFlow scheme DB parameters - Enter the Oracle sid: MCDB - Would you like to use a remote database? (y or n) [default n] y - Please enter Oracle IP address [default 172.20.68.121] 127.0.0.1 - Enter the Oracle Listener port: 1521 - Enter the password for the scheme sheer: After you enter this information, the system updates the associated files: - updating avm11.xml - updating avm66.xml Done. Please restart ANA with mvm.csh. Step 7 Restart Cisco ANA by running the script: ~sheer/Main/mvm.csh Running a Command On All Cisco ANA Units The script rall.csh is a utility used to run a given command on all units (not on the gateway), as follows: ~sheer/Main/rall.csh <script> Where <script> is the script name. The following script example restarts all units (not the gateway). ~sheer/Main/rall.csh mvm.csh
	© 1992-2009 Cisco Systems, Inc. All rights reserved. Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks of Cisco Systems, Inc.