{"id":24278,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/installation-configuration-6\/"},"modified":"2025-02-24T15:41:31","modified_gmt":"2025-02-24T23:41:31","slug":"installation-configuration-6","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/","title":{"rendered":"Installation & Configuration"},"content":{"rendered":"

Please consult the Installation & Upgrade Guide<\/a> for details on how to install the CLI.<\/p>\n

Configuring for Linux \/ UNIX<\/h3>\n

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:<\/p>\n

setenv EVDIR=\/extraview\/api<\/p>\n

The evconfig.txt File<\/h3>\n

The file evconfig.txt<\/span> 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.<\/p>\n

SERVER = myserver.mycompany.com\/evj\/ExtraView
\nPOP3_USER = myname
\nPOP3_PASSWORD = mypass
\nPOP3_SERVER = mail.mycompany.com
\nSUBJ_REGEX = ^Subject
\nSMTP_SERVER = mail.mycompany.com<\/code><\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
SERVER<\/td>\nThis entry is the URL of the ExtraView API module as installed<\/td>\n<\/tr>\n
POP3_USER<\/td>\nThe user\u2019s email address on the POP3 server<\/td>\n<\/tr>\n
POP3_PASSWORD<\/td>\nThe user\u2019s email password on the POP3 server<\/td>\n<\/tr>\n
POP3_SERVER<\/td>\nThe address of the POP3 server on the network<\/td>\n<\/tr>\n
SUBJ_REGEX<\/td>\nRegular expression used to identify the submitted issue and the action to be taken when the mail is processed<\/td>\n<\/tr>\n
SMTP_CC<\/td>\nThis 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<\/td>\n<\/tr>\n
SMTP_FAIL_MSG_FNAM<\/td>\nThis 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<\/td>\n<\/tr>\n
SMTP_FROM<\/td>\nThis 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<\/td>\n<\/tr>\n
SMTP_SERVER<\/td>\nThe SMTP server for email<\/td>\n<\/tr>\n
-B true<\/td>\nThis is an optional entry within the file.\u00a0 If this is present, the CLI will not attempt to use SAML as an authentication method if this is used for thebrowser interface, but will use ExtraView’s internal authentication mechanism<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Configuring for Microsoft Windows<\/h3>\n

This is very similar to the Linux \/ UNIX installation. Please follow the instructions but with these differences:<\/p>\n

    \n
  • The .evrc file is named evrc.txt and is stored in the current directory<\/li>\n
  • Windows NT and Windows 2000 use AT commands as opposed to cron jobs to run tasks on a timed basis.<\/li>\n<\/ul>\n

    Configuring the CLI to work with HTTPS<\/h3>\n

    The CLI supports HTTPS, SSL SMTP and SSL POP3. Configuring the CLI to use these features requires manual configuration.<\/p>\n

    Step 1<\/h4>\n

    Modify the evconfig.txt configuration file by adding the following lines:<\/p>\n

    HTTPS = on
    \nPOP3_SSL = on
    \nPOP3_SSL_PORT = 995 # change to your POP3 port number
    \nSMTP_SSL = on
    \nSMTP_SSL_PORT = 465 # change to your SMTP port number
    \nHB_SMTP_SSL=on
    \nHB_SMTP_SSL_PORT=465 # change to your HB_SMTP port number<\/code><\/p>\n

    Step 2<\/h4>\n

    Download and install OpenSSL from http:\/\/www.openssl.org\/. This must be done before the next step in the installation procedure.<\/p>\n

    Step 3<\/h4>\n

    Download and manually install the following Perl Modules. These cannot be automatically installed by ExtraView\u2019s installation procedures as ExtraView\u2019s installation is machine independent and these modules generate and install machine-specific code during their installation.<\/p>\n

    Net_SSLeay.pm<\/b>
    \nPerl extension for using OpenSSL
    \nVersion: 1.30
    \nAuthor: Sampo Kellomaki
    \n<sampo@iki.fi> CPAN: http:\/\/search.cpan.org\/dist\/Net_SSLeay.pm-1.30\/<\/sampo@iki.fi><\/p>\n

    <sampo@iki.fi> IO-Socket-SSL<\/b>
    \nNearly transparent SSL encapsulation for IO::Socket::INET.
    \nVersion: 1.08
    \nAuthor: Steffen Ullrich & Peter Behroozi & Marko Asplund
    \nCPAN: http:\/\/search.cpan.org\/dist\/IO-Socket-SSL-1.08\/<\/sampo@iki.fi><\/p>\n

    <sampo@iki.fi> Net-SMTP-SSL<\/b>
    \nSSL support for Net::SMTP
    \nVersion: 1.01
    \nAuthor: Casey West
    \n<casey@geeknest.com>CPAN: http:\/\/search.cpan.org\/dist\/Net-SMTP-SSL-1.01\/<\/casey@geeknest.com><\/sampo@iki.fi><\/p>\n

    <sampo@iki.fi><casey@geeknest.com> Crypt-SSLeay<\/b>
    \nOpenSSL glue that provides LWP https support
    \nVersion: 0.53
    \nAuthor: Joshua Chamas
    \nCPAN: http:\/\/search.cpan.org\/dist\/Crypt-SSLeay-0.53\/ <\/casey@geeknest.com><\/sampo@iki.fi><\/p>\n","protected":false},"excerpt":{"rendered":"

    Please consult the Installation & Upgrade Guide for details on how to install the CLI. Configuring for Linux \/ UNIX 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…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24277,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"no","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-24278","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nInstallation & Configuration - Product Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Installation & Configuration - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Please consult the Installation & Upgrade Guide for details on how to install the CLI. Configuring for Linux \/ UNIX 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...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-24T23:41:31+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/\",\"name\":\"Installation & Configuration - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-24T23:41:31+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ExtraView 25\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Command Line Interface\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Installation & Configuration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Installation & Configuration - Product Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/","og_locale":"en_US","og_type":"article","og_title":"Installation & Configuration - Product Documentation","og_description":"Please consult the Installation & Upgrade Guide for details on how to install the CLI. Configuring for Linux \/ UNIX 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...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-24T23:41:31+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/","name":"Installation & Configuration - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-24T23:41:31+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/installation-configuration-6\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":2,"name":"ExtraView 25","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":3,"name":"Command Line Interface","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/command-line-interface-1\/"},{"@type":"ListItem","position":4,"name":"Installation & Configuration"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v25\/#website","url":"https:\/\/docs.extraview.com\/v25\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v25\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v25\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v25\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v25\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24278","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/comments?post=24278"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24278\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24277"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24278"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}