Installation and Setup Guide for Cisco Enhanced … · vii Installation and Setup Guide for Cisco...

Installation and Setup Guide for Cisco Enhanced Device Interface on WindowsSoftware Release 2.2.1

Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706 USAhttp://www.cisco.comTel: 408 526-4000

800 553-NETS (6387)Fax: 408 527-0883

http://www.cisco.com

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0809R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

Installation and Setup Guide for Cisco Enhanced Device Interface on Windows Copyright © 2003 - 2008 Cisco Systems, Inc. All rights reserved

Insta

C O N T E N T S

Preface v

Audience v

Conventions v

Obtaining Documentation, Obtaining Support, and Security Guidelines vii

Installing Cisco E-DI 2.2.1 on Windows 9

Introduction 9

Installing Cisco E-DI on Windows 10

System Requirements for Windows 10

Installing Cisco E-DI 10

Using Cisco E-DI on Windows 12

Starting Cisco E-DI Service 13

Stopping Cisco E-DI Service 13

Logging in to the E-DI Server 13

Backing Up Data 14

Restoring Data 14

Accessing E-DI Log Files 14

Custom Configuration of E-DI Server 15

Uninstalling Cisco E-DI on Windows 15

Error Messages on Windows 15

Launching E-DI Applications 16

Launching Device Configuration Manager (DCM) 17

Launching Macro Command Manager 19

Launching Command Translator 20

Launching Command Analyzer 21

Launching Command Modeler 21

Launching Operational Data Modeler 21

Related Documentation 22

Accessing Documentation 22

Open Source License Acknowledgment 1

telnetd 1

Java Service Wrapper 1

Apache License Version 2.0 2

iiillation and Setup Guide for Cisco Enhanced Device Interface on Windows, 2.2.1

Contents

Apache 1.1 4

PostgreSQL License 5

Javolution 4.1 5

ivInstallation and Setup Guide for Cisco Enhanced Device Interface on Windows, 2.2.1

Preface

This guide explains how to install Cisco Enhanced Device Interface 2.2.1 (Cisco E-DI) on Windows.

Cisco E-DI provides a CLI user interface (CLI-UI), a GUI, and an XML programmatic interface (XML PI). Cisco E-DI is used by Enterprise as well as Service Provider customers. It supports configuration for Cisco IOS and CatOS network elements (NEs) and Cisco PIX firewall devices, and applicable services and devices, including L3 MPLS VPNs, Metro Ethernet, select switches and branch office equipment.

For the latest and updated documentation of Cisco Enhanced Device Interface, 2.2.1, please check Cisco.com:

http://www.cisco.com/en/US/products/ps6456/tsd_products_support_series_home.html

The following documentation is a part of Cisco E-DI 2.2.1:

• Release Notes for Cisco Enhanced Device Interface 2.2.1 on Windows

• Installation and Setup Guide for Cisco Enhanced Device Interface 2.2.1 on Windows

• User Guide for Cisco Enhanced Device Interface 2.2.1

• Programmer's Guide for Cisco Enhanced Device Interface 2.2.1

AudienceThis guide is designed for system administrators and users who are responsible for the operation of the Cisco E-DI.

ConventionsThis document uses the following conventions:

vInstallation and Setup Guide for Cisco Enhanced Device Interface on Windows, 2.2.1


PrefaceConventions

Caution Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the manual.

Timesaver Means the described action saves time. You can save time by performing the action described in the paragraph.

Tip Means the information will help you solve a problem. The tips information might not be troubleshooting or even an action, but could be useful information, similar to a Timesaver.

Table 1 Conventions

Convention Description

^ or Ctrl ^ or Ctrl represents the Control key. For example, the key combination ^D or Ctrl-D means hold down the Control key while you press the D key. Keys are indicated in capital letters but are not case sensitive.

string A string is a nonquoted set of characters. For example, when setting an SNMP community string to public, do not use quotation marks around the string or the string will include the quotation marks.

screen Courier plain shows an example of information displayed on the screen

boldface screen Courier bold shows an example of text that you must enter.

< > Angle brackets show non printing characters, such as passwords.

! An exclamation point at the beginning of a line indicates a comment line.

[ ] Square brackets show optional elements.

{} Braces group alternative, mutually exclusive elements that are part of a required choice.

| A vertical bar, also known as a pipe, separates alternative, mutually exclusive elements of a choice.

viInstallation and Setup Guide for Cisco Enhanced Device Interface on Windows, 2.2.1

PrefaceObtaining Documentation, Obtaining Support, and Security Guidelines

Obtaining Documentation, Obtaining Support, and Security Guidelines

For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

viiInstallation and Setup Guide for Cisco Enhanced Device Interface on Windows, 2.2.1

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

PrefaceObtaining Documentation, Obtaining Support, and Security Guidelines

viiiInstallation and Setup Guide for Cisco Enhanced Device Interface on Windows, 2.2.1

Installation and Setup Guide for C

C H A P T E R 1
Installing Cisco E-DI 2.2.1 on Windows
This chapter has information on installing and getting started with Windows.

This chapter has the following sections:

• Introduction, page 1-9

• Installing Cisco E-DI on Windows, page 1-10

• Launching E-DI Applications, page 1-16

• Related Documentation, page 1-21

IntroductionCisco E-DI provides a comprehensive management interface for configuration of Cisco devices.

It provides interfaces with network devices through the command line interface (CLI) or through a Eclipse-based Graphical User Interface (GUI).

This chapter explains how to install, configure, and start using Cisco E-DI 2.2.1 on Windows. The software is available for download and runs on hardware as detailed in Table 1-1.

Default settings are provided during installation, so that Cisco E-DI can be up and running with minimal configuration. However, the software also lets you enhance this configuration, if you need to.

To install, configure and use Cisco E-DI, you must:

1. Install Cisco E-DI

2. Set up credential sets

3. Discover devices

4. Manage the network

5. Set up user accounts

The procedure to install Cisco E-DI on Windows is provided in this document. For all the other procedures, see User Guide for Cisco Enhanced Device Interface, 2.2.1.

Whenever E-DI is installed, a new user is created in the local computer. The user that is already present, cannot be used.This user will be removed while uninstalling E-DI.

E-DI Installation Location: This is used in this document to indicate the install location of Cisco E-DI.

For the new features in this release, see the Release Notes for Cisco Enhanced Device Interface on Windows, 2.2.1.

1-9isco Enhanced Device Interface on Windows, 2.2.1

Chapter 1 Installing Cisco E-DI 2.2.1 on Windows Installing Cisco E-DI on Windows

Installing Cisco E-DI on WindowsThis section has the following topics:

• System Requirements for Windows, page 1-10

• Installing Cisco E-DI, page 1-10

• Using Cisco E-DI on Windows, page 1-12

• Uninstalling Cisco E-DI on Windows, page 1-15

• Error Messages on Windows, page 1-15

Caution You must enable SSH version 1 to connect to Device Configuration Manager or XML PI APIs.

System Requirements for WindowsBefore installing the Cisco E-DI software, ensure that you have the recommended hardware (See Table 1-1).

Note All the UI applications need jre 1.5. Include Java in path.

Installing Cisco E-DI

Note Before installing on Windows, ensure that your security agent is disabled. As part of the installation Cisco E-DI installs the Postgres database. Please enable your security agent after the installation is complete.

You cannot install another instance of Cisco E-DI if there is a previous installation of Cisco E-DI. Uninstall the existing Cisco E-DI first, see “Uninstalling Cisco E-DI on Windows” section on page 1-15.

During the Windows installation, Perl is installed by default.

Table 1-1 Hardware and OS Requirements

System Requirements

Windows OS Supported Versions • Windows XP Professional (with Service Pack 1)

or

• Windows 2000 Professional (with Service Pack 3)

• Windows Installer. V 3.01.4000.1823 or later (msiexec)

Hardware • IBM PC-compatible computer with 1.6 GHz or faster Pentium processor

• CD-ROM drive

• 2 GB minimum memory

• 20 GB minimum available disk drive space.

1-10Installation and Setup Guide for Cisco Enhanced Device Interface on Windows, 2.2.1


By default, E-DI listens on the 2323 port and supports only Telnet connections.

To install Cisco E-DI 2.2.1 on Windows:

Step 1 Check whether you have Administrative privileges to install Cisco E-DI. See “System Requirements for Windows” for the other requirements.

Step 2 Download the installer launcher (stub) program from the download location. The EDI installable is available as an .exe file (setup.exe).

Step 3 Double-click on the setup.exe after downloading the installable.

E-DI extracts the Cisco EDI2.2.msi and prepares the InstallShield Wizard. The installation wizard starts and displays a Welcome dialog box.

• To stop the installation at any time, click Cancel.

• To go to a previous dialog box, click Back. You can click Back on all windows except the Welcome and Finish dialog boxes.

Step 4 Click Next.

The Customer Information dialog box appears.

Step 5 Enter your User Name and Company Name.

Step 6 Specify whether this application can be run by all users of this computer, or only by you.

Step 7 Click Next.

The License Agreement dialog box appears.

Step 8 Read the License Agreement text and click Yes to accept the agreement.

If you do not accept this license agreement, the installation will terminate.

The Choose Destination Location dialog box appears. The default destination location is:

C:\Program Files\Cisco Systems\Cisco EDI.

If you need to install to a location of your choice:

• Click Browse, from the pop-up.

or

• Select your destination location and click OK.

Step 9 Click Next.

The Start Copying Files dialog box appears.

At this point, you can review your settings or change settings if required. To go to the previous dialog boxes and make any changes, click Back.

Step 10 Click Next.

The installation begins. The InstallShield Wizard displays the setup status and later, the installation status.

When the installation has completed, the completion dialog box appears. The installation takes approximately 5 to10 minutes.

Step 11 Click Finish



Cisco E-DI is installed as a Windows service with Cisco E-DI as the name of the service. The service will not start during system startup. You will have to start this service manually. See Step 12.

The Postgres database is installed as part of the Cisco E-DI installation. Cisco E-DI internally creates a non-admin user: edipostgres. The Postgres database runs as edipostgres user.

Step 12 To start E-DI, go to Start > Programs > Cisco E-DI > E-DI Service > Start. This starts these services:

• Cisco E-DI

• EDIHttpd

• EdiPostgreSQL

Note Whenever E-DI is installed, a new user is created in the local computer. This user will be removed while uninstalling E-DI. The user that already exists on the system cannot be used.

Using Cisco E-DI on WindowsDuring installation Cisco E-DI is installed as a Windows service named Cisco E-DI. This is a manual service. Along with this, the following services are also installed:

• EDIHttpd

• EdiPostgreSQL

These two services are installed as automatic services. After the installation is complete, we recommend that you set them as Manual services. This is to avoid a problem when you restart Windows.

This is because Cisco E-DI is a manual service and these two dependent services may start before this main service begins to run.

To do this:

Step 1 Go to Start > Settings > Control Panel > Administrative Tools > Services.

The Services Window appears.

Step 2 Right-click on EDIHttpd and select Properties.

The EDIHttpd Properties dialog box appears.

Step 3 Change the Startup type to manual by selecting from the drop-down list.

Step 4 Click OK.

Step 5 Repeat the procedure for the EdiPostgreSQL process and click OK.



The following topics describe how to get started with Cisco E-DI:

• Starting Cisco E-DI Service, page 1-13

• Stopping Cisco E-DI Service, page 1-13

• Logging in to the E-DI Server, page 1-13

• Backing Up Data, page 1-14

• Restoring Data, page 1-14

• Accessing E-DI Log Files, page 1-14

Starting Cisco E-DI Service

To start the Cisco E-DI service, select Start > Programs > Cisco E-DI > E-DI Service > Start. This starts these services:

• Cisco E-DI

• EDIHttpd

• EdiPostgreSQL

Note The client cannot connect to Cisco E-DI using SSH.

Stopping Cisco E-DI Service

To stop the Cisco E-DI service, select Start > Programs > Cisco E-DI > E-DI Service > Stop. This stops all these services:

• Cisco E-DI

• EDIHttpd

• EdiPostgreSQL

Logging in to the E-DI Server

After starting the E-DI service see “Starting Cisco E-DI Service”, you can log into the E-DI server. To do this:

Step 1 Select Start > Programs > Cisco E-DI > Console.

The Telnet console opens.

Step 2 Log in with username admin and password admin.

You can change this later.

Note After the E-DI installation is complete a default user name and password is created. If the password does not meet the password policy requirements of the system, you must enter a new password which meets the password policy of the system. When you change the password, the password is added to the system users list.



Backing Up Data

Before uninstalling E-DI, you may want to back up your data.

To back up your data:

Step 1 Stop the E-DI service by selecting Start > Programs > Cisco E-DI > E-DI Service > Stop.

The E-DI service stops.

Step 2 Backup the data by selecting Start > Programs > Cisco E-DI > Data Backup.

The data that is backed up is E-DI config archives, postgres database, and E-DI config.txt.

You should enter an absolute directory path for the E-DI data backup. For example, SystemDrive:\EDI_Backup, which is the default. The backup script does not allow for spaces in the path. If you have spaces in the path, you should use quotes. For example, “C:\EDI Backup”.

Also, you should enter a path that is outside the Cisco E-DI installation directory. For example, if your install location is C:\Program Files\Cisco Systems\Cisco EDI, then your backup directory path should be outside this path. For example C:\EDI_Backup.

If you perform another backup, the data that you backed up earlier, is overwritten.

Restoring Data

After installing E-DI you can restore the data that was backed up previously.

The data will be restored from your backup directory, which you had specified while backing up your data.

You should enter the absolute path of the directory that you used to backup your data. For example, if your backup directory was SystemDrive:\EDI_Backup, enter this path to restore data. Remember to use quotes if your directory path has spaces.

To restore your data:

Step 1 Stop the E-DI service by selecting Start > Programs > Cisco E-DI > E-DI Service > Stop.

The E-DI service stops.

Step 2 Restore the data by selecting Start > Programs > Cisco E-DI > Data Restore.

Step 3 Restart the E-DI service by selecting Start > Programs > Cisco E-DI > E-DI Service > Start.

The E-DI service starts.

Accessing E-DI Log Files

You can access the EDI log files at E-DI Installation Location\Cisco EDI\edi\log:

• nemos.log—Provides the runtime logs.

• wrapper.log—Provides the startup logs.



Custom Configuration of E-DI Server

To increase the maximum heap size, or change ports, you can edit the wrapper.conf file in this location:

EDI-Installation Location\Cisco EDI\edi\bin\conf

Increasing the Maximum Heap Size

By default, Java uses 512 MB (initial) to 1024 MB (maximum) RAM. If you need to manage more devices (for example, more than 200 devices) E-DI may need more resources.

In this case you can change the maximum memory to a value greater than 1.5 GB by editing the wrapper.conf file.

Parameters:

# Initial Java Heap Size (in MB)wrapper.java.initmemory=512

# Maximum Java Heap Size (in MB)wrapper.java.maxmemory=1024

Increase the value of wrapper.java.maxmemory to 1.5 GB or more.

Changing the Port

By default, E-DI Telnet runs at the 2323 port.

If you wish to change this port, you need to edit the wrapper.conf file

#wrapper.java.additional.10=-Dderby.system.home="%EDI_HOME%/db-data"wrapper.java.additional.10=-DCONN_MGR_PORT=2323

Change the default port 2323 to the one that you require.

Uninstalling Cisco E-DI on WindowsCisco E-DI software can be uninstalled from Windows Add/Remove Programs menu. You will be prompted to confirm the uninstallation. After your confirmation, Cisco E-DI will be uninstalled along with PostgreSQL and E-DI HTTPD services.

Uninstalling Cisco E-DI does not always delete the Cisco EDI folder that was created during installation. You should go to the E-DI Install Location and manually delete the Cisco EDI folder to completely remove E-DI 2.2.1.

Error Messages on WindowsThe following messages and alarms may be displayed:

• During installation if the hard disk size is not sufficient, a popup appears with the required hard disk size.

• An error message is displayed if you try to install Cisco E-DI on an operating system other than Windows 2000 or Windows XP.

• An alarm will be displayed if the PostgreSQL database is not available. Enter show alarms at the command prompt, to display this message.


Chapter 1 Installing Cisco E-DI 2.2.1 on Windows Launching E-DI Applications

Launching E-DI ApplicationsThe following applications are packaged with E-DI:

• Device Configuration Manager—Enables you to edit and manage configuration files.

To launch this application, see “Launching Device Configuration Manager (DCM)”. For more details about this application and its usage, see User Guide for Cisco Enhanced Device Interface, 2.2.1.

• Macro Command Manager—Enables you to define device and OS-independent command sets (macros) deploy these macros commands to devices.

To launch this application, see Launching Macro Command Manager. For more details about this application and its usage, see User Guide for Cisco Enhanced Device Interface, 2.2.1.

• Command Translator—Enables you to translate Cisco Catalyst Operating System (CatOS) configurations to equivalent, supported Cisco IOS configurations.

To launch this application, see Launching Command Translator. For more details about this application and its usage, see User Guide for Cisco Enhanced Device Interface, 2.2.1.

• Command Analyzer—Allows you to check commands for completeness, and enables you to compares two IOS images.

To launch this application, see Launching Command Analyzer. For more details about this application and its usage, see Programmer’s Guide for Cisco Enhanced Device Interface, 2.2.1.

• Command Modeler—Provides an infrastructure for generating and validating device-independent CLI models. Developers can use the generated device independent CLI models to generate device-specific Java code.

To launch this application, see Launching Command Modeler. For more details about this application on and its usage, see Programmer’s Guide for Cisco Enhanced Device Interface, 2.2.1.

• Operational Data Modeler—The Operational Data Modeler (ODM) enables you to create a unique Data Model for the operational data that is available through CLI show commands.

To launch this application, see Launching Operational Data Modeler. For more details about this application on and its usage, see Programmer’s Guide for Cisco Enhanced Device Interface, 2.2.1.

Tip Before you launch any application, we recommend that you clean the cache. (These steps are optional): Go to the command prompt and navigate to your Eclipse folder (where eclipse.exe resides). Run the command eclipse -clean This ensures that the cache is cleaned.

Launching Device Configuration Manager (DCM)After you have installed Cisco E-DI, follow these steps to launch DCM. DCM is a client application that can be used to connect to any E-DI server.

Before you start DCM, ensure that the EDI Service is running. To start this service, go to Start > Programs > Cisco E-DI > E-DI Service > Start.



Step 1 Select Start > Programs > Cisco E-DI > Device Configuration Manager.

or

Navigate to the directory E-DI Install Location\Cisco EDI\edi\dist\ui_products\configmanager and double-click launcher .exe.

E-DI prompts you to log in to the E-DI server.

Step 2 Log in using the admin credentials.

Select the SSH check box if you want to run DCM in SSH mode.

By default, DCM connects to the port 2323 on the server.

If the server Telnet port is not 2323, you can change this value in the eclipse.ini file located at: E-DI Install Location\edi\dist\ui_products\configmanager.

After you log in, Device Configuration Manager opens. This has three perspectives (which appear as buttons):

• Config Manager—This is the default perspective, and this button is highlighted.

• Macro Command Manager—Opens the Macro Command Manager perspective.

• Command Translator—Opens the Command Translator perspective. To display the Commnand Translator button, click on the >> symbol that appears after the Macro Command Manager Button. See Figure 1-1. After you click on >>, the Command Translator button appears. See Figure 1-2.

Figure 1-1 Device Configuration Manager default perspectives and the >> symbol



Figure 1-2 The Command Translator button appears

Launching Macro Command ManagerBefore you start Macro Command Manager, ensure that the EDI Service is running. To start this service, On Windows, go to Start > Programs > Cisco E-DI > E-DI Service > Start.

Macro Command Manager is packaged with Device Configuration Manager of Cisco E-DI. To be able to access Macro Command Manager, you should first launch Device Configuration Manager.

Follow these steps to launch Macro Command Manager:

Step 1 Choose Start > Programs > Cisco E-DI >Device Configuration Manager.

or

Navigate to the directory E-DI Install Location\Cisco EDI\edi\dist\ui_products\configmanager and double-click on launcher .exe.









• Command Translator—Opens the Command Translator perspective.



Note To display the Command Translator button, click on the >> symbol that appears after the Macro Command Manager Button. See Figure 1-1. After you click on >>, the Command Translator button appears. See Figure 1-2.

Step 3 Select Macro Command Manager and click OK.

The Macro Command Manager perspective opens.

Launching Command TranslatorCommand Translator is packaged with Device Configuration Manager of Cisco E-DI, and will be available after you have installed Cisco E-DI.

Before you start Command Translator, ensure that the EDI Service is running. To start this service, On Windows, go to Start > Programs > Cisco E-DI > E-DI Service > Start. To be able to access Command Translator, you should first launch Device Configuration Manager.

To launch Command Translator:

Step 1 Choose Start > Programs > Cisco E-DI > Device Configuration Manager.

or

Navigate to the directory E-DI Install Location\Cisco EDI\edi\dist\ui_products\configmanager and double-click on launcher .exe.









• Command Translator—Opens the Command Translator perspective.

Note To display the Command Translator button, click on the >> symbol that appears after the Macro Command Manager Button. See Figure 1-1. After you click on >>, the Command Translator button appears. See Figure 1-2.

Step 3 Click Command Translator.

The Command Translator perspective opens.



Launching Command AnalyzerCommand Analyzer is a stand-alone application.The E-DI server does not need to be running for you to be able to use Command Analyzer.

To launch Command Analyzer:

Select Start > Programs > Cisco E-DI > E-DI Command Analyzer. The Command Analyzer opens.

or

Navigate to E-DI Install Location\Cisco EDI\edi\dist\ui_products\cmdAnalyzer directory and double-click on launcher.exe.

The Command Analyzer opens.

Launching Command ModelerYou should install Eclipse 3.2 before launching Command Modeler.

To launch Command Modeler:

Step 1 Navigate to the folder E-DI Install Location\Cisco EDI\edi\dist\cmdModeler\lib.

Step 2 Copy the Command Modeler jar file (com.cisco.edi.cmdModeler_buildnumber.jar) from the lib folder.

Step 3 Paste the jar file into the Eclipse plugins folder (Eclipse Directory\plugins).

Note Ensure that Eclipse is closed while the jar is copied into the plugins folder.

Step 4 Start Eclipse.

Step 5 From the Main Menu Bar, select Windows > Open Perspective > Other.

The Open Perspective dialog box opens.

Step 6 Select Command Modeler and click OK.

The Command Modeler perspective opens.

Launching Operational Data ModelerThe E-DI server does not need to be running for you to be able to use ODM. It is a stand-alone application.

To launch ODM:

Step 1 Navigate to the directory E-DI Install Location\Cisco EDI\edi\dist\ui_products\ODM.

Step 2 Double-click on launcher.exe.

ODM opens.


Chapter 1 Installing Cisco E-DI 2.2.1 on Windows Related Documentation

Related DocumentationThe following documentation is available for Cisco E-DI 2.2.1: Also see Accessing Documentation.

• User Guide for Cisco Enhanced Device Interface, 2.2.1

• Programmer’s Guide for Cisco Enhanced Device Interface, 2.2.1

• Release Notes for Cisco Enhanced Device Interface, 2.2.1 on Windows

• Online help integrated with the applications.

Accessing DocumentationYou can access the documentation for Cisco E-DI in the following ways:

• PDFs of the User Guide for Cisco Enhanced Device Interface, 2.2.1 and the Programmer’s Guide for Cisco Enhanced Device Interface, 2.2.1 are available in the documentation folder in the E-DI Install Location/Cisco EDI/docs.

• After installing Cisco E-DI:

– To access the Programmer’s Guide:

Select Start > Programs > Cisco E-DI > Documentation > Programmer’s Guide.

The Programmer’s Guide for Cisco Enhanced Device Interface, 2.2.1 opens.

– To access the User Guide:

Select Start > Programs > Cisco E-DI > Documentation > User Guide.

The User Guide for Cisco Enhanced Device Interface, 2.2.1 opens

• The UI applications, Command Analyzer, Operational Data Model, Command Modeler, Command Translator, Macro Command Manager, and Device Configuration have integrated Online help. For each application, from the GUI, select Help > Help Contents to launch the help for that application

• For the latest and updated documentation of Cisco Enhanced Device Interface, 2.2.1, please check Cisco.com:




Chapter 1 Installing Cisco E-DI 2.2.1 on Windows Related Documentation


Installation and Setup Guide for Cisco E

A
P P E N D I X A Open Source License Acknowledgment
Cisco E-DI 2.2.1 uses third-party open source software subject to the following licenses:

• telnetd, page A-1

• Java Service Wrapper, page A-1

• Apache License Version 2.0, page A-2

• Apache 1.1, page A-4

• PostgreSQL License, page A-5

• Javolution 4.1, page A-5

telnetdJava TelnetD library (embeddable telnet daemon)Copyright (c) 2000-2005 Dieter Wimberger.All rights reserved.Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.Neither the name of the author nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Java Service WrapperCopyright (c) 1999, 2005 Tanuki Software Inc.Permission is hereby granted, free of charge, to any person obtaining a copy of the Java Service Wrapper and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,

A-1nhanced Device Interface on Windows, 2.2.1

Appendix A Open Source License Acknowledgment Apache License Version 2.0

modify, merge, publish, distribute, sub-license, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.Portions of the Software have been derived from source code developed by Silver Egg Technology under the following license:Copyright (c) 2001 Silver Egg TechnologyPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sub-license, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Apache License Version 2.0Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a

A-2Installation and Setup Guide for Cisco Enhanced Device Interface on Windows, 2.2.1

Appendix A Open Source License Acknowledgment Apache License Version 2.0

perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and


Appendix A Open Source License Acknowledgment Apache 1.1

on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Apache 1.1/ ====================================================================The Apache Software License, Version 1.1

Copyright (c) 2000 The Apache Software Foundation. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.3. The end-user documentation included with the redistribution, if any, must include the following acknowledgment:"This product includes software developed by the Apache Software Foundation (http://www.apache.org/)."Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear.

4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected].

5. Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without prior written permission of the Apache Software Foundation.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.====================================================================This software consists of voluntary contributions made by many individuals on behalf of the Apache Software Foundation. For more information on the Apache Software Foundation, please see <http://www.apache.org/>.


Appendix A Open Source License Acknowledgment PostgreSQL License

Portions of this software are based upon public domain software originally written at the National Center for Supercomputing Applications, University of Illinois, Urbana-Champaign. /

PostgreSQL LicenseLicensePostgreSQL is released under the BSD license.PostgreSQL Database Management System (formerly known as Postgres, then as Postgres95)

Portions Copyright (c) 1996-2005, The PostgreSQL Global Development Group

Portions Copyright (c) 1994, The Regents of the University of California

Permission to use, copy, modify, and distribute this software and its documentation for any purpose, without fee, and without a written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies.

IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

Why not the GNU General Public License?People often ask why PostgreSQL is not released under the GNU General Public License. The simple answer is because we like the BSD license and do not want to change it. If you are keen to read more about this topic, then please take a look in the Archives at any of the many threads on this subject, but please don't start yet another debate on the subject!

Privacy Policy | Project hosted by hub.org | Designed by tinysofaCopyright © 1996 – 2006 PostgreSQL Global Development Group

Javolution 4.1Javolution - Java(TM) Solution for Real-Time and Embedded SystemsCopyright (c) 2006, Javolution (http://javolution.org)All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" ANDANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED


Appendix A Open Source License Acknowledgment Javolution 4.1

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ONANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


Installation and Setup Guide for C

I N D E X

A

accessing documentation 22

accessing log files 14

B

backing up data 14

C

changing the port 15

custom configuration 15

E

error messages 15

I

increaxing max heap size 15

installation

introduction 9

system requirements 10

topics 10

installing 10

topics 10

installing on Windows 9, 10

L

launching

command analyzer 21

command modeler 21

command translator 20

device configuration manager 17

macro command manager 19

operational data modeler 21

launching applications 16

logging on to Cisco E-DI service 13

O

open source lincensing copyright 1

P

preface v

R

related documentation 22

restoring data 14

S

starting Cisco E-DI service 13

stopping Cisco E-DI service 13

system requirements 10

U

unistalling 15

using Cisco E-DI 12

IN-1isco Enhanced Device Interface on Windows, 2.2.1

Index

IN-2Installation and Setup Guide for Cisco Enhanced Device Interface
on Windows, 2.2.1

Date post:	04-Sep-2018
Category:	Documents
Upload:	phungnga
View:	226 times
Download:	0 times

Installation and Setup Guide for Cisco Enhanced … · vii Installation and Setup Guide for Cisco...

Documents