Please consult the Installation & Upgrade Guide for details on how to install the CLI.
To configure the CLI, all users must configure their accounts with an environment variable named EVDIR. This should have a value that points to the directory that contains the file named evconfig.txt. For example, the appropriate command may be:
setenv EVDIR=/extraview/api
The file evconfig.txt contains information that points to the server components where ExtraView is located as well as other required information. An example of the file is shown below.
|
SERVER = myserver.mycompany.com/evj/ExtraView POP3_USER = myname POP3_PASSWORD = mypass POP3_SERVER = mail.mycompany.com SUBJ_REGEX = ^Subject SMTP_SERVER = mail.mycompany.com |
| SERVER | This entry is the URL of the ExtraView API module as installed |
| POP3_USER | The user’s email address on the POP3 server |
| POP3_PASSWORD | The user’s email password on the POP3 server |
| POP3_SERVER | The address of the POP3 server on the network |
| SUBJ_REGEX | Regular expression used to identify the submitted issue and the action to be taken when the mail is processed |
| SMTP_CC | This address is used when delivery of mail through ExtraView fails. This avoids mail not being delivered to any address and just sitting in a queue |
| SMTP_FAIL_MSG_FNAM | This is the absolute path of a file that contains a template to be used in the event of a failure of the mail delivery system through ExtraView. If the message is not processed by ExtraView, this file is used as the body of the mail to be sent to the addresses in SMTP_FROM and SMTP_CC.
If the body contains a tag __BODY__, then the tag is replaced by the email being processed. If the body contains a tag __REASON_, then the tag is replaced by the error message returned as an error message from ExtraView |
| SMTP_FROM | This address is used when delivery of mail through ExtraView fails. This avoids mail not being delivered to any address and just sitting in a queue |
| SMTP_SERVER | The SMTP server for email. |
This is very similar to the Linux / UNIX installation. Please follow the instructions but with these differences:
The CLI supports HTTPS, SSL SMTP and SSL POP3. Configuring the CLI to use these features requires manual configuration.
Modify the evconfig.txt configuration file by adding the following lines:
HTTPS = on
POP3_SSL = on
POP3_SSL_PORT = 995 # change to your POP3 port number
SMTP_SSL = on
SMTP_SSL_PORT = 465 # change to your SMTP port number
HB_SMTP_SSL=on
HB_SMTP_SSL_PORT=465 # change to your HB_SMTP port number
Download and install OpenSSL from http://www.openssl.org/. This must be done before the next step in the installation procedure.
Download and manually install the following Perl Modules. These cannot be automatically installed by ExtraView’s installation procedures as ExtraView’s installation is machine independent and these modules generate and install machine-specific code during their installation.
Net_SSLeay.pm
Perl extension for using OpenSSL
Version: 1.30
Author: Sampo Kellomaki
CPAN: http://search.cpan.org/dist/Net_SSLeay.pm-1.30/
IO-Socket-SSL
Nearly transparent SSL encapsulation for IO::Socket::INET.
Version: 1.08
Author: Steffen Ullrich & Peter Behroozi & Marko Asplund
CPAN: http://search.cpan.org/dist/IO-Socket-SSL-1.08/
Net-SMTP-SSL
SSL support for Net::SMTP
Version: 1.01
Author: Casey West
CPAN: http://search.cpan.org/dist/Net-SMTP-SSL-1.01/
Crypt-SSLeay
OpenSSL glue that provides LWP https support
Version: 0.53
Author: Joshua Chamas
CPAN: http://search.cpan.org/dist/Crypt-SSLeay-0.53/
