The ExtraView Command Line Interface is an optional component that requires the Perl interpreter to be installed first. Check the software requirements page for the recommended version of Perl for your computer system.

Perl Installation for Linux

Download the appropriate version of Perl for your computer system from www.perl.org and perform the following steps to install Perl from source:

  1. Extract the files from the perl-NNN.tar.gz download file into a temporary directory
  2. Read the INSTALL file to learn how to install Perl
  3. Execute the following commands to install Perl in the /usr/local/extraview/perl directory (or any other location available) and install the additional Perl modules required by the CLI:

    cd perl-NNN
sh Configure -Dprefix=/usr/local/extraview/perl -des
make
make test
make install
cd /usr/local/extraview/perl/bin
./cpan Term::ReadKey
./cpan HTTP::Request::Common
./cpan LWP::UserAgent
./cpan XML::Parser
./cpan Mail::Sendmail
./cpan Mail::POP3Client
./cpan Mail::Sender
./cpan MIME::Parser
./cpan HTML::FormatText
  4. Cleanup and remove the temporary directory containing the extracted files

CLI Installation for Linux

Download the CLI from the ExtraView Support site download page. The download file is named evcli_unix.tar.

If you are upgrading, you may have a folder called evapi or evcli. The new package will have a version-specific name. For the upgrade, simply copy the configuration file from your existing directory to the new directory created during the CLI installation, and start using the new version of the CLI commands.

The following commands illustrate how to extract the CLI files from the download file, and make some file modifications so that the CLI commands will execute properly on your system:

tar -xvf evcli_unix.tar
cd evjNNN_evcli
PERL_HOME = /usr/local/extraview/perl
export PERL_HOME
/bin/perl -p -i -e "s#/usr/local/bin/perl#/bin/perl#" ev* manifest.pl
chmod +x manifest.pl ev*

Run the following check to verify that the installation is working as expected. The manifest.pl script goes through each CLI command and verifies that the required Perl modules are installed. If this gives you any errors, please contact ExtraView Support.

./manifest.pl

Next, edit the file evconfig.txt with a text editor, such as vi, to configure the CLI to connect to your ExtraView server. Set the SERVER setting to the URL of your ExtraView server. For example:

SERVER = extraview.yourdomain.com/evj/ExtraView

Lastly, test the CLI to make sure that it works and can communicate with the ExtraView server by executing the evcheck CLI command:

./evcheck

This command will prompt you for a username and password and then attempt to access the ExtraView server with your credentials. The command prints information about the server, version, and other settings. For example:

  config file: /home/user/evjNNN_evcli/evconfig.txt
       server: http://extraview.yourdomain.com/evj/ExtraView/ev_api.action
evapi version: Release 7.0.2 Build 65
      modtime: 12/31/2011 05:10 PM
         user: username - from command line
    delimiter: :