Labrats.us - User contributions [en]

New CentOS 7 Server Setup Commands

2025-03-20T22:53:49Z

Sfiggins: /* Post install configuration */

== Install From Image, with 'minimal install' option ==

== Post install configuration ==

=== Update /etc/yum.repo.d/CentOS-Base.repo for archive support ===

<pre>
# CentOS-Base.repo
#
# The mirror system uses the connecting IP address of the client and the
# update status of each mirror to pick mirrors that are updated to and
# geographically close to the client. You should use this for CentOS updates
# unless you are manually picking other mirrors.
#
# If the mirrorlist= does not work for you, as a fall back you can try the
# remarked out baseurl= line instead.
#
#

[base]
name=CentOS-$releasever - Base
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/os/$basearch/
baseurl=http://vault.centos.org/7.9.2009/os/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#released updates
[updates]
name=CentOS-$releasever - Updates
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/updates/$basearch/
baseurl=http://vault.centos.org/7.9.2009/updates/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#additional packages that may be useful
[extras]
name=CentOS-$releasever - Extras
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/extras/$basearch/
baseurl=http://vault.centos.org/7.9.2009/extras/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#additional packages that extend functionality of existing packages
[centosplus]
name=CentOS-$releasever - Plus
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=centosplus&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/centosplus/$basearch/
baseurl=http://vault.centos.org/7.9.2009/centosplus/$basearch/
gpgcheck=1
enabled=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
</pre>

=== Remove Network Manager software ===

<pre>
# /bin/systemctl disable NetworkManager
# /bin/systemctl disable NetworkManager-dispatcher
# yum erase NetworkManager-tui NetworkManager-glib NetworkManager
</pre>

=== Configure Network ===

Run the commands below to set up a static ip address (192.168.1.221) and hostname (test-centos-1).

<pre>
# export remote_hostname=guest1
# export remote_ip=192.168.1.221
# export remote_gateway=192.168.1.1

# hostnamectl set-hostname $remote_hostname

# sed -i.bak "s/.*BOOTPROTO=.*/BOOTPROTO=none/g" /etc/sysconfig/network-scripts/ifcfg-eth0

# cat << EOF >> /etc/sysconfig/network-scripts/ifcfg-eth0
IPADDR0=$remote_ip
PREFIX0=24
GATEWAY0=$remote_gateway
DNS1="216.136.95.2"
DNS2="64.132.94.250"
NM_CONTROLLED="no"
EOF

# systemctl restart network
# systemctl enable network.service
# systemctl enable sshd
# systemctl start sshd

# echo "checking connectivity"
# ping www.google.com
</pre>

=== Disable selinux ===

<pre>
# setenforce 0
# sed -i.bak "s/^SELINUX=.*/SELINUX=disabled/g" /etc/selinux/config
</pre>

=== Remove Postfix, and add needed packages. ===

<pre>
# yum -y erase postfix
# yum -y install finger nc net-snmp net-snmp-perl net-snmp-utils ntp perl-Date-Manip \
perl-DBD-SQLite sendmail sendmail-cf sssd tcp_wrappers tcpdump telnet tftp \
tog-pegasus traceroute vim-enhanced wget oddjob-mkhomedir net-tools yum-cron \
bind-utils
</pre>

Alternately, you can leave Postfix and just install needed packages.

<pre>
# yum -y install finger nc net-snmp net-snmp-perl net-snmp-utils ntp perl-Date-Manip \
perl-DBD-SQLite sssd tcp_wrappers tcpdump telnet tftp tog-pegasus traceroute \
vim-enhanced wget oddjob-mkhomedir net-tools yum-cron bind-utils
</pre>

=== Fix Time Zone ===

<pre>
# rm -f /etc/localtime
# ln -s /usr/share/zoneinfo/MST7MDT /etc/localtime
</pre>

=== Turn off rp_filter ===

<pre>
# echo "net.ipv4.conf.default.rp_filter = 0" > /etc/sysctl.d/rpfilter.conf
</pre>

==Update required Packages==

<pre>
# yum update kernel bash nss nspr ntp glibc cvs
</pre>

==Reboot Server to apply new kernel==

<pre>
# shutdown -r now
</pre>

==Remove old kernel so system scans cleanly and update kernel tools==

<pre>
# rpm -qa | grep kernel
# yum -y erase kernel-<old kernel version>
# yum -y update kernel-tools kernel-tools-libs
</pre>

==Install VM Tools==

If this is a virtual machine, install the open vm tools.

<pre>
# yum -y install open-vm-tools
</pre>

Recover Failed RAID1 w/ MDADM

2025-02-10T06:25:56Z

Sfiggins: /* Bootable System */

== Preface ==

If you are here, you are already in trouble. Make sure you understand the situation before you move forward.

1) Was there a hardware failure? If it was one of the drives in a RAID1, you can likely recover.
2) Was it a software or configuration failure? This can be recovered, bu tmake sure you do it in the right order.

In any event, make sure you read carefully, and understand what the failure is.

I also wrote this primalially for myself. Your mileage may vary.

== Diagnosis ==

Is your system still bootable and alive? If it is, then recovers is going to be easier. If it is not, then you will need to have a rescue disk or live CD to boot the system.

=== Bootable System ===

Since your system is still operable, you will likely have access to all the tools you need. Mostly, you will use '''mdadm''', but you may also use '''sfdisk''' if you have to replace a disk.

=== Non-Bootable System ===

Since we are in the Ubuntu section, perhaps you can boot from a Ubuntu live CD. you may need to use '''apt-get''' or '''apt''' to install '''mdadm'''. Let's hope you don't have any special needs, like custom video drivers.

Recover Failed RAID1 w/ MDADM

2025-02-10T06:23:44Z

Sfiggins: /* Diagnosis */

Recover Failed RAID1 w/ MDADM

2025-02-10T06:20:21Z

Sfiggins: /* Preface */

Recover Failed RAID1 w/ MDADM

2025-02-10T06:19:47Z

Sfiggins: Created page with "== Preface == IF you are here, you are already in trouble. Make sure you understand the situation before you move forward. 1) Was there a hardware failure? If it was one o..."

== Preface ==

IF you are here, you are already in trouble. Make sure you understand the situation before you move forward.

1) Was there a hardware failure? If it was one of the drives in a RAID1, you can likely recover.
2) Was it a software or configuration failure? This can be recovered, bu tmake sure you do it in the right order.

In any event, make sure you read carefully, and understand what the failure is.

I also wrote this primalially for myself. Your mileage may vary.

== Diagnosis ==

Ubuntu

2025-02-10T06:16:40Z

Sfiggins:

* [[Ubuntu Workstation w/ RAID1]]
* [[Recover Failed RAID1 w/ MDADM]]

Ubuntu

2025-02-10T06:16:16Z

Sfiggins:

* [[Ubuntu Workstation w/ RAID1]]
* [[Recode Failed RAID1 w/ MDADM]]

User:Sfiggins/FreeBSD Sendmail with DKIM

2024-04-03T03:25:10Z

Sfiggins:

Using the following Links as references:

https://alfaexploit.com/en/posts/sendmail_dovecot_spamassassin_rainloop_sieve_opendkim_spf_dmarc_on_freebsd/

https://www.web-workers.ch/index.php/2019/10/21/how-to-configure-dkim-spf-dmarc-on-sendmail-for-multiple-domains-on-centos-7/

Install OpenDKIM from the FreeBSD Package manager, set it to enable, and change ownership of the run directory, which will contain the PID and socket files.

# pkg install opendkim
# sysrc milteropendkim_enable=yes
# chown mailnull:mailnull /var/run/milteropendkim/

Change directory to the /usr/local/etc/mail directory, where the OpenDKIM configuration lived. Create a subdirectory for include files and edit the main file.

# cd /usr/local/etc/mail/
# mkdir opendkim.d
# vi opendkim.conf

Example of opendkim.conf file:

<pre>
##
## opendkim.conf -- configuration file for OpenDKIM filter
##
## Copyright (c) 2010-2015, The Trusted Domain Project. All rights reserved.
##

##
## For settings that refer to a "dataset", see the opendkim(8) man page.
##

## DEPRECATED CONFIGURATION OPTIONS
##
## The following configuration options are no longer valid. They should be
## removed from your existing configuration file to prevent potential issues.
## Failure to do so may result in opendkim being unable to start.
##
## Removed in 2.10.0:
## AddAllSignatureResults
## ADSPAction
## ADSPNoSuchDomain
## BogusPolicy
## DisableADSP
## LDAPSoftStart
## LocalADSP
## NoDiscardableMailTo
## On-PolicyError
## SendADSPReports
## UnprotectedPolicy

## CONFIGURATION OPTIONS

## AllowSHA1Only { yes | no }
## default "no"
##
## By default, the filter will refuse to start if support for SHA256 is
## not available since this violates the strong recommendations of
## RFC6376 Section 3.3, which says:
##
## "Verifiers MUST implement both rsa-sha1 and rsa-sha256. Signers MUST
## implement and SHOULD sign using rsa-sha256."
##
## This forces that violation to be explicitly selected by the administrator.

# AllowSHA1Only no

## AlwaysAddARHeader { yes | no }
## default "no"
##
## Add an "Authentication-Results:" header even to unsigned messages
## from domains with no "signs all" policy. The reported DKIM result
## will be "none" in such cases. Normally unsigned mail from non-strict
## domains does not cause the results header to be added.

# AlwaysAddARHeader no

## AuthservID string
## default (local host name)
##
## Defines the "authserv-id" token to be used when generating
## Authentication-Results headers after message verification.

# AuthservID example.com

## AuthservIDWithJobID
## default "no"
##
## Appends a "/" followed by the MTA's job ID to the "authserv-id" token
## when generating Authentication-Results headers after message verification.

# AuthservIDWithJobId no

## AutoRestart { yes | no }
## default "no"
##
## Indicate whether or not the filter should arrange to restart automatically
## if it crashes.

# AutoRestart No
AutoRestart yes

## AutoRestartCount n
## default 0
##
## Sets the maximum automatic restart count. After this number of
## automatic restarts, the filter will give up and terminate. A value of 0
## implies no limit.

# AutoRestartCount 0

## AutoRestartRate n/t[u]
## default (none)
##
## Sets the maximum automatic restart rate. See the opendkim.conf(5)
## man page for the format of this parameter.

# AutoRestartRate n/tu
AutoRestartRate 10/1h

## Background { yes | no }
## default "yes"
##
## Indicate whether or not the filter should run in the background.

# Background Yes

## BaseDirectory path
## default (none)
##
## Causes the filter to change to the named directory before beginning
## operation. Thus, cores will be dumped here and configuration files
## are read relative to this location.

# BaseDirectory /var/run/opendkim

## BodyLengthDB dataset
## default (none)
##
## A data set that is checked against envelope recipients to see if a
## body length tag should be included in the generated signature.
## This has security implications; see opendkim.conf(5) for details.

# BodyLengthDB dataset

## Canonicalization hdrcanon[/bodycanon]
## default "simple/simple"
##
## Select canonicalizations to use when signing. If the "bodycanon" is
## omitted, "simple" is used. Valid values for each are "simple" and
## "relaxed".

# Canonicalization simple/simple
Canonicalization relaxed/simple

## ClockDrift n
## default 300
##
## Specify the tolerance range for expired signatures or signatures
## which appear to have timestamps in the future, allowing for clock
## drift.

# ClockDrift 300

## Diagnostics { yes | no }
## default "no"
##
## Specifies whether or not signatures with header diagnostic tags should
## be generated.

# Diagnostics No

## DNSTimeout n
## default 10
##
## Specify the time in seconds to wait for replies from the nameserver when
## requesting keys or signing policies.

# DNSTimeout 10

## Domain dataset
## default (none)
##
## Specify for which domain(s) signing should be done. No default; must
## be specified for signing.

Domain example.com

## DomainKeysCompat { yes | no }
## default "no"
##
## When enabled, backward compatibility with DomainKeys (RFC4870) key
## records is enabled. Otherwise, such key records are considered to be
## syntactically invalid.

# DomainKeysCompat no

## DontSignMailTo dataset
## default (none)
##
## Gives a list of recipient addresses or address patterns whose mail should
## not be signed.

# DontSignMailTo addr1,addr2,...

## EnableCoredumps { yes | no }
## default "no"
##
## On systems which have support for such, requests that the kernel dump
## core even though the process may change user ID during its execution.

# EnableCoredumps no

## ExemptDomains dataset
## default (none)
##
## A data set of domain names that are checked against the message sender's
## domain. If a match is found, the message is ignored by the filter.

# ExemptDomains domain1,domain2,...

## ExternalIgnoreList filename
##
## Names a file from which a list of externally-trusted hosts is read.
## These are hosts which are allowed to send mail through you for signing.
## Automatically contains 127.0.0.1. See man page for file format.

# ExternalIgnoreList filename
ExternalIgnoreList refile:/usr/local/etc/mail/opendkim.d/TrustedHosts

## FixCRLF { yes | no }
##
## Requests that the library convert "naked" CR and LF characters to
## CRLFs during canonicalization. The default is "no".

# FixCRLF no

## IgnoreMalformedMail { yes | no }
## default "no"
##
## Silently passes malformed messages without alteration. This includes
## messages that fail the RequiredHeaders check, if enabled. The default is
## to pass those messages but add an Authentication-Results field indicating
## that they were malformed.

# IgnoreMalformedMail no

## InternalHosts dataset
## default "127.0.0.1"
##
## Names a file from which a list of internal hosts is read. These are
## hosts from which mail should be signed rather than verified.
## Automatically contains 127.0.0.1.

# InternalHosts dataset
InternalHosts refile:/usr/local/etc/mail/opendkim.d/TrustedHosts

## KeepTemporaryFiles { yes | no }
## default "no"
##
## If set, causes temporary files generated during message signing or
## verifying to be left behind for debugging use. Not for normal operation;
## can fill your disks quite fast on busy systems.

# KeepTemporaryFiles no

## KeyFile filename
## default (none)
##
## Specifies the path to the private key to use when signing. Ignored if
## SigningTable and KeyTable are used. No default; must be specified for
## signing if SigningTable/KeyTable are not in use.

# KeyFile /var/db/dkim/example.private

## KeyTable dataset
## default (none)
##
## Defines a table that will be queried to convert key names to
## sets of data of the form (signing domain, signing selector, private key).
## The private key can either contain a PEM-formatted private key,
## a base64-encoded DER format private key, or a path to a file containing
## one of those.

# KeyTable dataset
KeyTable /usr/local/etc/mail/opendkim.d/KeyTable

## LogWhy { yes | no }
## default "no"
##
## If logging is enabled (see Syslog below), issues very detailed logging
## about the logic behind the filter's decision to either sign a message
## or verify it. The logic behind the decision is non-trivial and can be
## confusing to administrators not familiar with its operation. A
## description of how the decision is made can be found in the OPERATIONS
## section of the opendkim(8) man page. This causes a large increase
## in the amount of log data generated for each message, so it should be
## limited to debugging use and not enabled for general operation.

# LogWhy no
LogWhy yes

## MacroList macro[=value][,...]
##
## Gives a set of MTA-provided macros which should be checked to see
## if the sender has been determined to be a local user and therefore
## whether or not signing should be done. See opendkim.conf(5) for
## more information.

# MacroList foo=bar,baz=blivit

## MaximumHeaders n
##
## Disallow messages whose header blocks are bigger than "n" bytes.
## Intended to detect and block a denial-of-service attack. The default
## is 65536. A value of 0 disables this test.

# MaximumHeaders n

## MaximumSignaturesToVerify n
## (default 3)
##
## Verify no more than "n" signatures on an arriving message.
## A value of 0 means "no limit".

# MaximumSignaturesToVerify n

## MaximumSignedBytes n
##
## Don't sign more than "n" bytes of the message. The default is to
## sign the entire message. Setting this implies "BodyLengths".

# MaximumSignedBytes n

## MilterDebug n
##
## Request a debug level of "n" from the milter library. The default is 0.

# MilterDebug 0

## Minimum n[% | +]
## default 0
##
## Sets a minimum signing volume; one of the following formats:
## n at least n bytes (or the whole message, whichever is less)
## must be signed
## n% at least n% of the message must be signed
## n+ if a length limit was presented in the signature, no more than
## n bytes may have been added

# Minimum n

## MinimumKeyBits n
## default 1024
##
## Causes the library not to accept signatures matching keys made of fewer
## than the specified number of bits, even if they would otherwise pass
## DKIM signing.

# MinimumKeyBits 1024
MinimumKeyBits 1024

## Mode [sv]
## default sv
##
## Indicates which mode(s) of operation should be provided. "s" means
## "sign", "v" means "verify".

# Mode sv
Mode sv

## MTA dataset
## default (none)
##
## Specifies a list of MTAs whos mail should always be signed rather than
## verified. The "mtaname" is extracted from the DaemonPortOptions line
## in effect.

# MTA name

## MultipleSignatures { yes | no }
## default no
##
## Allows multiple signatures to be added. If set to "true" and a SigningTable
## is in use, all SigningTable entries that match the candidate message will
## cause a signature to be added. Otherwise, only the first matching
## SigningTable entry will be added, or only the key defined by Domain,
## Selector and KeyFile will be added.

# MultipleSignatures no

## MustBeSigned dataset
## default (none)
##
## Defines a list of headers which, if present on a message, must be
## signed for the signature to be considered acceptable.

# MustBeSigned header1,header2,...

## Nameservers addr1[,addr2[,...]]
## default (none)
##
## Provides a comma-separated list of IP addresses that are to be used when
## doing DNS queries to retrieve DKIM keys, VBR records, etc.
## These override any local defaults built in to the resolver in use, which
## may be defined in /etc/resolv.conf or hard-coded into the software.

# Nameservers addr1,addr2,...

## NoHeaderB { yes | no }
## default "no"
##
## Suppresses addition of "header.b" tags on Authentication-Results
## header fields.

# NoHeaderB no

## OmitHeaders dataset
## default (none)
##
## Specifies a list of headers that should always be omitted when signing.
## Header names should be separated by commas.

# OmitHeaders header1,header2,...

## On-...
##
## Specifies what to do when certain error conditions are encountered.
##
## See opendkim.conf(5) for more information.

# On-Default
# On-BadSignature
# On-DNSError
# On-InternalError
# On-NoSignature
# On-Security
# On-SignatureError

## OversignHeaders dataset
## default (none)
##
## Specifies a set of header fields that should be included in all signature
## header lists (the "h=" tag) once more than the number of times they were
## actually present in the signed message. See opendkim.conf(5) for more
## information.

# OverSignHeaders header1,header2,...

## PeerList dataset
## default (none)
##
## Contains a list of IP addresses, CIDR blocks, hostnames or domain names
## whose mail should be neither signed nor verified by this filter. See man
## page for file format.

# PeerList filename

## PidFile filename
## default (none)
##
## Name of the file where the filter should write its pid before beginning
## normal operations.

# PidFile filename
PidFile /var/run/milteropendkim/opendkim.pid

## POPDBFile dataset
## default (none)
##
## Names a database which should be checked for "POP before SMTP" records
## as a form of authentication of users who may be sending mail through
## the MTA for signing. Requires special compilation of the filter.
## See opendkim.conf(5) for more information.

# POPDBFile filename

## Quarantine { yes | no }
## default "no"
##
## Indicates whether or not the filter should arrange to quarantine mail
## which fails verification. Intended for diagnostic use only.

# Quarantine No

## QueryCache { yes | no }
## default "no"
##
## Instructs the DKIM library to maintain its own local cache of keys and
## policies retrieved from DNS, rather than relying on the nameserver for
## caching service. Useful if the nameserver being used by the filter is
## not local. The filter must be compiled with the QUERY_CACHE flag to enable
## this feature, since it adds a library dependency.

# QueryCache No

## RedirectFailuresTo address
## default (none)
##
## Redirects signed messages to the specified address if none of the
## signatures present failed to verify.

# RedirectFailuresTo postmaster@example.com

## RemoveARAll { yes | no }
## default "no"
##
## Remove all Authentication-Results: headers on all arriving mail.

# RemoveARAll No

## RemoveARFrom dataset
## default (none)
##
## Remove all Authentication-Results: headers on all arriving mail that
## claim to have been added by hosts listed in this parameter. The list
## should be comma-separated. Entire domains may be specified by preceding
## the dopmain name by a single dot (".") character.

# RemoveARFrom host1,host2,.domain1,.domain2,...

## RemoveOldSignatures { yes | no }
## default "no"
##
## Remove old signatures on messages, if any, when generating a signature.

# RemoveOldSignatures No

## ReportAddress addr
## default (executing user)@(hostname)
##
## Specifies the sending address to be used on From: headers of outgoing
## failure reports. By default, the e-mail address of the user executing
## the filter is used.

# ReportAddress "DKIM Error Postmaster" <postmaster@example.com>

## ReportBccAddress addr
## default (none)
##
## Specifies additional recipient address(es) to receive outgoing failure
## reports.

# ReportBccAddress postmaster@example.com, john@example.com

## RequiredHeaders { yes | no }
## default no
##
## Rejects messages which don't conform to RFC5322 header count requirements.

# RequiredHeaders No

## RequireSafeKeys { yes | no }
## default yes
##
## Refuses to use key files that appear to have unsafe permissions.

# RequireSafeKeys Yes

## ResignAll { yes | no }
## default no
##
## Where ResignMailTo triggers a re-signing action, this flag indicates
## whether or not all mail should be signed (if set) versus only verified
## mail being signed (if not set).

# ResignAll No

## ResignMailTo dataset
## default (none)
##
## Checks each message recipient against the specified dataset for a
## matching record. The full address is checked in each case, then the
## hostname, then each domain preceded by ".". If there is a match, the
## value returned is presumed to be the name of a key in the KeyTable
## (if defined) to be used to re-sign the message in addition to
## verifying it. If there is a match without a KeyTable, the default key
## is applied.

# ResignMailTo dataset

## ResolverConfiguration string
##
## Passes arbitrary configuration data to the resolver. For the stock UNIX
## resolver, this is ignored; for Unbound, it names a resolv.conf(5)-style
## file that should be read for configuration information.

# ResolverConfiguration string

## ResolverTracing { yes | no }
##
## Requests enabling of resolver trace features, if available. The effect
## of setting this flag depends on how trace features, if any, are implemented
## in the resolver in use. Currently only effective when used with the
## OpenDKIM asynchronous resolver.

# ResolverTracing no

## Selector name
##
## The name of the selector to use when signing. No default; must be
## specified for signing.

# Selector my-selector-name
Selector default

## SenderHeaders dataset
## default (none)
##
## Overrides the default list of headers that will be used to determine
## the sending domain when deciding whether to sign the message and with
## with which key(s). See opendkim.conf(5) for details.

# SenderHeaders From

## SendReports { yes | no }
## default "no"
##
## Specifies whether or not the filter should generate report mail back
## to senders when verification fails and an address for such a purpose
## is provided. See opendkim.conf(5) for details.

# SendReports No
SendReports yes

## SignatureAlgorithm signalg
## default "rsa-sha256"
##
## Signature algorithm to use when generating signatures. Must be either
## "rsa-sha1" or "rsa-sha256".

# SignatureAlgorithm rsa-sha256
SignatureAlgorithm rsa-sha256

## SignatureTTL seconds
## default "0"
##
## Specifies the lifetime in seconds of signatures generated by the
## filter. A value of 0 means no expiration time is included in the
## signature.

# SignatureTTL 0

## SignHeaders dataset
## default (none)
##
## Specifies the list of headers which should be included when generating
## signatures. The string should be a comma-separated list of header names.
## See the opendkim.conf(5) man page for more information.

# SignHeaders header1,header2,...

## SigningTable dataset
## default (none)
##
## Defines a dataset that will be queried for the message sender's address
## to determine which private key(s) (if any) should be used to sign the
## message. The sender is determined from the value of the sender
## header fields as described with SenderHeaders above. The key for this
## lookup should be an address or address pattern that matches senders;
## see the opendkim.conf(5) man page for more information. The value
## of the lookup should return the name of a key found in the KeyTable
## that should be used to sign the message. If MultipleSignatures
## is set, all possible lookup keys will be attempted which may result
## in multiple signatures being applied.

# SigningTable filename
SigningTable refile:/usr/local/etc/mail/opendkim.d/SigningTable

## SingleAuthResult { yes | no}
## default "no"
##
## When DomainKeys verification is enabled, multiple Authentication-Results
## will be added, one for DK and one for DKIM. With this enabled, only
## a DKIM result will be reported unless DKIM failed but DK passed, in which
## case only a DK result will be reported.

# SingleAuthResult no

## SMTPURI uri
##
## Specifies a URI (e.g., "smtp://localhost") to which mail should be sent
## via SMTP when notifications are generated.

# Socket smtp://localhost

## Socket socketspec
##
## Names the socket where this filter should listen for milter connections
## from the MTA. Required. Should be in one of these forms:
##
## inet:port@address to listen on a specific interface
## inet:port to listen on all interfaces
## local:/path/to/socket to listen on a UNIX domain socket

#Socket inet:port@localhost
Socket local:/var/run/milteropendkim/milter-opendkim.sock

## SoftwareHeader { yes | no }
## default "no"
##
## Add a DKIM-Filter header field to messages passing through this filter
## to identify messages it has processed.

# SoftwareHeader no
SoftwareHeader yes

## StrictHeaders { yes | no }
## default "no"
##
## Requests that the DKIM library refuse to process a message whose
## header fields do not conform to the standards, in particular Section 3.6
## of RFC5322.

# StrictHeaders no

## StrictTestMode { yes | no }
## default "no"
##
## Selects strict CRLF mode during testing (see the "-t" command line
## flag in the opendkim(8) man page). Messages for which all header
## fields and body lines are not CRLF-terminated are considered malformed
## and will produce an error.

# StrictTestMode no

## SubDomains { yes | no }
## default "no"
##
## Sign for subdomains as well?

# SubDomains No

## Syslog { yes | no }
## default "yes"
##
## Log informational and error activity to syslog?

Syslog Yes

## SyslogFacility facility
## default "mail"
##
## Valid values are :
## auth cron daemon kern lpr mail news security syslog user uucp
## local0 local1 local2 local3 local4 local5 local6 local7
##
## syslog facility to be used

# SyslogFacility mail

## SyslogSuccess { yes | no }
## default "no"
##
## Log success activity to syslog?

# SyslogSuccess No
SyslogSuccess yes

## TemporaryDirectory path
## default /tmp
##
## Specifies which directory will be used for creating temporary files
## during message processing.

# TemporaryDirectory /tmp
TemporaryDirectory /var/tmp

## TestPublicKeys filename
## default (none)
##
## Names a file from which public keys should be read. Intended for use
## only during automated testing.

# TestPublicKeys /tmp/testkeys

## TrustAnchorFile filename
## default (none)
##
## Specifies a file from which trust anchor data should be read when doing
## DNS queries and applying the DNSSEC protocol. See the Unbound documentation
## at http://unbound.net for the expected format of this file.

# TrustAnchorFile /var/named/trustanchor

## UMask mask
## default (none)
##
## Change the process umask for file creation to the specified value.
## The system has its own default which will be used (usually 022).
## See the umask(2) man page for more information.

# UMask 022
UMask 002

# UnboundConfigFile /var/named/unbound.conf

## Userid userid
## default (none)
##
## Change to user "userid" before starting normal operation? May include
## a group ID as well, separated from the userid by a colon.

# UserID userid
UserID mailnull:mailnull
</pre>

Change directory to /var/db/dkim, where the key files will live. Create the domain-specific directories.

# cd /var/db/dkim/
# mkdir mail.celicas.org celicas.org crazycatgirl.com jksattic.com labrats.us movingtargetracing.com realautosport.com sstfsalon.com synapticflatulence.com

Generate the key files in the directories we just created. We will use 2048 bits. Default is 1024.

# opendkim-genkey -D /var/db/dkim/keys/mail.celicas.org -d mail.celicas.org -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/celicas.org -d celicas.org -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/crazycatgirl.com -d crazycatgirl.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/jksattic.com -d jksattic.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/labrats.us -d labrats.us -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/movingtargetracing.com -d movingtargetracing.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/realautosport.com -d realautosport.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/sstfsalon.com -d sstfsalon.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/synapticflatulence.com -d synapticflatulence.com -s default -b 2048

Change the ownership for all the directoried and key files, so DKIM can access them later.

# chown -R mailnull:mailnull /var/db/dkim/keys/*

View the contents of the public key files. We will need these for DNS zone files.

# cat /var/db/dkim/keys/*/default.txt

Change to the include directoy for OpenDKIM that we created above. We will edit the KEyTable, SigningTable and TrustedHosts files.

# cd /usr/local/etc/mail/opendkim.d/

# vi KeyTable

<pre>
OPENDKIM KEY TABLE
# To use this file, uncomment the #KeyTable option in /etc/opendkim.conf,
# then uncomment the following line and replace example.com with your domain
# name, then restart OpenDKIM. Additional keys may be added on separate lines.

#default._domainkey.example.com example.com:default:/etc/opendkim/keys/default.private
default._domainkey.mail.celicas.org mail.celicas.org:default:/var/db/dkim/keys/mail.celicas.org/default.private
default._domainkey.celicas.org celicas.org:default:/var/db/dkim/keys/celicas.org/default.private
default._domainkey.crazycatgirl.com crazycatgirl.com:default:/var/db/dkim/keys/crazycatgirl.com/default.private
default._domainkey.jksattic.com jksattic.com:default:/var/db/dkim/keys/jksattic.com/default.private
default._domainkey.labrats.us labrats.us:default:/var/db/dkim/keys/labrats.us/default.private
default._domainkey.movingtargetracing.com movingtargetracing.com:default:/var/db/dkim/keys/movingtargetracing.com/default.private
default._domainkey.realautosport.com realautosport.com:default:/var/db/dkim/keys/realautosport.com/default.private
default._domainkey.sstfsalon.com sstfsalon.com:default:/var/db/dkim/keys/sstfsalon.com/default.private
default._domainkey.synapticflatulence.com synapticflatulence.com:default:/var/db/dkim/keys/synapticflatulence.com/default.private
</pre>

# vi SigningTable

<pre>
# OPENDKIM SIGNING TABLE
# This table controls how to apply one or more signatures to outgoing messages based
# on the address found in the From: header field. In simple terms, this tells
# OpenDKIM "how" to apply your keys.

# To use this file, uncomment the SigningTable option in /etc/opendkim.conf,
# then uncomment one of the usage examples below and replace example.com with your
# domain name, then restart OpenDKIM.

# WILDCARD EXAMPLE
# Enables signing for any address on the listed domain(s), but will work only if
# "refile:/etc/opendkim/SigningTable" is included in /etc/opendkim.conf.
# Create additional lines for additional domains.

#*@example.com default._domainkey.example.com

# NON-WILDCARD EXAMPLE
# If "file:" (instead of "refile:") is specified in /etc/opendkim.conf, then
# wildcards will not work. Instead, full user@host is checked first, then simply host,
# then user@.domain (with all superdomains checked in sequence, so "foo.example.com"
# would first check "user@foo.example.com", then "user@.example.com", then "user@.com"),
# then .domain, then user@*, and finally *. See the opendkim.conf(5) man page under
# "SigningTable" for more details.

#example.com default._domainkey.example.com
*@mail.celicas.org default._domainkey.mail.celicas.org
*@celicas.org default._domainkey.celicas.org
*@crazycatgirl.com default._domainkey.crazycatgirl.com
*@jksattic.com default._domainkey.jksattic.com
*@labrats.us default._domainkey.labrats.us
*@movingtargetracing.com default._domainkey.movingtargetracing.com
*@realautosport.com default._domainkey.realautosport.com
*@sstfsalon.com default._domainkey.sstfsalon.com
*@synapticflatulence.com default._domainkey.synapticflatulence.com
</pre>

# vi TrustedHosts

<pre>
# OPENDKIM TRUSTED HOSTS
# To use this file, uncomment the #ExternalIgnoreList and/or the #InternalHosts
# option in /etc/opendkim.conf then restart OpenDKIM. Additional hosts
# may be added on separate lines (IP addresses, hostnames, or CIDR ranges).
# The localhost IP (127.0.0.1) should always be the first entry in this file.
127.0.0.1
::1
#host.example.com
#192.168.1.0/24
66.180.172.109
</pre>

Start milter-opendkim daemon, and more on the DNS configuration.

# service milter-opendkim start

Edit the DNS domains.

# cd /usr/local/etc/namedb/master/
# vi celicas.org.db crazycatgirl.com.db jksattic.com.db labrats.us.db movingtargetracing.com.db realautosport.com.db sstfsalon.com.db synapticflatulence.com.db

You will add something like this to the zone files, using the valued from the public keys you viewed above. Note, we used 2048, so they will be a bit longer.

<pre>
efault._domainkey IN TXT ( "v=DKIM1; k=rsa; "
"p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC+KQWYQZwNOGSuabgbIYt2haP7aK9K1QHB88jUN2ohZ66PLMu5A4d3jDwB+68joz8V4qy5XX/ik3LRJId+5YyNh+ThozwCvZtuyHi2L7Dcmg8p4J3m8h/vuZG2VmCP9IA9pcSFwJ0yMDoXJZQFCeexJ/YEB1lbua4oEcni9C03FwIDAQAB" ) ; ----- DKIM key default for thuinformatik.ch
</pre>

Restart / Reload Bind.

# rndc reload

Now we will dig against Google and verify that we get the public key back.

# dig TXT default._domainkey.jksattic.com +short @8.8.8.8
# dig TXT default._domainkey.labrats.us +short @8.8.8.8
# dig TXT default._domainkey.celicas.org +short @8.8.8.8
# dig TXT default._domainkey.crazycatgirl.com +short @8.8.8.8
# dig TXT default._domainkey.jksattic.com +short @8.8.8.8
# dig TXT default._domainkey.labrats.us +short @8.8.8.8
# dig TXT default._domainkey.mail.celicas.org +short @8.8.8.8
# dig TXT default._domainkey.movingtargetracing.com +short @8.8.8.8
# dig TXT default._domainkey.realautosport.com +short @8.8.8.8
# dig TXT default._domainkey.sstfsalon.com +short @8.8.8.8
# dig TXT default._domainkey.synapticflatulence.com +short @8.8.8.8

Not we will edit Sendmail to implement the milter for OpenDKIM

# cd /etc/mail
# cp -p netsonic-v1.movingtargetracing.com.mc{,.bak}
# vi netsonic-v1.movingtargetracing.com.mc

Note, this is an example, and I already had spamassassin and greylist milters installed. Just added dkim-milter.

<pre>
MAIL_FILTER(`dkim-filter', `S=/var/run/milteropendkim/milter-opendkim.sock, F=T, T=R:2m')
define(`confINPUT_MAIL_FILTERS', `spamassassin, greylist, dkim-filter')
</pre>
</pre>

Make the configuration file and make sure that it is linked to the active config.

# make
# rm sendmail.cf
# ln -s netsonic-v1.movingtargetracing.com.cf sendmail.cf
# service sendmail restart

Sendmail is now running with DKIM signing and validation. Look at the log files, emails and online resources to verify that it is working.

User:Sfiggins/FreeBSD Sendmail with DKIM

2024-04-03T03:13:14Z

Sfiggins:

Using the following Links as references:

https://alfaexploit.com/en/posts/sendmail_dovecot_spamassassin_rainloop_sieve_opendkim_spf_dmarc_on_freebsd/

https://www.web-workers.ch/index.php/2019/10/21/how-to-configure-dkim-spf-dmarc-on-sendmail-for-multiple-domains-on-centos-7/

Install OpenDKIM from the FreeBSD Package manager, set it to enable, and change ownership of the run directory, which will contain the PID and socket files.

# pkg install opendkim
# sysrc milteropendkim_enable=yes
# chown mailnull:mailnull /var/run/milteropendkim/

Change directory to the /usr/local/etc/mail directory, where the OpenDKIM configuration lived. Create a subdirectory for include files and edit the main file.

# cd /usr/local/etc/mail/
# mkdir opendkim.d
# vi opendkim.conf

Example of opendkim.conf file:

<pre>
##
## opendkim.conf -- configuration file for OpenDKIM filter
##
## Copyright (c) 2010-2015, The Trusted Domain Project. All rights reserved.
##

##
## For settings that refer to a "dataset", see the opendkim(8) man page.
##

## DEPRECATED CONFIGURATION OPTIONS
##
## The following configuration options are no longer valid. They should be
## removed from your existing configuration file to prevent potential issues.
## Failure to do so may result in opendkim being unable to start.
##
## Removed in 2.10.0:
## AddAllSignatureResults
## ADSPAction
## ADSPNoSuchDomain
## BogusPolicy
## DisableADSP
## LDAPSoftStart
## LocalADSP
## NoDiscardableMailTo
## On-PolicyError
## SendADSPReports
## UnprotectedPolicy

## CONFIGURATION OPTIONS

## AllowSHA1Only { yes | no }
## default "no"
##
## By default, the filter will refuse to start if support for SHA256 is
## not available since this violates the strong recommendations of
## RFC6376 Section 3.3, which says:
##
## "Verifiers MUST implement both rsa-sha1 and rsa-sha256. Signers MUST
## implement and SHOULD sign using rsa-sha256."
##
## This forces that violation to be explicitly selected by the administrator.

# AllowSHA1Only no

## AlwaysAddARHeader { yes | no }
## default "no"
##
## Add an "Authentication-Results:" header even to unsigned messages
## from domains with no "signs all" policy. The reported DKIM result
## will be "none" in such cases. Normally unsigned mail from non-strict
## domains does not cause the results header to be added.

# AlwaysAddARHeader no

## AuthservID string
## default (local host name)
##
## Defines the "authserv-id" token to be used when generating
## Authentication-Results headers after message verification.

# AuthservID example.com

## AuthservIDWithJobID
## default "no"
##
## Appends a "/" followed by the MTA's job ID to the "authserv-id" token
## when generating Authentication-Results headers after message verification.

# AuthservIDWithJobId no

## AutoRestart { yes | no }
## default "no"
##
## Indicate whether or not the filter should arrange to restart automatically
## if it crashes.

# AutoRestart No
AutoRestart yes

## AutoRestartCount n
## default 0
##
## Sets the maximum automatic restart count. After this number of
## automatic restarts, the filter will give up and terminate. A value of 0
## implies no limit.

# AutoRestartCount 0

## AutoRestartRate n/t[u]
## default (none)
##
## Sets the maximum automatic restart rate. See the opendkim.conf(5)
## man page for the format of this parameter.

# AutoRestartRate n/tu
AutoRestartRate 10/1h

## Background { yes | no }
## default "yes"
##
## Indicate whether or not the filter should run in the background.

# Background Yes

## BaseDirectory path
## default (none)
##
## Causes the filter to change to the named directory before beginning
## operation. Thus, cores will be dumped here and configuration files
## are read relative to this location.

# BaseDirectory /var/run/opendkim

## BodyLengthDB dataset
## default (none)
##
## A data set that is checked against envelope recipients to see if a
## body length tag should be included in the generated signature.
## This has security implications; see opendkim.conf(5) for details.

# BodyLengthDB dataset

## Canonicalization hdrcanon[/bodycanon]
## default "simple/simple"
##
## Select canonicalizations to use when signing. If the "bodycanon" is
## omitted, "simple" is used. Valid values for each are "simple" and
## "relaxed".

# Canonicalization simple/simple
Canonicalization relaxed/simple

## ClockDrift n
## default 300
##
## Specify the tolerance range for expired signatures or signatures
## which appear to have timestamps in the future, allowing for clock
## drift.

# ClockDrift 300

## Diagnostics { yes | no }
## default "no"
##
## Specifies whether or not signatures with header diagnostic tags should
## be generated.

# Diagnostics No

## DNSTimeout n
## default 10
##
## Specify the time in seconds to wait for replies from the nameserver when
## requesting keys or signing policies.

# DNSTimeout 10

## Domain dataset
## default (none)
##
## Specify for which domain(s) signing should be done. No default; must
## be specified for signing.

Domain example.com

## DomainKeysCompat { yes | no }
## default "no"
##
## When enabled, backward compatibility with DomainKeys (RFC4870) key
## records is enabled. Otherwise, such key records are considered to be
## syntactically invalid.

# DomainKeysCompat no

## DontSignMailTo dataset
## default (none)
##
## Gives a list of recipient addresses or address patterns whose mail should
## not be signed.

# DontSignMailTo addr1,addr2,...

## EnableCoredumps { yes | no }
## default "no"
##
## On systems which have support for such, requests that the kernel dump
## core even though the process may change user ID during its execution.

# EnableCoredumps no

## ExemptDomains dataset
## default (none)
##
## A data set of domain names that are checked against the message sender's
## domain. If a match is found, the message is ignored by the filter.

# ExemptDomains domain1,domain2,...

## ExternalIgnoreList filename
##
## Names a file from which a list of externally-trusted hosts is read.
## These are hosts which are allowed to send mail through you for signing.
## Automatically contains 127.0.0.1. See man page for file format.

# ExternalIgnoreList filename
ExternalIgnoreList refile:/usr/local/etc/mail/opendkim.d/TrustedHosts

## FixCRLF { yes | no }
##
## Requests that the library convert "naked" CR and LF characters to
## CRLFs during canonicalization. The default is "no".

# FixCRLF no

## IgnoreMalformedMail { yes | no }
## default "no"
##
## Silently passes malformed messages without alteration. This includes
## messages that fail the RequiredHeaders check, if enabled. The default is
## to pass those messages but add an Authentication-Results field indicating
## that they were malformed.

# IgnoreMalformedMail no

## InternalHosts dataset
## default "127.0.0.1"
##
## Names a file from which a list of internal hosts is read. These are
## hosts from which mail should be signed rather than verified.
## Automatically contains 127.0.0.1.

# InternalHosts dataset
InternalHosts refile:/usr/local/etc/mail/opendkim.d/TrustedHosts

## KeepTemporaryFiles { yes | no }
## default "no"
##
## If set, causes temporary files generated during message signing or
## verifying to be left behind for debugging use. Not for normal operation;
## can fill your disks quite fast on busy systems.

# KeepTemporaryFiles no

## KeyFile filename
## default (none)
##
## Specifies the path to the private key to use when signing. Ignored if
## SigningTable and KeyTable are used. No default; must be specified for
## signing if SigningTable/KeyTable are not in use.

# KeyFile /var/db/dkim/example.private

## KeyTable dataset
## default (none)
##
## Defines a table that will be queried to convert key names to
## sets of data of the form (signing domain, signing selector, private key).
## The private key can either contain a PEM-formatted private key,
## a base64-encoded DER format private key, or a path to a file containing
## one of those.

# KeyTable dataset
KeyTable /usr/local/etc/mail/opendkim.d/KeyTable

## LogWhy { yes | no }
## default "no"
##
## If logging is enabled (see Syslog below), issues very detailed logging
## about the logic behind the filter's decision to either sign a message
## or verify it. The logic behind the decision is non-trivial and can be
## confusing to administrators not familiar with its operation. A
## description of how the decision is made can be found in the OPERATIONS
## section of the opendkim(8) man page. This causes a large increase
## in the amount of log data generated for each message, so it should be
## limited to debugging use and not enabled for general operation.

# LogWhy no
LogWhy yes

## MacroList macro[=value][,...]
##
## Gives a set of MTA-provided macros which should be checked to see
## if the sender has been determined to be a local user and therefore
## whether or not signing should be done. See opendkim.conf(5) for
## more information.

# MacroList foo=bar,baz=blivit

## MaximumHeaders n
##
## Disallow messages whose header blocks are bigger than "n" bytes.
## Intended to detect and block a denial-of-service attack. The default
## is 65536. A value of 0 disables this test.

# MaximumHeaders n

## MaximumSignaturesToVerify n
## (default 3)
##
## Verify no more than "n" signatures on an arriving message.
## A value of 0 means "no limit".

# MaximumSignaturesToVerify n

## MaximumSignedBytes n
##
## Don't sign more than "n" bytes of the message. The default is to
## sign the entire message. Setting this implies "BodyLengths".

# MaximumSignedBytes n

## MilterDebug n
##
## Request a debug level of "n" from the milter library. The default is 0.

# MilterDebug 0

## Minimum n[% | +]
## default 0
##
## Sets a minimum signing volume; one of the following formats:
## n at least n bytes (or the whole message, whichever is less)
## must be signed
## n% at least n% of the message must be signed
## n+ if a length limit was presented in the signature, no more than
## n bytes may have been added

# Minimum n

## MinimumKeyBits n
## default 1024
##
## Causes the library not to accept signatures matching keys made of fewer
## than the specified number of bits, even if they would otherwise pass
## DKIM signing.

# MinimumKeyBits 1024
MinimumKeyBits 1024

## Mode [sv]
## default sv
##
## Indicates which mode(s) of operation should be provided. "s" means
## "sign", "v" means "verify".

# Mode sv
Mode sv

## MTA dataset
## default (none)
##
## Specifies a list of MTAs whos mail should always be signed rather than
## verified. The "mtaname" is extracted from the DaemonPortOptions line
## in effect.

# MTA name

## MultipleSignatures { yes | no }
## default no
##
## Allows multiple signatures to be added. If set to "true" and a SigningTable
## is in use, all SigningTable entries that match the candidate message will
## cause a signature to be added. Otherwise, only the first matching
## SigningTable entry will be added, or only the key defined by Domain,
## Selector and KeyFile will be added.

# MultipleSignatures no

## MustBeSigned dataset
## default (none)
##
## Defines a list of headers which, if present on a message, must be
## signed for the signature to be considered acceptable.

# MustBeSigned header1,header2,...

## Nameservers addr1[,addr2[,...]]
## default (none)
##
## Provides a comma-separated list of IP addresses that are to be used when
## doing DNS queries to retrieve DKIM keys, VBR records, etc.
## These override any local defaults built in to the resolver in use, which
## may be defined in /etc/resolv.conf or hard-coded into the software.

# Nameservers addr1,addr2,...

## NoHeaderB { yes | no }
## default "no"
##
## Suppresses addition of "header.b" tags on Authentication-Results
## header fields.

# NoHeaderB no

## OmitHeaders dataset
## default (none)
##
## Specifies a list of headers that should always be omitted when signing.
## Header names should be separated by commas.

# OmitHeaders header1,header2,...

## On-...
##
## Specifies what to do when certain error conditions are encountered.
##
## See opendkim.conf(5) for more information.

# On-Default
# On-BadSignature
# On-DNSError
# On-InternalError
# On-NoSignature
# On-Security
# On-SignatureError

## OversignHeaders dataset
## default (none)
##
## Specifies a set of header fields that should be included in all signature
## header lists (the "h=" tag) once more than the number of times they were
## actually present in the signed message. See opendkim.conf(5) for more
## information.

# OverSignHeaders header1,header2,...

## PeerList dataset
## default (none)
##
## Contains a list of IP addresses, CIDR blocks, hostnames or domain names
## whose mail should be neither signed nor verified by this filter. See man
## page for file format.

# PeerList filename

## PidFile filename
## default (none)
##
## Name of the file where the filter should write its pid before beginning
## normal operations.

# PidFile filename
PidFile /var/run/milteropendkim/opendkim.pid

## POPDBFile dataset
## default (none)
##
## Names a database which should be checked for "POP before SMTP" records
## as a form of authentication of users who may be sending mail through
## the MTA for signing. Requires special compilation of the filter.
## See opendkim.conf(5) for more information.

# POPDBFile filename

## Quarantine { yes | no }
## default "no"
##
## Indicates whether or not the filter should arrange to quarantine mail
## which fails verification. Intended for diagnostic use only.

# Quarantine No

## QueryCache { yes | no }
## default "no"
##
## Instructs the DKIM library to maintain its own local cache of keys and
## policies retrieved from DNS, rather than relying on the nameserver for
## caching service. Useful if the nameserver being used by the filter is
## not local. The filter must be compiled with the QUERY_CACHE flag to enable
## this feature, since it adds a library dependency.

# QueryCache No

## RedirectFailuresTo address
## default (none)
##
## Redirects signed messages to the specified address if none of the
## signatures present failed to verify.

# RedirectFailuresTo postmaster@example.com

## RemoveARAll { yes | no }
## default "no"
##
## Remove all Authentication-Results: headers on all arriving mail.

# RemoveARAll No

## RemoveARFrom dataset
## default (none)
##
## Remove all Authentication-Results: headers on all arriving mail that
## claim to have been added by hosts listed in this parameter. The list
## should be comma-separated. Entire domains may be specified by preceding
## the dopmain name by a single dot (".") character.

# RemoveARFrom host1,host2,.domain1,.domain2,...

## RemoveOldSignatures { yes | no }
## default "no"
##
## Remove old signatures on messages, if any, when generating a signature.

# RemoveOldSignatures No

## ReportAddress addr
## default (executing user)@(hostname)
##
## Specifies the sending address to be used on From: headers of outgoing
## failure reports. By default, the e-mail address of the user executing
## the filter is used.

# ReportAddress "DKIM Error Postmaster" <postmaster@example.com>

## ReportBccAddress addr
## default (none)
##
## Specifies additional recipient address(es) to receive outgoing failure
## reports.

# ReportBccAddress postmaster@example.com, john@example.com

## RequiredHeaders { yes | no }
## default no
##
## Rejects messages which don't conform to RFC5322 header count requirements.

# RequiredHeaders No

## RequireSafeKeys { yes | no }
## default yes
##
## Refuses to use key files that appear to have unsafe permissions.

# RequireSafeKeys Yes

## ResignAll { yes | no }
## default no
##
## Where ResignMailTo triggers a re-signing action, this flag indicates
## whether or not all mail should be signed (if set) versus only verified
## mail being signed (if not set).

# ResignAll No

## ResignMailTo dataset
## default (none)
##
## Checks each message recipient against the specified dataset for a
## matching record. The full address is checked in each case, then the
## hostname, then each domain preceded by ".". If there is a match, the
## value returned is presumed to be the name of a key in the KeyTable
## (if defined) to be used to re-sign the message in addition to
## verifying it. If there is a match without a KeyTable, the default key
## is applied.

# ResignMailTo dataset

## ResolverConfiguration string
##
## Passes arbitrary configuration data to the resolver. For the stock UNIX
## resolver, this is ignored; for Unbound, it names a resolv.conf(5)-style
## file that should be read for configuration information.

# ResolverConfiguration string

## ResolverTracing { yes | no }
##
## Requests enabling of resolver trace features, if available. The effect
## of setting this flag depends on how trace features, if any, are implemented
## in the resolver in use. Currently only effective when used with the
## OpenDKIM asynchronous resolver.

# ResolverTracing no

## Selector name
##
## The name of the selector to use when signing. No default; must be
## specified for signing.

# Selector my-selector-name
Selector default

## SenderHeaders dataset
## default (none)
##
## Overrides the default list of headers that will be used to determine
## the sending domain when deciding whether to sign the message and with
## with which key(s). See opendkim.conf(5) for details.

# SenderHeaders From

## SendReports { yes | no }
## default "no"
##
## Specifies whether or not the filter should generate report mail back
## to senders when verification fails and an address for such a purpose
## is provided. See opendkim.conf(5) for details.

# SendReports No
SendReports yes

## SignatureAlgorithm signalg
## default "rsa-sha256"
##
## Signature algorithm to use when generating signatures. Must be either
## "rsa-sha1" or "rsa-sha256".

# SignatureAlgorithm rsa-sha256
SignatureAlgorithm rsa-sha256

## SignatureTTL seconds
## default "0"
##
## Specifies the lifetime in seconds of signatures generated by the
## filter. A value of 0 means no expiration time is included in the
## signature.

# SignatureTTL 0

## SignHeaders dataset
## default (none)
##
## Specifies the list of headers which should be included when generating
## signatures. The string should be a comma-separated list of header names.
## See the opendkim.conf(5) man page for more information.

# SignHeaders header1,header2,...

## SigningTable dataset
## default (none)
##
## Defines a dataset that will be queried for the message sender's address
## to determine which private key(s) (if any) should be used to sign the
## message. The sender is determined from the value of the sender
## header fields as described with SenderHeaders above. The key for this
## lookup should be an address or address pattern that matches senders;
## see the opendkim.conf(5) man page for more information. The value
## of the lookup should return the name of a key found in the KeyTable
## that should be used to sign the message. If MultipleSignatures
## is set, all possible lookup keys will be attempted which may result
## in multiple signatures being applied.

# SigningTable filename
SigningTable refile:/usr/local/etc/mail/opendkim.d/SigningTable

## SingleAuthResult { yes | no}
## default "no"
##
## When DomainKeys verification is enabled, multiple Authentication-Results
## will be added, one for DK and one for DKIM. With this enabled, only
## a DKIM result will be reported unless DKIM failed but DK passed, in which
## case only a DK result will be reported.

# SingleAuthResult no

## SMTPURI uri
##
## Specifies a URI (e.g., "smtp://localhost") to which mail should be sent
## via SMTP when notifications are generated.

# Socket smtp://localhost

## Socket socketspec
##
## Names the socket where this filter should listen for milter connections
## from the MTA. Required. Should be in one of these forms:
##
## inet:port@address to listen on a specific interface
## inet:port to listen on all interfaces
## local:/path/to/socket to listen on a UNIX domain socket

#Socket inet:port@localhost
Socket local:/var/run/milteropendkim/milter-opendkim.sock

## SoftwareHeader { yes | no }
## default "no"
##
## Add a DKIM-Filter header field to messages passing through this filter
## to identify messages it has processed.

# SoftwareHeader no
SoftwareHeader yes

## StrictHeaders { yes | no }
## default "no"
##
## Requests that the DKIM library refuse to process a message whose
## header fields do not conform to the standards, in particular Section 3.6
## of RFC5322.

# StrictHeaders no

## StrictTestMode { yes | no }
## default "no"
##
## Selects strict CRLF mode during testing (see the "-t" command line
## flag in the opendkim(8) man page). Messages for which all header
## fields and body lines are not CRLF-terminated are considered malformed
## and will produce an error.

# StrictTestMode no

## SubDomains { yes | no }
## default "no"
##
## Sign for subdomains as well?

# SubDomains No

## Syslog { yes | no }
## default "yes"
##
## Log informational and error activity to syslog?

Syslog Yes

## SyslogFacility facility
## default "mail"
##
## Valid values are :
## auth cron daemon kern lpr mail news security syslog user uucp
## local0 local1 local2 local3 local4 local5 local6 local7
##
## syslog facility to be used

# SyslogFacility mail

## SyslogSuccess { yes | no }
## default "no"
##
## Log success activity to syslog?

# SyslogSuccess No
SyslogSuccess yes

## TemporaryDirectory path
## default /tmp
##
## Specifies which directory will be used for creating temporary files
## during message processing.

# TemporaryDirectory /tmp
TemporaryDirectory /var/tmp

## TestPublicKeys filename
## default (none)
##
## Names a file from which public keys should be read. Intended for use
## only during automated testing.

# TestPublicKeys /tmp/testkeys

## TrustAnchorFile filename
## default (none)
##
## Specifies a file from which trust anchor data should be read when doing
## DNS queries and applying the DNSSEC protocol. See the Unbound documentation
## at http://unbound.net for the expected format of this file.

# TrustAnchorFile /var/named/trustanchor

## UMask mask
## default (none)
##
## Change the process umask for file creation to the specified value.
## The system has its own default which will be used (usually 022).
## See the umask(2) man page for more information.

# UMask 022
UMask 002

# UnboundConfigFile /var/named/unbound.conf

## Userid userid
## default (none)
##
## Change to user "userid" before starting normal operation? May include
## a group ID as well, separated from the userid by a colon.

# UserID userid
UserID mailnull:mailnull
</pre>

# cd /var/db/dkim/
# mkdir mail.celicas.org celicas.org crazycatgirl.com jksattic.com labrats.us movingtargetracing.com realautosport.com sstfsalon.com synapticflatulence.com

# opendkim-genkey -D /var/db/dkim/keys/mail.celicas.org -d mail.celicas.org -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/celicas.org -d celicas.org -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/crazycatgirl.com -d crazycatgirl.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/jksattic.com -d jksattic.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/labrats.us -d labrats.us -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/movingtargetracing.com -d movingtargetracing.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/realautosport.com -d realautosport.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/sstfsalon.com -d sstfsalon.com -s default -b 2048
# opendkim-genkey -D /var/db/dkim/keys/synapticflatulence.com -d synapticflatulence.com -s default -b 2048

# chown -R mailnull:mailnull /var/db/dkim/keys/*
# cat /var/db/dkim/keys/*/default.txt

# cd /usr/local/etc/mail/opendkim.d/

# vi KeyTable
# vi SigningTable
# vi TrustedHosts

# service milter-opendkim start

# cd /usr/local/etc/namedb/master/
# vi celicas.org.db crazycatgirl.com.db jksattic.com.db labrats.us.db movingtargetracing.com.db realautosport.com.db sstfsalon.com.db synapticflatulence.com.db
# rndc reload

# dig TXT default._domainkey.jksattic.com +short @8.8.8.8
# dig TXT default._domainkey.labrats.us +short @8.8.8.8
# dig TXT default._domainkey.celicas.org +short @8.8.8.8
# dig TXT default._domainkey.crazycatgirl.com +short @8.8.8.8
# dig TXT default._domainkey.jksattic.com +short @8.8.8.8
# dig TXT default._domainkey.labrats.us +short @8.8.8.8
# dig TXT default._domainkey.mail.celicas.org +short @8.8.8.8
# dig TXT default._domainkey.movingtargetracing.com +short @8.8.8.8
# dig TXT default._domainkey.realautosport.com +short @8.8.8.8
# dig TXT default._domainkey.sstfsalon.com +short @8.8.8.8
# dig TXT default._domainkey.synapticflatulence.com +short @8.8.8.8

# cd /etc/mail
# cp -p netsonic-v1.movingtargetracing.com.mc{,.bak}
# vi netsonic-v1.movingtargetracing.com.mc
# make
# rm sendmail.cf
# ln -s netsonic-v1.movingtargetracing.com.cf sendmail.cf
# service sendmail restart

User:Sfiggins/FreeBSD Sendmail with DKIM

2024-04-03T03:05:33Z

Sfiggins:

User:Sfiggins/FreeBSD Sendmail with DKIM

2024-04-03T02:46:59Z

Sfiggins: Created page with "Using the following Links as references: https://alfaexploit.com/en/posts/sendmail_dovecot_spamassassin_rainloop_sieve_opendkim_spf_dmarc_on_freebsd/ https://www.web-workers..."

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T23:38:54Z

Sfiggins: /* vCenter / ESXi - Verify disk location */

= Instructions on how to restore from NetApp Snapshot for ESXi machines =

== Basic Information ==

=== Helper Virtual Machines ===

These are machines that you will need to get into in order to validate the snapshots and file paths. ESXi / vCenter datastore browser hides certain files, so you need to know the exact file structure and path on order to restore.

<pre>
Denver - 10.255.6.228
Dallas - 10.255.8.228
</pre>

=== NetApp Filers ===

These are the administrative consoles for the NetApps. You can connect tot he Web UI for verifying some information, but you will need to SSH to the console (CLI) in order to perform restoration from snapshots.

<pre>
DEN1-AFF220 - 10.255.6.223
DAL1-AFF220 - 10.255.8.223
</pre>

=== NetApp vServers ===

Each NetApp has a number of vServers associated with it. In order to restore, you will need to know what vServer you are restoring from.

<pre>
DEN1-AFF220::> vserver show
Admin Operational Root
Vserver Type Subtype State State Volume Aggregate
----------- ------- ---------- ---------- ----------- ---------- ----------
AFF220-01 node - - - - -
AFF220-02 node - - - - -
DEN-SYSLOG data default running running DENSYSLOG_ cifs_
root datastore_
1
DEN1-AFF220 admin - - - - -
DEN1-VCIFS2 data default running running DEN1VCIFS2 cifs_
_root datastore_
1
DEN1-VFILER-1
data default running running DEN1VFILER cifs_
1_root datastore_
1
iscsi data default running running iscsi_root iscsi_
datastore_
2
7 entries were displayed.

</pre>

For vSphere hosts, this will be the following vServers, however these instructions would be valid for other vServers outside of sSphere.

<pre>
Denver - DEN1-VFILER-1
Dallas - DAL-VFILER-1
</pre>

NOTE: Dallas and Denver naming formats are slightly different in this case, so verify that you have the correct vServer before continuing.

=== NetApp Volumes ===

You can get this from vCenter, however it is usually a good idea to validate the volumes on the NetApp filer.

<pre>
DEN1-AFF220::> volume show -vserver DEN1-VFILER-1
Vserver Volume Aggregate State Type Size Available Used%
--------- ------------ ------------ ---------- ---- ---------- ---------- -----
DEN1-VFILER-1
DEN1VFILER1_root
cifs_datastore_1
online RW 1GB 971.8MB 0%
DEN1-VFILER-1
den1_datastore_1
cifs_datastore_1
online RW 22TB 1.60TB 67%
DEN1-VFILER-1
den1_datastore_2
iscsi_datastore_2
online RW 16TB 914.8GB 77%
3 entries were displayed.
</pre>

NOTE: Volume names may vary. Please validate the volume that you are wanting to restore.

=== vCenter ===

vCenter is what you will need to use in order to control the virtual machine. Below is the vCenter server information.

<pre>
Denver - 10.255.6.229
</pre>

=== Virtual Machine File Primer ===

This is a quick tutorial on the files that make up a virtual machine.

<pre>

vm_name.vmdk Virtual Hard Drive 1 specifications file
vm_name-flat.vmdk Virtual Hard Drive 1 data file

vm_name-000001.vmdk Virtual Hard Drive 1 snapshot 1 specifications file
vm_name-000001-delta.vmdk Virtual Hard Drive 1 snapshot 1 data file

vm_name_1.vmdk Virtual Hard Drive 2 specifications file
vm_name_1-flat.vmdk Virtual Hard Drive 2 data file

vm_name_1-000001.vmdk Virtual Hard Drive 1 snapshot 1 specifications file
vm_name_1-000001-delta.vmdk Virtual Hard Drive 1 snapshot 1 data file

vm_name.nvram Virtual machine BIOS settines

vm_name.vmx Virtual machine BIOS or EFI configuration
vm_name.vmsd Mapping file for snapshots. May be null if no snapshots exist.
vm_name.vmxf Additional virtual machine configuration files

vm_name-65e69988.hlog Log file that is used by vCenter Server to keep track of virtual
machine files that must be removed after a certain operation completes
vm_name-8861827a.vswp Virtual machine swap file
vm_name-2288091770-2.vswp Virtual machine swap file
</pre>

[https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-CEFF6D89-8C19-4143-8C26-4B6D6734D2CB.html]

== Preparation Steps ==

=== vCenter / ESXi - Shutdown the virtual machine ===

Because you will be restoring a disk image you will need to shut down the virtual machine. You will do this by logging into vCenter (or ESXi in some instances), navigating the the virtual machine, and powering it off. You may want to shut down from the OS, however the disk will be replaced, so disk consistency isn't important. You may just use vSphere to power it off rather than shutting it down.

=== vCenter / ESXi - Verify disk location ===

In vCenter (or ESXi), browse to the virtual machine, and identify where the hard drive is stored. You can usually do this by viewing the virtual machine hardware stats, but you may have to look in the actual settings.

[[File:VM Hardware view.png|800px|thumb|center|VM Hardware view]]

or

[[File:VM_Edit_Disk.png|800px|thumb|center|VM Edit view]]

In this case, we are looking for volume den1_datastore_2 and path /den1-mfa1.

=== Verify files from the helper machine ===

Log into the helper machine, and verify the files.

<pre>
$ ssh 10.255.6.228
sfiggins@10.255.6.228's password:
Last login: Wed Nov 16 09:58:06 2022 from 10.255.22.138
[sfiggins@test-centos ~]$ cd /mnt/den1_datastore_2/den1-mfa1
[sfiggins@test-centos den1-mfa1]$ ls -la
total 39304696
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 207 root root 20480 Nov 16 12:30 ..
-rw-------. 1 root root 2483105792 Nov 16 12:38 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 280951 Nov 16 12:33 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

In this case, we are looking for the latest disk file. For this machine, which contains an vSphere snapshot, we are wanting to address the '''den1-mfa1-000001-delta.vmdk''' file.

NOTE: In vSphere, you will not see this file, and it will show you the WRONG file.

[[File:VM Datastore Disk.png]]

In another machine, no snapshot exists, we re restore a different file.

<pre>
[sfiggins@test-centos den1-kafka2]$ ls -la
total 101769292
drwxr-xr-x. 2 root root 4096 Jun 21 09:51 .
drwxr-xr-x. 209 root root 20480 Nov 16 12:56 ..
-rw-------. 1 root root 70866960384 Nov 16 12:57 den1-kafka2_1-flat.vmdk
-rw-------. 1 root root 480 Jun 21 09:04 den1-kafka2_1.vmdk
-rw-r--r--. 1 root root 92 Aug 18 2021 den1-kafka2-65e69988.hlog
-rw-------. 1 root root 8589934592 Apr 1 2021 den1-kafka2-8861827a.vswp
-rw-------. 1 root root 38654705664 Nov 16 12:57 den1-kafka2-flat.vmdk
-rw-------. 1 root root 8684 Apr 16 2021 den1-kafka2.nvram
-rw-------. 1 root root 554 Jun 21 09:51 den1-kafka2.vmdk
-rw-r--r--. 1 root root 43 Jun 21 09:51 den1-kafka2.vmsd
-rwxr-xr-x. 1 root root 3510 Jun 21 09:51 den1-kafka2.vmx
-rw-------. 1 root root 0 Aug 18 2021 den1-kafka2.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-3d69bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-4369bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-7a40bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-cb72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-ef05bf5000000000
-rw-------. 1 root root 203317 Jan 19 2021 vmware-2.log
-rw-r--r--. 1 root root 197120 Mar 30 2021 vmware-3.log
-rw-r--r--. 1 root root 196887 Apr 1 2021 vmware-4.log
-rw-r--r--. 1 root root 247564 Apr 16 2021 vmware-5.log
-rw-r--r--. 1 root root 235945 Aug 12 2021 vmware-6.log
-rw-r--r--. 1 root root 232223 Aug 18 2021 vmware-7.log
-rw-r--r--. 1 root root 292598 Jun 21 09:51 vmware.log
-rw-------. 1 root root 90177536 Aug 18 2021 vmx-den1-kafka2-2288091770-2.vswp
</pre>

Here, we see that we would need to restore '''den1-kafka2_1-flat.vmdk''', however in vSphere, it is only going to look like '''den1-kafka2_1.vmdk'''. This machine also has two virtual hard disks, so make sure you know which disk you want to restore, or if you need to restore both.

[[File:VM_Other_Disk_file.png]]

=== Validate Snapshots ===

On the NetApp, validate the snapshot you want to restore. In this case, we are looking for volume '''den1_datastore_2''' on vfiler '''DEN1-VFILER-1'''.

<pre>
DEN1-AFF220::> volume snapshot show -vserver DEN1-VFILER-1 -volume den1_datastore_2
---Blocks---
Vserver Volume Snapshot Size Total% Used%
-------- -------- ------------------------------------- -------- ------ -----
DEN1-VFILER-1
den1_datastore_2
weekly.2022-10-02_0015 634.9GB 4% 9%
weekly.2022-10-09_0015 606.6GB 4% 9%
weekly.2022-10-16_0015 602.4GB 4% 9%
weekly.2022-10-23_0015 471.7GB 3% 7%
weekly.2022-10-30_0015 572.7GB 3% 8%
weekly.2022-11-06_0015 534.7GB 3% 8%
daily.2022-11-11_0010 469.2GB 3% 7%
daily.2022-11-12_0010 499.2GB 3% 7%
daily.2022-11-13_0010 131.5MB 0% 0%
weekly.2022-11-13_0015 357.3GB 2% 5%
daily.2022-11-14_0010 249.3GB 2% 4%
daily.2022-11-15_0010 558.2GB 3% 8%
daily.2022-11-16_0010 292.2GB 2% 4%
hourly.2022-11-16_0705 480.8MB 0% 0%
hourly.2022-11-16_0805 79.08GB 0% 1%
hourly.2022-11-16_0905 418.2MB 0% 0%
hourly.2022-11-16_1005 447.4MB 0% 0%
hourly.2022-11-16_1105 102.8GB 1% 2%
hourly.2022-11-16_1205 78.97GB 0% 1%
hourly.2022-11-16_1305 631.0MB 0% 0%
hourly.2022-11-16_1405 93.64GB 1% 1%
hourly.2022-11-16_1505 94.00GB 1% 1%
hourly.2022-11-16_1605 139.0GB 1% 2%
hourly.2022-11-16_1905 336.8MB 0% 0%
hourly.2022-11-16_2005 0B 0% 0%
25 entries were displayed.
</pre>

From here, we pick the snapshot we wish to restore from. Let's sy we want to restore from '''daily.2022-11-15_0010'''.

NOTE: Times may be in UTC. Be aware of the time zone and restore from the correct snapshot.

=== View Files in Snapshot ===

View the files on the helper machine to ensure that you have the correct time / date attributes for that you want to restore.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1/
total 35676064
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Here, you can see that our target file '''den1-mfa1-000001-delta.vmdk''' has a date that is attractive to us.

== Restore from Snapshot ==

Not you should be able to restore from the snapshot.

'''NOTE: THIS SYNTAX IS VERY CRITICAL, OR YOU WILL HAVE A BAD DAY!'''

=== Single file ===

From the NetApp Console:

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
</pre>

From the Helper:

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
total 39307912
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 211 root root 20480 Nov 16 13:20 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 281027 Nov 16 12:55 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

The file has been restored, and you can now bring the virtual machine back up.

NOTE: In this partucular case, it looks like the '''den1-mfa1-000001.vmdk''' file is newer, and may need to be restored from teh same snapshot. This is not always the case, and is particular to the machine used in this example. This machine had the vSphere snapshot removed and then a new one created after the NetApp snapshot.

=== Whole Directory ===

There is no single command to restore an entire directory from a snapshot. The easiest way would be to restore each file, however you may want to do some additional work to ensure that it works well, If our example above, the number of files is small enough to do it by hand, however if you are dealing with many more files, you may want to use a script to generate the commands, or use an alternative / slower method that will work on directories. I'll include that in another section.

From the helper machine, we will rename the old directory as a safegard and then create a new one to restore to.

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo nkdir /mnt/den1_datastore_2/den1-mfa1
</pre>

From the NetApp console, you will run the restore-file command for each file.

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-5c17aff3.hlog
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-d02c852f.vswp
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-flat.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.nvram
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-Snapshot4.vmsn
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmsd
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx.lck
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-2d07bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5470bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5870bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-6070bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-9e72bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-10.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-11.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-6.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-7.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-8.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-9.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now you can verify the restore from the helper machine.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Success! You can restore power on your virtual machine.

== Alternate / Slower Directory Restore ==

As an alternate, you can restore directories utilizing the helper machine to copy from the snapshot. This will take much longer since it has to copy the data, so it really should not be used.

From the helper machine:

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo cp -pr /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1 /mnt/den1_datastore_2/den1-mfa1
</pre>

Now validate your copy.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now your files are restored.

== Cleanup ==

If you made a copy or renamed the old directory, don't forget to go clean up the datastore.

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T23:33:45Z

Sfiggins: /* vCenter */

= Instructions on how to restore from NetApp Snapshot for ESXi machines =

== Basic Information ==

=== Helper Virtual Machines ===

These are machines that you will need to get into in order to validate the snapshots and file paths. ESXi / vCenter datastore browser hides certain files, so you need to know the exact file structure and path on order to restore.

<pre>
Denver - 10.255.6.228
Dallas - 10.255.8.228
</pre>

=== NetApp Filers ===

These are the administrative consoles for the NetApps. You can connect tot he Web UI for verifying some information, but you will need to SSH to the console (CLI) in order to perform restoration from snapshots.

<pre>
DEN1-AFF220 - 10.255.6.223
DAL1-AFF220 - 10.255.8.223
</pre>

=== NetApp vServers ===

Each NetApp has a number of vServers associated with it. In order to restore, you will need to know what vServer you are restoring from.

<pre>
DEN1-AFF220::> vserver show
Admin Operational Root
Vserver Type Subtype State State Volume Aggregate
----------- ------- ---------- ---------- ----------- ---------- ----------
AFF220-01 node - - - - -
AFF220-02 node - - - - -
DEN-SYSLOG data default running running DENSYSLOG_ cifs_
root datastore_
1
DEN1-AFF220 admin - - - - -
DEN1-VCIFS2 data default running running DEN1VCIFS2 cifs_
_root datastore_
1
DEN1-VFILER-1
data default running running DEN1VFILER cifs_
1_root datastore_
1
iscsi data default running running iscsi_root iscsi_
datastore_
2
7 entries were displayed.

</pre>

For vSphere hosts, this will be the following vServers, however these instructions would be valid for other vServers outside of sSphere.

<pre>
Denver - DEN1-VFILER-1
Dallas - DAL-VFILER-1
</pre>

NOTE: Dallas and Denver naming formats are slightly different in this case, so verify that you have the correct vServer before continuing.

=== NetApp Volumes ===

You can get this from vCenter, however it is usually a good idea to validate the volumes on the NetApp filer.

<pre>
DEN1-AFF220::> volume show -vserver DEN1-VFILER-1
Vserver Volume Aggregate State Type Size Available Used%
--------- ------------ ------------ ---------- ---- ---------- ---------- -----
DEN1-VFILER-1
DEN1VFILER1_root
cifs_datastore_1
online RW 1GB 971.8MB 0%
DEN1-VFILER-1
den1_datastore_1
cifs_datastore_1
online RW 22TB 1.60TB 67%
DEN1-VFILER-1
den1_datastore_2
iscsi_datastore_2
online RW 16TB 914.8GB 77%
3 entries were displayed.
</pre>

NOTE: Volume names may vary. Please validate the volume that you are wanting to restore.

=== vCenter ===

vCenter is what you will need to use in order to control the virtual machine. Below is the vCenter server information.

<pre>
Denver - 10.255.6.229
</pre>

=== Virtual Machine File Primer ===

This is a quick tutorial on the files that make up a virtual machine.

<pre>

vm_name.vmdk Virtual Hard Drive 1 specifications file
vm_name-flat.vmdk Virtual Hard Drive 1 data file

vm_name-000001.vmdk Virtual Hard Drive 1 snapshot 1 specifications file
vm_name-000001-delta.vmdk Virtual Hard Drive 1 snapshot 1 data file

vm_name_1.vmdk Virtual Hard Drive 2 specifications file
vm_name_1-flat.vmdk Virtual Hard Drive 2 data file

vm_name_1-000001.vmdk Virtual Hard Drive 1 snapshot 1 specifications file
vm_name_1-000001-delta.vmdk Virtual Hard Drive 1 snapshot 1 data file

vm_name.nvram Virtual machine BIOS settines

vm_name.vmx Virtual machine BIOS or EFI configuration
vm_name.vmsd Mapping file for snapshots. May be null if no snapshots exist.
vm_name.vmxf Additional virtual machine configuration files

vm_name-65e69988.hlog Log file that is used by vCenter Server to keep track of virtual
machine files that must be removed after a certain operation completes
vm_name-8861827a.vswp Virtual machine swap file
vm_name-2288091770-2.vswp Virtual machine swap file
</pre>

[https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-CEFF6D89-8C19-4143-8C26-4B6D6734D2CB.html]

== Preparation Steps ==

=== vCenter / ESXi - Shutdown the virtual machine ===

Because you will be restoring a disk image you will need to shut down the virtual machine. You will do this by logging into vCenter (or ESXi in some instances), navigating the the virtual machine, and powering it off. You may want to shut down from the OS, however the disk will be replaced, so disk consistency isn't important. You may just use vSphere to power it off rather than shutting it down.

=== vCenter / ESXi - Verify disk location ===

In vCenter (or ESXi), browse to the virtual machine, and identify where the hard drive is stored. You can usually do this by viewing the virtual machine hardware stats, but you may have to look in the actual settings.

[[File:VM Hardware view.png]]

or

[[File:VM_Edit_Disk.png]]

In this case, we are looking for volume den1_datastore_2 and path /den1-mfa1.

=== Verify files from the helper machine ===

Log into the helper machine, and verify the files.

<pre>
$ ssh 10.255.6.228
sfiggins@10.255.6.228's password:
Last login: Wed Nov 16 09:58:06 2022 from 10.255.22.138
[sfiggins@test-centos ~]$ cd /mnt/den1_datastore_2/den1-mfa1
[sfiggins@test-centos den1-mfa1]$ ls -la
total 39304696
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 207 root root 20480 Nov 16 12:30 ..
-rw-------. 1 root root 2483105792 Nov 16 12:38 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 280951 Nov 16 12:33 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

In this case, we are looking for the latest disk file. For this machine, which contains an vSphere snapshot, we are wanting to address the '''den1-mfa1-000001-delta.vmdk''' file.

NOTE: In vSphere, you will not see this file, and it will show you the WRONG file.

[[File:VM Datastore Disk.png]]

In another machine, no snapshot exists, we re restore a different file.

<pre>
[sfiggins@test-centos den1-kafka2]$ ls -la
total 101769292
drwxr-xr-x. 2 root root 4096 Jun 21 09:51 .
drwxr-xr-x. 209 root root 20480 Nov 16 12:56 ..
-rw-------. 1 root root 70866960384 Nov 16 12:57 den1-kafka2_1-flat.vmdk
-rw-------. 1 root root 480 Jun 21 09:04 den1-kafka2_1.vmdk
-rw-r--r--. 1 root root 92 Aug 18 2021 den1-kafka2-65e69988.hlog
-rw-------. 1 root root 8589934592 Apr 1 2021 den1-kafka2-8861827a.vswp
-rw-------. 1 root root 38654705664 Nov 16 12:57 den1-kafka2-flat.vmdk
-rw-------. 1 root root 8684 Apr 16 2021 den1-kafka2.nvram
-rw-------. 1 root root 554 Jun 21 09:51 den1-kafka2.vmdk
-rw-r--r--. 1 root root 43 Jun 21 09:51 den1-kafka2.vmsd
-rwxr-xr-x. 1 root root 3510 Jun 21 09:51 den1-kafka2.vmx
-rw-------. 1 root root 0 Aug 18 2021 den1-kafka2.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-3d69bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-4369bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-7a40bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-cb72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-ef05bf5000000000
-rw-------. 1 root root 203317 Jan 19 2021 vmware-2.log
-rw-r--r--. 1 root root 197120 Mar 30 2021 vmware-3.log
-rw-r--r--. 1 root root 196887 Apr 1 2021 vmware-4.log
-rw-r--r--. 1 root root 247564 Apr 16 2021 vmware-5.log
-rw-r--r--. 1 root root 235945 Aug 12 2021 vmware-6.log
-rw-r--r--. 1 root root 232223 Aug 18 2021 vmware-7.log
-rw-r--r--. 1 root root 292598 Jun 21 09:51 vmware.log
-rw-------. 1 root root 90177536 Aug 18 2021 vmx-den1-kafka2-2288091770-2.vswp
</pre>

Here, we see that we would need to restore '''den1-kafka2_1-flat.vmdk''', however in vSphere, it is only going to look like '''den1-kafka2_1.vmdk'''. This machine also has two virtual hard disks, so make sure you know which disk you want to restore, or if you need to restore both.

[[File:VM_Other_Disk_file.png]]

=== Validate Snapshots ===

On the NetApp, validate the snapshot you want to restore. In this case, we are looking for volume '''den1_datastore_2''' on vfiler '''DEN1-VFILER-1'''.

<pre>
DEN1-AFF220::> volume snapshot show -vserver DEN1-VFILER-1 -volume den1_datastore_2
---Blocks---
Vserver Volume Snapshot Size Total% Used%
-------- -------- ------------------------------------- -------- ------ -----
DEN1-VFILER-1
den1_datastore_2
weekly.2022-10-02_0015 634.9GB 4% 9%
weekly.2022-10-09_0015 606.6GB 4% 9%
weekly.2022-10-16_0015 602.4GB 4% 9%
weekly.2022-10-23_0015 471.7GB 3% 7%
weekly.2022-10-30_0015 572.7GB 3% 8%
weekly.2022-11-06_0015 534.7GB 3% 8%
daily.2022-11-11_0010 469.2GB 3% 7%
daily.2022-11-12_0010 499.2GB 3% 7%
daily.2022-11-13_0010 131.5MB 0% 0%
weekly.2022-11-13_0015 357.3GB 2% 5%
daily.2022-11-14_0010 249.3GB 2% 4%
daily.2022-11-15_0010 558.2GB 3% 8%
daily.2022-11-16_0010 292.2GB 2% 4%
hourly.2022-11-16_0705 480.8MB 0% 0%
hourly.2022-11-16_0805 79.08GB 0% 1%
hourly.2022-11-16_0905 418.2MB 0% 0%
hourly.2022-11-16_1005 447.4MB 0% 0%
hourly.2022-11-16_1105 102.8GB 1% 2%
hourly.2022-11-16_1205 78.97GB 0% 1%
hourly.2022-11-16_1305 631.0MB 0% 0%
hourly.2022-11-16_1405 93.64GB 1% 1%
hourly.2022-11-16_1505 94.00GB 1% 1%
hourly.2022-11-16_1605 139.0GB 1% 2%
hourly.2022-11-16_1905 336.8MB 0% 0%
hourly.2022-11-16_2005 0B 0% 0%
25 entries were displayed.
</pre>

From here, we pick the snapshot we wish to restore from. Let's sy we want to restore from '''daily.2022-11-15_0010'''.

NOTE: Times may be in UTC. Be aware of the time zone and restore from the correct snapshot.

=== View Files in Snapshot ===

View the files on the helper machine to ensure that you have the correct time / date attributes for that you want to restore.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1/
total 35676064
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Here, you can see that our target file '''den1-mfa1-000001-delta.vmdk''' has a date that is attractive to us.

== Restore from Snapshot ==

Not you should be able to restore from the snapshot.

'''NOTE: THIS SYNTAX IS VERY CRITICAL, OR YOU WILL HAVE A BAD DAY!'''

=== Single file ===

From the NetApp Console:

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
</pre>

From the Helper:

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
total 39307912
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 211 root root 20480 Nov 16 13:20 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 281027 Nov 16 12:55 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

The file has been restored, and you can now bring the virtual machine back up.

NOTE: In this partucular case, it looks like the '''den1-mfa1-000001.vmdk''' file is newer, and may need to be restored from teh same snapshot. This is not always the case, and is particular to the machine used in this example. This machine had the vSphere snapshot removed and then a new one created after the NetApp snapshot.

=== Whole Directory ===

There is no single command to restore an entire directory from a snapshot. The easiest way would be to restore each file, however you may want to do some additional work to ensure that it works well, If our example above, the number of files is small enough to do it by hand, however if you are dealing with many more files, you may want to use a script to generate the commands, or use an alternative / slower method that will work on directories. I'll include that in another section.

From the helper machine, we will rename the old directory as a safegard and then create a new one to restore to.

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo nkdir /mnt/den1_datastore_2/den1-mfa1
</pre>

From the NetApp console, you will run the restore-file command for each file.

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-5c17aff3.hlog
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-d02c852f.vswp
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-flat.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.nvram
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-Snapshot4.vmsn
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmsd
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx.lck
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-2d07bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5470bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5870bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-6070bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-9e72bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-10.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-11.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-6.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-7.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-8.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-9.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now you can verify the restore from the helper machine.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Success! You can restore power on your virtual machine.

== Alternate / Slower Directory Restore ==

As an alternate, you can restore directories utilizing the helper machine to copy from the snapshot. This will take much longer since it has to copy the data, so it really should not be used.

From the helper machine:

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo cp -pr /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1 /mnt/den1_datastore_2/den1-mfa1
</pre>

Now validate your copy.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now your files are restored.

== Cleanup ==

If you made a copy or renamed the old directory, don't forget to go clean up the datastore.

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T23:33:03Z

Sfiggins: /* Verify files from the helper machine */

= Instructions on how to restore from NetApp Snapshot for ESXi machines =

== Basic Information ==

=== Helper Virtual Machines ===

These are machines that you will need to get into in order to validate the snapshots and file paths. ESXi / vCenter datastore browser hides certain files, so you need to know the exact file structure and path on order to restore.

<pre>
Denver - 10.255.6.228
Dallas - 10.255.8.228
</pre>

=== NetApp Filers ===

These are the administrative consoles for the NetApps. You can connect tot he Web UI for verifying some information, but you will need to SSH to the console (CLI) in order to perform restoration from snapshots.

<pre>
DEN1-AFF220 - 10.255.6.223
DAL1-AFF220 - 10.255.8.223
</pre>

=== NetApp vServers ===

Each NetApp has a number of vServers associated with it. In order to restore, you will need to know what vServer you are restoring from.

<pre>
DEN1-AFF220::> vserver show
Admin Operational Root
Vserver Type Subtype State State Volume Aggregate
----------- ------- ---------- ---------- ----------- ---------- ----------
AFF220-01 node - - - - -
AFF220-02 node - - - - -
DEN-SYSLOG data default running running DENSYSLOG_ cifs_
root datastore_
1
DEN1-AFF220 admin - - - - -
DEN1-VCIFS2 data default running running DEN1VCIFS2 cifs_
_root datastore_
1
DEN1-VFILER-1
data default running running DEN1VFILER cifs_
1_root datastore_
1
iscsi data default running running iscsi_root iscsi_
datastore_
2
7 entries were displayed.

</pre>

For vSphere hosts, this will be the following vServers, however these instructions would be valid for other vServers outside of sSphere.

<pre>
Denver - DEN1-VFILER-1
Dallas - DAL-VFILER-1
</pre>

NOTE: Dallas and Denver naming formats are slightly different in this case, so verify that you have the correct vServer before continuing.

=== NetApp Volumes ===

You can get this from vCenter, however it is usually a good idea to validate the volumes on the NetApp filer.

<pre>
DEN1-AFF220::> volume show -vserver DEN1-VFILER-1
Vserver Volume Aggregate State Type Size Available Used%
--------- ------------ ------------ ---------- ---- ---------- ---------- -----
DEN1-VFILER-1
DEN1VFILER1_root
cifs_datastore_1
online RW 1GB 971.8MB 0%
DEN1-VFILER-1
den1_datastore_1
cifs_datastore_1
online RW 22TB 1.60TB 67%
DEN1-VFILER-1
den1_datastore_2
iscsi_datastore_2
online RW 16TB 914.8GB 77%
3 entries were displayed.
</pre>

NOTE: Volume names may vary. Please validate the volume that you are wanting to restore.

=== vCenter ===

vCenter is what you will need to use in order to control the virtual machine. Below is the vCenter server information.

<pre>
Denver - 10.255.6.229
</pre>

== Preparation Steps ==

=== vCenter / ESXi - Shutdown the virtual machine ===

Because you will be restoring a disk image you will need to shut down the virtual machine. You will do this by logging into vCenter (or ESXi in some instances), navigating the the virtual machine, and powering it off. You may want to shut down from the OS, however the disk will be replaced, so disk consistency isn't important. You may just use vSphere to power it off rather than shutting it down.

=== vCenter / ESXi - Verify disk location ===

In vCenter (or ESXi), browse to the virtual machine, and identify where the hard drive is stored. You can usually do this by viewing the virtual machine hardware stats, but you may have to look in the actual settings.

[[File:VM Hardware view.png]]

or

[[File:VM_Edit_Disk.png]]

In this case, we are looking for volume den1_datastore_2 and path /den1-mfa1.

=== Verify files from the helper machine ===

Log into the helper machine, and verify the files.

<pre>
$ ssh 10.255.6.228
sfiggins@10.255.6.228's password:
Last login: Wed Nov 16 09:58:06 2022 from 10.255.22.138
[sfiggins@test-centos ~]$ cd /mnt/den1_datastore_2/den1-mfa1
[sfiggins@test-centos den1-mfa1]$ ls -la
total 39304696
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 207 root root 20480 Nov 16 12:30 ..
-rw-------. 1 root root 2483105792 Nov 16 12:38 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 280951 Nov 16 12:33 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

In this case, we are looking for the latest disk file. For this machine, which contains an vSphere snapshot, we are wanting to address the '''den1-mfa1-000001-delta.vmdk''' file.

NOTE: In vSphere, you will not see this file, and it will show you the WRONG file.

[[File:VM Datastore Disk.png]]

In another machine, no snapshot exists, we re restore a different file.

<pre>
[sfiggins@test-centos den1-kafka2]$ ls -la
total 101769292
drwxr-xr-x. 2 root root 4096 Jun 21 09:51 .
drwxr-xr-x. 209 root root 20480 Nov 16 12:56 ..
-rw-------. 1 root root 70866960384 Nov 16 12:57 den1-kafka2_1-flat.vmdk
-rw-------. 1 root root 480 Jun 21 09:04 den1-kafka2_1.vmdk
-rw-r--r--. 1 root root 92 Aug 18 2021 den1-kafka2-65e69988.hlog
-rw-------. 1 root root 8589934592 Apr 1 2021 den1-kafka2-8861827a.vswp
-rw-------. 1 root root 38654705664 Nov 16 12:57 den1-kafka2-flat.vmdk
-rw-------. 1 root root 8684 Apr 16 2021 den1-kafka2.nvram
-rw-------. 1 root root 554 Jun 21 09:51 den1-kafka2.vmdk
-rw-r--r--. 1 root root 43 Jun 21 09:51 den1-kafka2.vmsd
-rwxr-xr-x. 1 root root 3510 Jun 21 09:51 den1-kafka2.vmx
-rw-------. 1 root root 0 Aug 18 2021 den1-kafka2.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-3d69bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-4369bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-7a40bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-cb72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-ef05bf5000000000
-rw-------. 1 root root 203317 Jan 19 2021 vmware-2.log
-rw-r--r--. 1 root root 197120 Mar 30 2021 vmware-3.log
-rw-r--r--. 1 root root 196887 Apr 1 2021 vmware-4.log
-rw-r--r--. 1 root root 247564 Apr 16 2021 vmware-5.log
-rw-r--r--. 1 root root 235945 Aug 12 2021 vmware-6.log
-rw-r--r--. 1 root root 232223 Aug 18 2021 vmware-7.log
-rw-r--r--. 1 root root 292598 Jun 21 09:51 vmware.log
-rw-------. 1 root root 90177536 Aug 18 2021 vmx-den1-kafka2-2288091770-2.vswp
</pre>

Here, we see that we would need to restore '''den1-kafka2_1-flat.vmdk''', however in vSphere, it is only going to look like '''den1-kafka2_1.vmdk'''. This machine also has two virtual hard disks, so make sure you know which disk you want to restore, or if you need to restore both.

[[File:VM_Other_Disk_file.png]]

=== Validate Snapshots ===

On the NetApp, validate the snapshot you want to restore. In this case, we are looking for volume '''den1_datastore_2''' on vfiler '''DEN1-VFILER-1'''.

<pre>
DEN1-AFF220::> volume snapshot show -vserver DEN1-VFILER-1 -volume den1_datastore_2
---Blocks---
Vserver Volume Snapshot Size Total% Used%
-------- -------- ------------------------------------- -------- ------ -----
DEN1-VFILER-1
den1_datastore_2
weekly.2022-10-02_0015 634.9GB 4% 9%
weekly.2022-10-09_0015 606.6GB 4% 9%
weekly.2022-10-16_0015 602.4GB 4% 9%
weekly.2022-10-23_0015 471.7GB 3% 7%
weekly.2022-10-30_0015 572.7GB 3% 8%
weekly.2022-11-06_0015 534.7GB 3% 8%
daily.2022-11-11_0010 469.2GB 3% 7%
daily.2022-11-12_0010 499.2GB 3% 7%
daily.2022-11-13_0010 131.5MB 0% 0%
weekly.2022-11-13_0015 357.3GB 2% 5%
daily.2022-11-14_0010 249.3GB 2% 4%
daily.2022-11-15_0010 558.2GB 3% 8%
daily.2022-11-16_0010 292.2GB 2% 4%
hourly.2022-11-16_0705 480.8MB 0% 0%
hourly.2022-11-16_0805 79.08GB 0% 1%
hourly.2022-11-16_0905 418.2MB 0% 0%
hourly.2022-11-16_1005 447.4MB 0% 0%
hourly.2022-11-16_1105 102.8GB 1% 2%
hourly.2022-11-16_1205 78.97GB 0% 1%
hourly.2022-11-16_1305 631.0MB 0% 0%
hourly.2022-11-16_1405 93.64GB 1% 1%
hourly.2022-11-16_1505 94.00GB 1% 1%
hourly.2022-11-16_1605 139.0GB 1% 2%
hourly.2022-11-16_1905 336.8MB 0% 0%
hourly.2022-11-16_2005 0B 0% 0%
25 entries were displayed.
</pre>

From here, we pick the snapshot we wish to restore from. Let's sy we want to restore from '''daily.2022-11-15_0010'''.

NOTE: Times may be in UTC. Be aware of the time zone and restore from the correct snapshot.

=== View Files in Snapshot ===

View the files on the helper machine to ensure that you have the correct time / date attributes for that you want to restore.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1/
total 35676064
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Here, you can see that our target file '''den1-mfa1-000001-delta.vmdk''' has a date that is attractive to us.

== Restore from Snapshot ==

Not you should be able to restore from the snapshot.

'''NOTE: THIS SYNTAX IS VERY CRITICAL, OR YOU WILL HAVE A BAD DAY!'''

=== Single file ===

From the NetApp Console:

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
</pre>

From the Helper:

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
total 39307912
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 211 root root 20480 Nov 16 13:20 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 281027 Nov 16 12:55 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

The file has been restored, and you can now bring the virtual machine back up.

NOTE: In this partucular case, it looks like the '''den1-mfa1-000001.vmdk''' file is newer, and may need to be restored from teh same snapshot. This is not always the case, and is particular to the machine used in this example. This machine had the vSphere snapshot removed and then a new one created after the NetApp snapshot.

=== Whole Directory ===

There is no single command to restore an entire directory from a snapshot. The easiest way would be to restore each file, however you may want to do some additional work to ensure that it works well, If our example above, the number of files is small enough to do it by hand, however if you are dealing with many more files, you may want to use a script to generate the commands, or use an alternative / slower method that will work on directories. I'll include that in another section.

From the helper machine, we will rename the old directory as a safegard and then create a new one to restore to.

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo nkdir /mnt/den1_datastore_2/den1-mfa1
</pre>

From the NetApp console, you will run the restore-file command for each file.

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-5c17aff3.hlog
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-d02c852f.vswp
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-flat.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.nvram
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-Snapshot4.vmsn
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmsd
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx.lck
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-2d07bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5470bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5870bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-6070bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-9e72bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-10.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-11.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-6.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-7.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-8.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-9.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now you can verify the restore from the helper machine.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Success! You can restore power on your virtual machine.

== Alternate / Slower Directory Restore ==

As an alternate, you can restore directories utilizing the helper machine to copy from the snapshot. This will take much longer since it has to copy the data, so it really should not be used.

From the helper machine:

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo cp -pr /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1 /mnt/den1_datastore_2/den1-mfa1
</pre>

Now validate your copy.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now your files are restored.

== Cleanup ==

If you made a copy or renamed the old directory, don't forget to go clean up the datastore.

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T21:06:15Z

Sfiggins:

= Instructions on how to restore from NetApp Snapshot for ESXi machines =

== Basic Information ==

=== Helper Virtual Machines ===

These are machines that you will need to get into in order to validate the snapshots and file paths. ESXi / vCenter datastore browser hides certain files, so you need to know the exact file structure and path on order to restore.

<pre>
Denver - 10.255.6.228
Dallas - 10.255.8.228
</pre>

=== NetApp Filers ===

These are the administrative consoles for the NetApps. You can connect tot he Web UI for verifying some information, but you will need to SSH to the console (CLI) in order to perform restoration from snapshots.

<pre>
DEN1-AFF220 - 10.255.6.223
DAL1-AFF220 - 10.255.8.223
</pre>

=== NetApp vServers ===

Each NetApp has a number of vServers associated with it. In order to restore, you will need to know what vServer you are restoring from.

<pre>
DEN1-AFF220::> vserver show
Admin Operational Root
Vserver Type Subtype State State Volume Aggregate
----------- ------- ---------- ---------- ----------- ---------- ----------
AFF220-01 node - - - - -
AFF220-02 node - - - - -
DEN-SYSLOG data default running running DENSYSLOG_ cifs_
root datastore_
1
DEN1-AFF220 admin - - - - -
DEN1-VCIFS2 data default running running DEN1VCIFS2 cifs_
_root datastore_
1
DEN1-VFILER-1
data default running running DEN1VFILER cifs_
1_root datastore_
1
iscsi data default running running iscsi_root iscsi_
datastore_
2
7 entries were displayed.

</pre>

For vSphere hosts, this will be the following vServers, however these instructions would be valid for other vServers outside of sSphere.

<pre>
Denver - DEN1-VFILER-1
Dallas - DAL-VFILER-1
</pre>

NOTE: Dallas and Denver naming formats are slightly different in this case, so verify that you have the correct vServer before continuing.

=== NetApp Volumes ===

You can get this from vCenter, however it is usually a good idea to validate the volumes on the NetApp filer.

<pre>
DEN1-AFF220::> volume show -vserver DEN1-VFILER-1
Vserver Volume Aggregate State Type Size Available Used%
--------- ------------ ------------ ---------- ---- ---------- ---------- -----
DEN1-VFILER-1
DEN1VFILER1_root
cifs_datastore_1
online RW 1GB 971.8MB 0%
DEN1-VFILER-1
den1_datastore_1
cifs_datastore_1
online RW 22TB 1.60TB 67%
DEN1-VFILER-1
den1_datastore_2
iscsi_datastore_2
online RW 16TB 914.8GB 77%
3 entries were displayed.
</pre>

NOTE: Volume names may vary. Please validate the volume that you are wanting to restore.

=== vCenter ===

vCenter is what you will need to use in order to control the virtual machine. Below is the vCenter server information.

<pre>
Denver - 10.255.6.229
</pre>

== Preparation Steps ==

=== vCenter / ESXi - Shutdown the virtual machine ===

Because you will be restoring a disk image you will need to shut down the virtual machine. You will do this by logging into vCenter (or ESXi in some instances), navigating the the virtual machine, and powering it off. You may want to shut down from the OS, however the disk will be replaced, so disk consistency isn't important. You may just use vSphere to power it off rather than shutting it down.

=== vCenter / ESXi - Verify disk location ===

In vCenter (or ESXi), browse to the virtual machine, and identify where the hard drive is stored. You can usually do this by viewing the virtual machine hardware stats, but you may have to look in the actual settings.

[[File:VM Hardware view.png]]

or

[[File:VM_Edit_Disk.png]]

In this case, we are looking for volume den1_datastore_2 and path /den1-mfa1.

=== Verify files from the helper machine ===

Log into the helper machine, and verify the files.

<pre>
$ ssh 10.255.6.228
sfiggins@10.255.6.228's password:
Last login: Wed Nov 16 09:58:06 2022 from 10.255.22.138
[sfiggins@test-centos ~]$ cd /mnt/den1_datastore_2/den1-mfa1
[sfiggins@test-centos den1-mfa1]$ ls -la
total 39304696
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 207 root root 20480 Nov 16 12:30 ..
-rw-------. 1 root root 2483105792 Nov 16 12:38 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 280951 Nov 16 12:33 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

In this case, we are looking for the latest disk file. For this machine, which contains an vSphere snapshot, we are wanting to address the '''den1-mfa1-000001-delta.vmdk''' file.

NOTE: In vSphere, you will not see this file, and it will show you the WRONG file.

[[File:VM Datastore Disk.png]]

In another machine, no snapshot exists, we re restore a different file.

<pre>
[sfiggins@test-centos den1-kafka2]$ ls -la
total 101769292
drwxr-xr-x. 2 root root 4096 Jun 21 09:51 .
drwxr-xr-x. 209 root root 20480 Nov 16 12:56 ..
-rw-------. 1 root root 70866960384 Nov 16 12:57 den1-kafka2_1-flat.vmdk
-rw-------. 1 root root 480 Jun 21 09:04 den1-kafka2_1.vmdk
-rw-r--r--. 1 root root 92 Aug 18 2021 den1-kafka2-65e69988.hlog
-rw-------. 1 root root 8589934592 Apr 1 2021 den1-kafka2-8861827a.vswp
-rw-------. 1 root root 38654705664 Nov 16 12:57 den1-kafka2-flat.vmdk
-rw-------. 1 root root 8684 Apr 16 2021 den1-kafka2.nvram
-rw-------. 1 root root 554 Jun 21 09:51 den1-kafka2.vmdk
-rw-r--r--. 1 root root 43 Jun 21 09:51 den1-kafka2.vmsd
-rwxr-xr-x. 1 root root 3510 Jun 21 09:51 den1-kafka2.vmx
-rw-------. 1 root root 0 Aug 18 2021 den1-kafka2.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-3d69bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-4369bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-7a40bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-cb72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-ef05bf5000000000
-rw-------. 1 root root 203317 Jan 19 2021 vmware-2.log
-rw-r--r--. 1 root root 197120 Mar 30 2021 vmware-3.log
-rw-r--r--. 1 root root 196887 Apr 1 2021 vmware-4.log
-rw-r--r--. 1 root root 247564 Apr 16 2021 vmware-5.log
-rw-r--r--. 1 root root 235945 Aug 12 2021 vmware-6.log
-rw-r--r--. 1 root root 232223 Aug 18 2021 vmware-7.log
-rw-r--r--. 1 root root 292598 Jun 21 09:51 vmware.log
-rw-------. 1 root root 90177536 Aug 18 2021 vmx-den1-kafka2-2288091770-2.vswp
</pre>

Here, we see that we would neet to restore '''den1-kafka2_1-flat.vmdk''', however in vSphere, it is only going to look like '''den1-kafka2_1.vmdk'''. Make sure you restore the correct file.

[[File:VM_Other_Disk_file.png]]

=== Validate Snapshots ===

On the NetApp, validate the snapshot you want to restore. In this case, we are looking for volume '''den1_datastore_2''' on vfiler '''DEN1-VFILER-1'''.

<pre>
DEN1-AFF220::> volume snapshot show -vserver DEN1-VFILER-1 -volume den1_datastore_2
---Blocks---
Vserver Volume Snapshot Size Total% Used%
-------- -------- ------------------------------------- -------- ------ -----
DEN1-VFILER-1
den1_datastore_2
weekly.2022-10-02_0015 634.9GB 4% 9%
weekly.2022-10-09_0015 606.6GB 4% 9%
weekly.2022-10-16_0015 602.4GB 4% 9%
weekly.2022-10-23_0015 471.7GB 3% 7%
weekly.2022-10-30_0015 572.7GB 3% 8%
weekly.2022-11-06_0015 534.7GB 3% 8%
daily.2022-11-11_0010 469.2GB 3% 7%
daily.2022-11-12_0010 499.2GB 3% 7%
daily.2022-11-13_0010 131.5MB 0% 0%
weekly.2022-11-13_0015 357.3GB 2% 5%
daily.2022-11-14_0010 249.3GB 2% 4%
daily.2022-11-15_0010 558.2GB 3% 8%
daily.2022-11-16_0010 292.2GB 2% 4%
hourly.2022-11-16_0705 480.8MB 0% 0%
hourly.2022-11-16_0805 79.08GB 0% 1%
hourly.2022-11-16_0905 418.2MB 0% 0%
hourly.2022-11-16_1005 447.4MB 0% 0%
hourly.2022-11-16_1105 102.8GB 1% 2%
hourly.2022-11-16_1205 78.97GB 0% 1%
hourly.2022-11-16_1305 631.0MB 0% 0%
hourly.2022-11-16_1405 93.64GB 1% 1%
hourly.2022-11-16_1505 94.00GB 1% 1%
hourly.2022-11-16_1605 139.0GB 1% 2%
hourly.2022-11-16_1905 336.8MB 0% 0%
hourly.2022-11-16_2005 0B 0% 0%
25 entries were displayed.
</pre>

From here, we pick the snapshot we wish to restore from. Let's sy we want to restore from '''daily.2022-11-15_0010'''.

NOTE: Times may be in UTC. Be aware of the time zone and restore from the correct snapshot.

=== View Files in Snapshot ===

View the files on the helper machine to ensure that you have the correct time / date attributes for that you want to restore.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1/
total 35676064
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Here, you can see that our target file '''den1-mfa1-000001-delta.vmdk''' has a date that is attractive to us.

== Restore from Snapshot ==

Not you should be able to restore from the snapshot.

'''NOTE: THIS SYNTAX IS VERY CRITICAL, OR YOU WILL HAVE A BAD DAY!'''

=== Single file ===

From the NetApp Console:

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
</pre>

From the Helper:

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
total 39307912
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 211 root root 20480 Nov 16 13:20 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 281027 Nov 16 12:55 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

The file has been restored, and you can now bring the virtual machine back up.

NOTE: In this partucular case, it looks like the '''den1-mfa1-000001.vmdk''' file is newer, and may need to be restored from teh same snapshot. This is not always the case, and is particular to the machine used in this example. This machine had the vSphere snapshot removed and then a new one created after the NetApp snapshot.

=== Whole Directory ===

There is no single command to restore an entire directory from a snapshot. The easiest way would be to restore each file, however you may want to do some additional work to ensure that it works well, If our example above, the number of files is small enough to do it by hand, however if you are dealing with many more files, you may want to use a script to generate the commands, or use an alternative / slower method that will work on directories. I'll include that in another section.

From the helper machine, we will rename the old directory as a safegard and then create a new one to restore to.

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo nkdir /mnt/den1_datastore_2/den1-mfa1
</pre>

From the NetApp console, you will run the restore-file command for each file.

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-5c17aff3.hlog
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-d02c852f.vswp
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-flat.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.nvram
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-Snapshot4.vmsn
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmsd
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx.lck
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-2d07bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5470bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5870bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-6070bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-9e72bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-10.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-11.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-6.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-7.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-8.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-9.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now you can verify the restore from the helper machine.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Success! You can restore power on your virtual machine.

== Alternate / Slower Directory Restore ==

As an alternate, you can restore directories utilizing the helper machine to copy from the snapshot. This will take much longer since it has to copy the data, so it really should not be used.

From the helper machine:

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo cp -pr /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1 /mnt/den1_datastore_2/den1-mfa1
</pre>

Now validate your copy.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now your files are restored.

== Cleanup ==

If you made a copy or renamed the old directory, don't forget to go clean up the datastore.

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T20:55:11Z

Sfiggins: /* Whole Directory */

= Instructions on how to restore from NetApp Snapshot for ESXi machines =

== Basic Information ==

=== Helper Virtual Machines ===

These are machines that you will need to get into in order to validate the snapshots and file paths. ESXi / vCenter datastore browser hides certain files, so you need to know the exact file structure and path on order to restore.

<pre>
Denver - 10.255.6.228
Dallas - 10.255.8.228
</pre>

=== NetApp Filers ===

These are the administrative consoles for the NetApps. You can connect tot he Web UI for verifying some information, but you will need to SHS to the console (CLI) in order to perform restoration from snapshots.

<pre>
DEN1-AFF220 - 10.255.6.223
DAL1-AFF220 - 10.255.8.223
</pre>

=== NetApp vServers ===

Each NetApp has a number of vServers associated with it. In order to restore, you will need to know what vServer you are restoring from.

<pre>
DEN1-AFF220::> vserver show
Admin Operational Root
Vserver Type Subtype State State Volume Aggregate
----------- ------- ---------- ---------- ----------- ---------- ----------
AFF220-01 node - - - - -
AFF220-02 node - - - - -
DEN-SYSLOG data default running running DENSYSLOG_ cifs_
root datastore_
1
DEN1-AFF220 admin - - - - -
DEN1-VCIFS2 data default running running DEN1VCIFS2 cifs_
_root datastore_
1
DEN1-VFILER-1
data default running running DEN1VFILER cifs_
1_root datastore_
1
iscsi data default running running iscsi_root iscsi_
datastore_
2
7 entries were displayed.

</pre>

For vSphere hosts, this will be the following vServers, however these instructions would be valid for other vServers outside of sSphere.

<pre>
Denver - DEN1-VFILER-1
Dallas - DAL-VFILER-1
</pre>

NOTE: Dallas and Denver naming formats are slightly different in this case, so verify that you have the correct vServer before continuing.

=== NetApp Volumes ===

You can get this from vCenter, however it is usually a good idea to validate the volumes on the NetApp filer.

<pre>
DEN1-AFF220::> volume show -vserver DEN1-VFILER-1
Vserver Volume Aggregate State Type Size Available Used%
--------- ------------ ------------ ---------- ---- ---------- ---------- -----
DEN1-VFILER-1
DEN1VFILER1_root
cifs_datastore_1
online RW 1GB 971.8MB 0%
DEN1-VFILER-1
den1_datastore_1
cifs_datastore_1
online RW 22TB 1.60TB 67%
DEN1-VFILER-1
den1_datastore_2
iscsi_datastore_2
online RW 16TB 914.8GB 77%
3 entries were displayed.
</pre>

NOTE: Volume names may vary. Please validate the volume that you are wanting to restore.

=== vCenter ===

vCenter is what you will need to use in order to control the virtual machine. Below is the vCenter server information.

<pre>
Denver - 10.255.6.229
</pre>

== Preparation Steps ==

=== vCenter / ESXi - Shutdown the virtual machine ===

Because you will be restoring a disk image you will need to shut down the virtual machine. You will do this by logging into vCenter (or ESXi in some instances), navigating the the virtual machine, and powering it off. You may want to shut down from the OS, however the disk will be replaced, so disk consistency isn't important. You may just use vSphere to power it off rather than shutting it down.

=== vCenter / ESXi - Verify disk location ===

In vCenter (or ESXi), browse to the virtual machine, and identify where the hard drive is stored. You can usually do this by viewing the virtual machine hardware stats, but you may have to look in the actual settings.

[[File:VM Hardware view.png]]

or

[[File:VM_Edit_Disk.png]]

In this case, we are looking for volume den1_datastore_2 and path /den1-mfa1.

=== Verify files from the helper machine ===

Log into the helper machine, and verify the files.

<pre>
$ ssh 10.255.6.228
sfiggins@10.255.6.228's password:
Last login: Wed Nov 16 09:58:06 2022 from 10.255.22.138
[sfiggins@test-centos ~]$ cd /mnt/den1_datastore_2/den1-mfa1
[sfiggins@test-centos den1-mfa1]$ ls -la
total 39304696
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 207 root root 20480 Nov 16 12:30 ..
-rw-------. 1 root root 2483105792 Nov 16 12:38 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 280951 Nov 16 12:33 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

In this case, we are looking for the latest disk file. For this machine, which contains an vSphere snapshot, we are wanting to address the '''den1-mfa1-000001-delta.vmdk''' file.

NOTE: In vSphere, you will not see this file, and it will show you the WRONG file.

[[File:VM Datastore Disk.png]]

In another machine, no snapshot exists, we re restore a different file.

<pre>
[sfiggins@test-centos den1-kafka2]$ ls -la
total 101769292
drwxr-xr-x. 2 root root 4096 Jun 21 09:51 .
drwxr-xr-x. 209 root root 20480 Nov 16 12:56 ..
-rw-------. 1 root root 70866960384 Nov 16 12:57 den1-kafka2_1-flat.vmdk
-rw-------. 1 root root 480 Jun 21 09:04 den1-kafka2_1.vmdk
-rw-r--r--. 1 root root 92 Aug 18 2021 den1-kafka2-65e69988.hlog
-rw-------. 1 root root 8589934592 Apr 1 2021 den1-kafka2-8861827a.vswp
-rw-------. 1 root root 38654705664 Nov 16 12:57 den1-kafka2-flat.vmdk
-rw-------. 1 root root 8684 Apr 16 2021 den1-kafka2.nvram
-rw-------. 1 root root 554 Jun 21 09:51 den1-kafka2.vmdk
-rw-r--r--. 1 root root 43 Jun 21 09:51 den1-kafka2.vmsd
-rwxr-xr-x. 1 root root 3510 Jun 21 09:51 den1-kafka2.vmx
-rw-------. 1 root root 0 Aug 18 2021 den1-kafka2.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-3d69bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-4369bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-7a40bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-cb72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-ef05bf5000000000
-rw-------. 1 root root 203317 Jan 19 2021 vmware-2.log
-rw-r--r--. 1 root root 197120 Mar 30 2021 vmware-3.log
-rw-r--r--. 1 root root 196887 Apr 1 2021 vmware-4.log
-rw-r--r--. 1 root root 247564 Apr 16 2021 vmware-5.log
-rw-r--r--. 1 root root 235945 Aug 12 2021 vmware-6.log
-rw-r--r--. 1 root root 232223 Aug 18 2021 vmware-7.log
-rw-r--r--. 1 root root 292598 Jun 21 09:51 vmware.log
-rw-------. 1 root root 90177536 Aug 18 2021 vmx-den1-kafka2-2288091770-2.vswp
</pre>

Here, we see that we would neet to restore '''den1-kafka2_1-flat.vmdk''', however in vSphere, it is only going to look like '''den1-kafka2_1.vmdk'''. Make sure you restore the correct file.

[[File:VM_Other_Disk_file.png]]

=== Validate Snapshots ===

On the NetApp, validate the snapshot you want to restore. In this case, we are looking for volume '''den1_datastore_2''' on vfiler '''DEN1-VFILER-1'''.

<pre>
DEN1-AFF220::> volume snapshot show -vserver DEN1-VFILER-1 -volume den1_datastore_2
---Blocks---
Vserver Volume Snapshot Size Total% Used%
-------- -------- ------------------------------------- -------- ------ -----
DEN1-VFILER-1
den1_datastore_2
weekly.2022-10-02_0015 634.9GB 4% 9%
weekly.2022-10-09_0015 606.6GB 4% 9%
weekly.2022-10-16_0015 602.4GB 4% 9%
weekly.2022-10-23_0015 471.7GB 3% 7%
weekly.2022-10-30_0015 572.7GB 3% 8%
weekly.2022-11-06_0015 534.7GB 3% 8%
daily.2022-11-11_0010 469.2GB 3% 7%
daily.2022-11-12_0010 499.2GB 3% 7%
daily.2022-11-13_0010 131.5MB 0% 0%
weekly.2022-11-13_0015 357.3GB 2% 5%
daily.2022-11-14_0010 249.3GB 2% 4%
daily.2022-11-15_0010 558.2GB 3% 8%
daily.2022-11-16_0010 292.2GB 2% 4%
hourly.2022-11-16_0705 480.8MB 0% 0%
hourly.2022-11-16_0805 79.08GB 0% 1%
hourly.2022-11-16_0905 418.2MB 0% 0%
hourly.2022-11-16_1005 447.4MB 0% 0%
hourly.2022-11-16_1105 102.8GB 1% 2%
hourly.2022-11-16_1205 78.97GB 0% 1%
hourly.2022-11-16_1305 631.0MB 0% 0%
hourly.2022-11-16_1405 93.64GB 1% 1%
hourly.2022-11-16_1505 94.00GB 1% 1%
hourly.2022-11-16_1605 139.0GB 1% 2%
hourly.2022-11-16_1905 336.8MB 0% 0%
hourly.2022-11-16_2005 0B 0% 0%
25 entries were displayed.
</pre>

From here, we pick the snapshot we wish to restore from. Let's sy we want to restore from '''daily.2022-11-15_0010'''.

NOTE: Times may be in UTC. Be aware of the time zone and restore from the correct snapshot.

=== View Files in Snapshot ===

View the files on the helper machine to ensure that you have the correct time / date attributes for that you want to restore.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1/
total 35676064
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Here, you can see that our target file '''den1-mfa1-000001-delta.vmdk''' has a date that is attractive to us.

== Restore from Snapshot ==

Not you should be able to restore from the snapshot.

'''NOTE: THIS SYNTAX IS VERY CRITICAL, OR YOU WILL HAVE A BAD DAY!'''

=== Single file ===

From the NetApp Console:

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
</pre>

From the Helper:

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
total 39307912
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 211 root root 20480 Nov 16 13:20 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 281027 Nov 16 12:55 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

The file has been restored, and you can now bring the virtual machine back up.

NOTE: In this partucular case, it looks like the '''den1-mfa1-000001.vmdk''' file is newer, and may need to be restored from teh same snapshot. This is not always the case, and is particular to the machine used in this example. This machine had the vSphere snapshot removed and then a new one created after the NetApp snapshot.

=== Whole Directory ===

There is no single command to restore an entire directory from a snapshot. The easiest way would be to restore each file, however you may want to do some additional work to ensure that it works well, If our example above, the number of files is small enough to do it by hand, however if you are dealing with many more files, you may want to use a script to generate the commands, or use an alternative / slower method that will work on directories. I'll include that in another section.

From the helper machine, we will rename the old directory as a safegard and then create a new one to restore to.

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo nkdir /mnt/den1_datastore_2/den1-mfa1
</pre>

From the NetApp console, you will run the restore-file command for each file.

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-5c17aff3.hlog
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-d02c852f.vswp
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-flat.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.nvram
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-Snapshot4.vmsn
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmsd
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx.lck
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-2d07bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5470bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5870bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-6070bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-9e72bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-10.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-11.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-6.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-7.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-8.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-9.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now you can verify the restore from the helper machine.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Success! You can restore power on your virtual machine.

== Alternate / Slower Directory Restore ==

As an alternate, you can restore directories utilizing the helper machine to copy from the snapshot. This will take much longer since it has to copy the data, so it really should not be used.

From the helper machine:

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo cp -pr /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1 /mnt/den1_datastore_2/den1-mfa1
</pre>

Now validate your copy.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now your files are restored.

== Cleanup ==

If you made a copy or renamed the old directory, don't forget to go clean up the datastore.

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T20:48:58Z

Sfiggins: /* Whole Directory */

= Instructions on how to restore from NetApp Snapshot for ESXi machines =

== Basic Information ==

=== Helper Virtual Machines ===

These are machines that you will need to get into in order to validate the snapshots and file paths. ESXi / vCenter datastore browser hides certain files, so you need to know the exact file structure and path on order to restore.

<pre>
Denver - 10.255.6.228
Dallas - 10.255.8.228
</pre>

=== NetApp Filers ===

These are the administrative consoles for the NetApps. You can connect tot he Web UI for verifying some information, but you will need to SHS to the console (CLI) in order to perform restoration from snapshots.

<pre>
DEN1-AFF220 - 10.255.6.223
DAL1-AFF220 - 10.255.8.223
</pre>

=== NetApp vServers ===

Each NetApp has a number of vServers associated with it. In order to restore, you will need to know what vServer you are restoring from.

<pre>
DEN1-AFF220::> vserver show
Admin Operational Root
Vserver Type Subtype State State Volume Aggregate
----------- ------- ---------- ---------- ----------- ---------- ----------
AFF220-01 node - - - - -
AFF220-02 node - - - - -
DEN-SYSLOG data default running running DENSYSLOG_ cifs_
root datastore_
1
DEN1-AFF220 admin - - - - -
DEN1-VCIFS2 data default running running DEN1VCIFS2 cifs_
_root datastore_
1
DEN1-VFILER-1
data default running running DEN1VFILER cifs_
1_root datastore_
1
iscsi data default running running iscsi_root iscsi_
datastore_
2
7 entries were displayed.

</pre>

For vSphere hosts, this will be the following vServers, however these instructions would be valid for other vServers outside of sSphere.

<pre>
Denver - DEN1-VFILER-1
Dallas - DAL-VFILER-1
</pre>

NOTE: Dallas and Denver naming formats are slightly different in this case, so verify that you have the correct vServer before continuing.

=== NetApp Volumes ===

You can get this from vCenter, however it is usually a good idea to validate the volumes on the NetApp filer.

<pre>
DEN1-AFF220::> volume show -vserver DEN1-VFILER-1
Vserver Volume Aggregate State Type Size Available Used%
--------- ------------ ------------ ---------- ---- ---------- ---------- -----
DEN1-VFILER-1
DEN1VFILER1_root
cifs_datastore_1
online RW 1GB 971.8MB 0%
DEN1-VFILER-1
den1_datastore_1
cifs_datastore_1
online RW 22TB 1.60TB 67%
DEN1-VFILER-1
den1_datastore_2
iscsi_datastore_2
online RW 16TB 914.8GB 77%
3 entries were displayed.
</pre>

NOTE: Volume names may vary. Please validate the volume that you are wanting to restore.

=== vCenter ===

vCenter is what you will need to use in order to control the virtual machine. Below is the vCenter server information.

<pre>
Denver - 10.255.6.229
</pre>

== Preparation Steps ==

=== vCenter / ESXi - Shutdown the virtual machine ===

Because you will be restoring a disk image you will need to shut down the virtual machine. You will do this by logging into vCenter (or ESXi in some instances), navigating the the virtual machine, and powering it off. You may want to shut down from the OS, however the disk will be replaced, so disk consistency isn't important. You may just use vSphere to power it off rather than shutting it down.

=== vCenter / ESXi - Verify disk location ===

In vCenter (or ESXi), browse to the virtual machine, and identify where the hard drive is stored. You can usually do this by viewing the virtual machine hardware stats, but you may have to look in the actual settings.

[[File:VM Hardware view.png]]

or

[[File:VM_Edit_Disk.png]]

In this case, we are looking for volume den1_datastore_2 and path /den1-mfa1.

=== Verify files from the helper machine ===

Log into the helper machine, and verify the files.

<pre>
$ ssh 10.255.6.228
sfiggins@10.255.6.228's password:
Last login: Wed Nov 16 09:58:06 2022 from 10.255.22.138
[sfiggins@test-centos ~]$ cd /mnt/den1_datastore_2/den1-mfa1
[sfiggins@test-centos den1-mfa1]$ ls -la
total 39304696
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 207 root root 20480 Nov 16 12:30 ..
-rw-------. 1 root root 2483105792 Nov 16 12:38 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 280951 Nov 16 12:33 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

In this case, we are looking for the latest disk file. For this machine, which contains an vSphere snapshot, we are wanting to address the '''den1-mfa1-000001-delta.vmdk''' file.

NOTE: In vSphere, you will not see this file, and it will show you the WRONG file.

[[File:VM Datastore Disk.png]]

In another machine, no snapshot exists, we re restore a different file.

<pre>
[sfiggins@test-centos den1-kafka2]$ ls -la
total 101769292
drwxr-xr-x. 2 root root 4096 Jun 21 09:51 .
drwxr-xr-x. 209 root root 20480 Nov 16 12:56 ..
-rw-------. 1 root root 70866960384 Nov 16 12:57 den1-kafka2_1-flat.vmdk
-rw-------. 1 root root 480 Jun 21 09:04 den1-kafka2_1.vmdk
-rw-r--r--. 1 root root 92 Aug 18 2021 den1-kafka2-65e69988.hlog
-rw-------. 1 root root 8589934592 Apr 1 2021 den1-kafka2-8861827a.vswp
-rw-------. 1 root root 38654705664 Nov 16 12:57 den1-kafka2-flat.vmdk
-rw-------. 1 root root 8684 Apr 16 2021 den1-kafka2.nvram
-rw-------. 1 root root 554 Jun 21 09:51 den1-kafka2.vmdk
-rw-r--r--. 1 root root 43 Jun 21 09:51 den1-kafka2.vmsd
-rwxr-xr-x. 1 root root 3510 Jun 21 09:51 den1-kafka2.vmx
-rw-------. 1 root root 0 Aug 18 2021 den1-kafka2.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-3d69bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-4369bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-7a40bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-cb72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-ef05bf5000000000
-rw-------. 1 root root 203317 Jan 19 2021 vmware-2.log
-rw-r--r--. 1 root root 197120 Mar 30 2021 vmware-3.log
-rw-r--r--. 1 root root 196887 Apr 1 2021 vmware-4.log
-rw-r--r--. 1 root root 247564 Apr 16 2021 vmware-5.log
-rw-r--r--. 1 root root 235945 Aug 12 2021 vmware-6.log
-rw-r--r--. 1 root root 232223 Aug 18 2021 vmware-7.log
-rw-r--r--. 1 root root 292598 Jun 21 09:51 vmware.log
-rw-------. 1 root root 90177536 Aug 18 2021 vmx-den1-kafka2-2288091770-2.vswp
</pre>

Here, we see that we would neet to restore '''den1-kafka2_1-flat.vmdk''', however in vSphere, it is only going to look like '''den1-kafka2_1.vmdk'''. Make sure you restore the correct file.

[[File:VM_Other_Disk_file.png]]

=== Validate Snapshots ===

On the NetApp, validate the snapshot you want to restore. In this case, we are looking for volume '''den1_datastore_2''' on vfiler '''DEN1-VFILER-1'''.

<pre>
DEN1-AFF220::> volume snapshot show -vserver DEN1-VFILER-1 -volume den1_datastore_2
---Blocks---
Vserver Volume Snapshot Size Total% Used%
-------- -------- ------------------------------------- -------- ------ -----
DEN1-VFILER-1
den1_datastore_2
weekly.2022-10-02_0015 634.9GB 4% 9%
weekly.2022-10-09_0015 606.6GB 4% 9%
weekly.2022-10-16_0015 602.4GB 4% 9%
weekly.2022-10-23_0015 471.7GB 3% 7%
weekly.2022-10-30_0015 572.7GB 3% 8%
weekly.2022-11-06_0015 534.7GB 3% 8%
daily.2022-11-11_0010 469.2GB 3% 7%
daily.2022-11-12_0010 499.2GB 3% 7%
daily.2022-11-13_0010 131.5MB 0% 0%
weekly.2022-11-13_0015 357.3GB 2% 5%
daily.2022-11-14_0010 249.3GB 2% 4%
daily.2022-11-15_0010 558.2GB 3% 8%
daily.2022-11-16_0010 292.2GB 2% 4%
hourly.2022-11-16_0705 480.8MB 0% 0%
hourly.2022-11-16_0805 79.08GB 0% 1%
hourly.2022-11-16_0905 418.2MB 0% 0%
hourly.2022-11-16_1005 447.4MB 0% 0%
hourly.2022-11-16_1105 102.8GB 1% 2%
hourly.2022-11-16_1205 78.97GB 0% 1%
hourly.2022-11-16_1305 631.0MB 0% 0%
hourly.2022-11-16_1405 93.64GB 1% 1%
hourly.2022-11-16_1505 94.00GB 1% 1%
hourly.2022-11-16_1605 139.0GB 1% 2%
hourly.2022-11-16_1905 336.8MB 0% 0%
hourly.2022-11-16_2005 0B 0% 0%
25 entries were displayed.
</pre>

From here, we pick the snapshot we wish to restore from. Let's sy we want to restore from '''daily.2022-11-15_0010'''.

NOTE: Times may be in UTC. Be aware of the time zone and restore from the correct snapshot.

=== View Files in Snapshot ===

View the files on the helper machine to ensure that you have the correct time / date attributes for that you want to restore.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1/
total 35676064
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Here, you can see that our target file '''den1-mfa1-000001-delta.vmdk''' has a date that is attractive to us.

== Restore from Snapshot ==

Not you should be able to restore from the snapshot.

'''NOTE: THIS SYNTAX IS VERY CRITICAL, OR YOU WILL HAVE A BAD DAY!'''

=== Single file ===

From the NetApp Console:

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
</pre>

From the Helper:

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
total 39307912
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 211 root root 20480 Nov 16 13:20 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 281027 Nov 16 12:55 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

The file has been restored, and you can now bring the virtual machine back up.

NOTE: In this partucular case, it looks like the '''den1-mfa1-000001.vmdk''' file is newer, and may need to be restored from teh same snapshot. This is not always the case, and is particular to the machine used in this example. This machine had the vSphere snapshot removed and then a new one created after the NetApp snapshot.

=== Whole Directory ===

There is no single command to restore an entire directory from a snapshot. The easiest way would be to restore each file, however you may want to do some additional work to ensure that it works well, If our example above, the number of files is small enough to do it by hand, however if you are dealing with many more files, you may want to use a script to generate the commands, or use an alternative / slower method that will work on directories. I'll include that in another section.

From the helper machine, we will rename the old directory as a safegard and then create a new one to restore to.

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo nkdir /mnt/den1_datastore_2/den1-mfa1
</pre>

From the NetApp console, you will run the restore-file command for each file.

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-5c17aff3.hlog
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-d02c852f.vswp
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-flat.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.nvram
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-Snapshot4.vmsn
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmdk
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmsd
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx.lck
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-2d07bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5470bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5870bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-6070bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-9e72bf5000000000
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-10.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-11.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-6.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-7.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-8.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-9.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware.log
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now you can verify the restore from the helper machine.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Success! You can restore power on your virtual machine.

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T20:46:02Z

Sfiggins: /* Validate Snapshots */

= Instructions on how to restore from NetApp Snapshot for ESXi machines =

== Basic Information ==

=== Helper Virtual Machines ===

These are machines that you will need to get into in order to validate the snapshots and file paths. ESXi / vCenter datastore browser hides certain files, so you need to know the exact file structure and path on order to restore.

<pre>
Denver - 10.255.6.228
Dallas - 10.255.8.228
</pre>

=== NetApp Filers ===

These are the administrative consoles for the NetApps. You can connect tot he Web UI for verifying some information, but you will need to SHS to the console (CLI) in order to perform restoration from snapshots.

<pre>
DEN1-AFF220 - 10.255.6.223
DAL1-AFF220 - 10.255.8.223
</pre>

=== NetApp vServers ===

Each NetApp has a number of vServers associated with it. In order to restore, you will need to know what vServer you are restoring from.

<pre>
DEN1-AFF220::> vserver show
Admin Operational Root
Vserver Type Subtype State State Volume Aggregate
----------- ------- ---------- ---------- ----------- ---------- ----------
AFF220-01 node - - - - -
AFF220-02 node - - - - -
DEN-SYSLOG data default running running DENSYSLOG_ cifs_
root datastore_
1
DEN1-AFF220 admin - - - - -
DEN1-VCIFS2 data default running running DEN1VCIFS2 cifs_
_root datastore_
1
DEN1-VFILER-1
data default running running DEN1VFILER cifs_
1_root datastore_
1
iscsi data default running running iscsi_root iscsi_
datastore_
2
7 entries were displayed.

</pre>

For vSphere hosts, this will be the following vServers, however these instructions would be valid for other vServers outside of sSphere.

<pre>
Denver - DEN1-VFILER-1
Dallas - DAL-VFILER-1
</pre>

NOTE: Dallas and Denver naming formats are slightly different in this case, so verify that you have the correct vServer before continuing.

=== NetApp Volumes ===

You can get this from vCenter, however it is usually a good idea to validate the volumes on the NetApp filer.

<pre>
DEN1-AFF220::> volume show -vserver DEN1-VFILER-1
Vserver Volume Aggregate State Type Size Available Used%
--------- ------------ ------------ ---------- ---- ---------- ---------- -----
DEN1-VFILER-1
DEN1VFILER1_root
cifs_datastore_1
online RW 1GB 971.8MB 0%
DEN1-VFILER-1
den1_datastore_1
cifs_datastore_1
online RW 22TB 1.60TB 67%
DEN1-VFILER-1
den1_datastore_2
iscsi_datastore_2
online RW 16TB 914.8GB 77%
3 entries were displayed.
</pre>

NOTE: Volume names may vary. Please validate the volume that you are wanting to restore.

=== vCenter ===

vCenter is what you will need to use in order to control the virtual machine. Below is the vCenter server information.

<pre>
Denver - 10.255.6.229
</pre>

== Preparation Steps ==

=== vCenter / ESXi - Shutdown the virtual machine ===

Because you will be restoring a disk image you will need to shut down the virtual machine. You will do this by logging into vCenter (or ESXi in some instances), navigating the the virtual machine, and powering it off. You may want to shut down from the OS, however the disk will be replaced, so disk consistency isn't important. You may just use vSphere to power it off rather than shutting it down.

=== vCenter / ESXi - Verify disk location ===

In vCenter (or ESXi), browse to the virtual machine, and identify where the hard drive is stored. You can usually do this by viewing the virtual machine hardware stats, but you may have to look in the actual settings.

[[File:VM Hardware view.png]]

or

[[File:VM_Edit_Disk.png]]

In this case, we are looking for volume den1_datastore_2 and path /den1-mfa1.

=== Verify files from the helper machine ===

Log into the helper machine, and verify the files.

<pre>
$ ssh 10.255.6.228
sfiggins@10.255.6.228's password:
Last login: Wed Nov 16 09:58:06 2022 from 10.255.22.138
[sfiggins@test-centos ~]$ cd /mnt/den1_datastore_2/den1-mfa1
[sfiggins@test-centos den1-mfa1]$ ls -la
total 39304696
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 207 root root 20480 Nov 16 12:30 ..
-rw-------. 1 root root 2483105792 Nov 16 12:38 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:38 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 280951 Nov 16 12:33 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

In this case, we are looking for the latest disk file. For this machine, which contains an vSphere snapshot, we are wanting to address the '''den1-mfa1-000001-delta.vmdk''' file.

NOTE: In vSphere, you will not see this file, and it will show you the WRONG file.

[[File:VM Datastore Disk.png]]

In another machine, no snapshot exists, we re restore a different file.

<pre>
[sfiggins@test-centos den1-kafka2]$ ls -la
total 101769292
drwxr-xr-x. 2 root root 4096 Jun 21 09:51 .
drwxr-xr-x. 209 root root 20480 Nov 16 12:56 ..
-rw-------. 1 root root 70866960384 Nov 16 12:57 den1-kafka2_1-flat.vmdk
-rw-------. 1 root root 480 Jun 21 09:04 den1-kafka2_1.vmdk
-rw-r--r--. 1 root root 92 Aug 18 2021 den1-kafka2-65e69988.hlog
-rw-------. 1 root root 8589934592 Apr 1 2021 den1-kafka2-8861827a.vswp
-rw-------. 1 root root 38654705664 Nov 16 12:57 den1-kafka2-flat.vmdk
-rw-------. 1 root root 8684 Apr 16 2021 den1-kafka2.nvram
-rw-------. 1 root root 554 Jun 21 09:51 den1-kafka2.vmdk
-rw-r--r--. 1 root root 43 Jun 21 09:51 den1-kafka2.vmsd
-rwxr-xr-x. 1 root root 3510 Jun 21 09:51 den1-kafka2.vmx
-rw-------. 1 root root 0 Aug 18 2021 den1-kafka2.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-3d69bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-4369bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-7a40bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-cb72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 12:57 .lck-ef05bf5000000000
-rw-------. 1 root root 203317 Jan 19 2021 vmware-2.log
-rw-r--r--. 1 root root 197120 Mar 30 2021 vmware-3.log
-rw-r--r--. 1 root root 196887 Apr 1 2021 vmware-4.log
-rw-r--r--. 1 root root 247564 Apr 16 2021 vmware-5.log
-rw-r--r--. 1 root root 235945 Aug 12 2021 vmware-6.log
-rw-r--r--. 1 root root 232223 Aug 18 2021 vmware-7.log
-rw-r--r--. 1 root root 292598 Jun 21 09:51 vmware.log
-rw-------. 1 root root 90177536 Aug 18 2021 vmx-den1-kafka2-2288091770-2.vswp
</pre>

Here, we see that we would neet to restore '''den1-kafka2_1-flat.vmdk''', however in vSphere, it is only going to look like '''den1-kafka2_1.vmdk'''. Make sure you restore the correct file.

[[File:VM_Other_Disk_file.png]]

=== Validate Snapshots ===

On the NetApp, validate the snapshot you want to restore. In this case, we are looking for volume '''den1_datastore_2''' on vfiler '''DEN1-VFILER-1'''.

<pre>
DEN1-AFF220::> volume snapshot show -vserver DEN1-VFILER-1 -volume den1_datastore_2
---Blocks---
Vserver Volume Snapshot Size Total% Used%
-------- -------- ------------------------------------- -------- ------ -----
DEN1-VFILER-1
den1_datastore_2
weekly.2022-10-02_0015 634.9GB 4% 9%
weekly.2022-10-09_0015 606.6GB 4% 9%
weekly.2022-10-16_0015 602.4GB 4% 9%
weekly.2022-10-23_0015 471.7GB 3% 7%
weekly.2022-10-30_0015 572.7GB 3% 8%
weekly.2022-11-06_0015 534.7GB 3% 8%
daily.2022-11-11_0010 469.2GB 3% 7%
daily.2022-11-12_0010 499.2GB 3% 7%
daily.2022-11-13_0010 131.5MB 0% 0%
weekly.2022-11-13_0015 357.3GB 2% 5%
daily.2022-11-14_0010 249.3GB 2% 4%
daily.2022-11-15_0010 558.2GB 3% 8%
daily.2022-11-16_0010 292.2GB 2% 4%
hourly.2022-11-16_0705 480.8MB 0% 0%
hourly.2022-11-16_0805 79.08GB 0% 1%
hourly.2022-11-16_0905 418.2MB 0% 0%
hourly.2022-11-16_1005 447.4MB 0% 0%
hourly.2022-11-16_1105 102.8GB 1% 2%
hourly.2022-11-16_1205 78.97GB 0% 1%
hourly.2022-11-16_1305 631.0MB 0% 0%
hourly.2022-11-16_1405 93.64GB 1% 1%
hourly.2022-11-16_1505 94.00GB 1% 1%
hourly.2022-11-16_1605 139.0GB 1% 2%
hourly.2022-11-16_1905 336.8MB 0% 0%
hourly.2022-11-16_2005 0B 0% 0%
25 entries were displayed.
</pre>

From here, we pick the snapshot we wish to restore from. Let's sy we want to restore from '''daily.2022-11-15_0010'''.

NOTE: Times may be in UTC. Be aware of the time zone and restore from the correct snapshot.

=== View Files in Snapshot ===

View the files on the helper machine to ensure that you have the correct time / date attributes for that you want to restore.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/.snapshot/daily.2022-11-15_0010/den1-mfa1/
total 35676064
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Here, you can see that our target file '''den1-mfa1-000001-delta.vmdk''' has a date that is attractive to us.

== Restore from Snapshot ==

Not you should be able to restore from the snapshot.

'''NOTE: THIS SYNTAX IS VERY CRITICAL, OR YOU WILL HAVE A BAD DAY!'''

=== Single file ===

From the NetApp Console:

<pre>
DEN1-AFF220::> volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-000001-delta.vmdk
</pre>

From the Helper:

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
total 39307912
drwxr-xr-x. 2 root root 4096 Nov 16 12:03 .
drwxr-xr-x. 211 root root 20480 Nov 16 13:20 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 353 Nov 16 12:02 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Nov 16 11:52 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 8603590692 Nov 16 11:53 den1-mfa1-Snapshot5.vmsn
-rw-------. 1 root root 552 Nov 16 10:50 den1-mfa1.vmdk
-rw-------. 1 root root 474 Nov 16 11:52 den1-mfa1.vmsd
-rwx------. 1 root root 3817 Nov 16 12:03 den1-mfa1.vmx
-rw-------. 1 root root 47 Nov 16 12:02 den1-mfa1.vmxf
-rw-------. 1 root root 0 Nov 16 10:28 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5627bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-5727bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-db2fbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dc0dbf5000000000
-rwxrwxr-x. 1 root root 92 Nov 16 13:30 .lck-dd2fbf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware-12.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 281027 Nov 16 12:55 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
-rw-------. 1 root root 90177536 Nov 16 10:28 vmx-den1-mfa1-3492578607-2.vswp
</pre>

The file has been restored, and you can now bring the virtual machine back up.

NOTE: In this partucular case, it looks like the '''den1-mfa1-000001.vmdk''' file is newer, and may need to be restored from teh same snapshot. This is not always the case, and is particular to the machine used in this example. This machine had the vSphere snapshot removed and then a new one created after the NetApp snapshot.

=== Whole Directory ===

There is no single command to restore an entire directory from a snapshot. The easiest way would be to restore each file, however you may want to do some additional work to ensure that it works well, If our example above, the number of files is small enough to do it by hand, however if you are dealing with many more files, you may want to use a script to generate the commands, or use an alternative / slower method that will work on directories. I'll include that in another section.

From the helper machine, we will rename the old directory as a safegard and then create a new one to restore to.

<pre>
[sfiggins@test-centos den1-mfa1]$ sudo mv /mnt/den1_datastore_2/den1-mfa1{,.old}
[sfiggins@test-centos den1-mfa1]$ sudo nkdir /mnt/den1_datastore_2/den1-mfa1
</pre>

From the NetApp console, you will run the restore-file command for each file.

<pre>
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-d02c852f.vswp
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-flat.vmdk
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.nvram
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1-Snapshot4.vmsn
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmdk
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmsd
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/den1-mfa1.vmx.lck
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-2d07bf5000000000
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5470bf5000000000
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-5870bf5000000000
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-6070bf5000000000
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/.lck-9e72bf5000000000
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-10.log
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-11.log
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-6.log
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-7.log
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-8.log
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware-9.log
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmware.log
volume snapshot restore-file -vserver DEN1-VFILER-1 -volume den1_datastore_2 -snapshot daily.2022-11-15_0010 -path /den1-mfa1/vmx-den1-mfa1-3492578607-1.vswp
</pre>

Now you can verify the restore from the helper machine.

<pre>
[sfiggins@test-centos den1-mfa1]$ ls -la /mnt/den1_datastore_2/den1-mfa1/
drwxr-xr-x. 2 root root 4096 Jun 2 22:05 .
drwxr-xr-x. 176 root root 20480 Nov 14 17:09 ..
-rw-------. 1 root root 7516270592 Nov 14 17:10 den1-mfa1-000001-delta.vmdk
-rw-------. 1 root root 299 Jun 2 22:05 den1-mfa1-000001.vmdk
-rw-r--r--. 1 root root 92 Aug 12 2021 den1-mfa1-5c17aff3.hlog
-rw-------. 1 root root 8589934592 Mar 22 2022 den1-mfa1-d02c852f.vswp
-rw-------. 1 root root 38654705664 Jun 2 22:05 den1-mfa1-flat.vmdk
-rw-------. 1 root root 8684 Mar 22 2022 den1-mfa1.nvram
-rw-------. 1 root root 20621 Jun 2 22:05 den1-mfa1-Snapshot4.vmsn
-rw-------. 1 root root 552 May 9 2022 den1-mfa1.vmdk
-rw-------. 1 root root 387 Jun 2 22:05 den1-mfa1.vmsd
-rwx------. 1 root root 3599 Jun 2 22:05 den1-mfa1.vmx
-rw-------. 1 root root 0 Mar 22 2022 den1-mfa1.vmx.lck
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-2d07bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5470bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-5870bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-6070bf5000000000
-rwxrwxr-x. 1 root root 92 Nov 14 17:09 .lck-9e72bf5000000000
-rw-r--r--. 1 root root 235283 Mar 22 2022 vmware-10.log
-rw-------. 1 root root 242976 Mar 22 2022 vmware-11.log
-rw-r--r--. 1 root root 205083 Mar 31 2021 vmware-6.log
-rw-r--r--. 1 root root 201190 Apr 1 2021 vmware-7.log
-rw-r--r--. 1 root root 402360 Apr 16 2021 vmware-8.log
-rw-r--r--. 1 root root 249333 Aug 12 2021 vmware-9.log
-rw-------. 1 root root 248885 Jun 2 22:05 vmware.log
-rw-------. 1 root root 90177536 Mar 22 2022 vmx-den1-mfa1-3492578607-1.vswp
</pre>

Success! You can restore power on your virtual machine.

File:VM Other Disk file.png

2022-11-16T20:03:13Z

Sfiggins:

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T20:02:58Z

Sfiggins: /* Verify files from the helper machine */

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T19:56:14Z

Sfiggins: /* vCenter / ESXi - Verify disk location */

File:VM Hardware view.png

2022-11-16T19:55:21Z

Sfiggins:

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T19:52:34Z

Sfiggins: /* Verify files from the helper machine */

File:VM Datastore Disk.png

2022-11-16T19:49:52Z

Sfiggins:

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T19:49:34Z

Sfiggins: /* Verify files from the helper machine */

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T19:48:26Z

Sfiggins: /* vCenter / ESXi - Verify disk location */

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T19:45:52Z

Sfiggins: /* vCenter / ESXi - Verify disk location */

File:VM Edit Disk.png

2022-11-16T19:44:59Z

Sfiggins:

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T19:44:24Z

Sfiggins: /* vCenter / ESXi - Verify disk location */

User:Sfiggins/NetApp Snapshot Restore Instructions

2022-11-16T19:43:04Z

Sfiggins: Created page with " = Instructions on how to restore from NetApp Snapshot for ESXi machines = == Basic Information == === Helper Virtual Machines === These are machines that you will need to..."

User:Sfiggins/Teams & S4B Powershell

2021-03-17T01:49:34Z

Sfiggins: /* Assign "Microsoft" as the Conference Provider */

== Set Execution Policy ==

Start Powershell as administrator.

Run Set-ExecutionPolicy command.

<pre>
PS C:\> Set-ExecutionPolicy -ExecutionPolicy Bypass

Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose
you to the security risks described in the about_Execution_Policies help topic at
https:/go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): A
</pre>

Verify that the policy took affect.

<pre>
PS C:\> Get-ExecutionPolicy -List

Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser Undefined
LocalMachine Bypass
</pre>

== Install MS Teams Powershell Module ==

In powershell, run the following.

<pre>
PS C:\> Install-Module MicrosoftTeams

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
</pre>

https://docs.microsoft.com/en-us/microsoftteams/teams-powershell-install

== Connect / login to the MS Teams / S4B Connector ==

'''You can do the rest as the a non-administrator user.'''

<pre>
Import-Module MicrosoftTeams
$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential
</pre>

== Assign "Microsoft" as the Conference Provider ==

Run the '''Enable-CsOnlineDialInConferencingUser''' to turn on Microsoft's Audio conferncing.

<pre>
PS C:\> Enable-CsOnlineDialInConferencingUser -Identity "user@labrats.us" -ReplaceProvider

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
Identity : user@labrats.us
SipAddress : sip:user@labrats.us
ServiceNumber : 17203709609
TollFreeServiceNumber :
ConferenceId : 0
BridgeId : f862865b-d49e-42be-8c67-1952c9ca8644
BridgeName : Conference Bridge
Tenant : ce701975-2de8-4dbf-a876-0ab0e031fa9c
AllowPstnOnlyMeetings : False
AllowTollFreeDialIn : True
LeaderPin : *****
</pre>

You can also tun the following script that will make it a little nicer to run and give output.

<pre>
PS C:\> .\Script.ps1 -userlist "user@labrats.us"
Number of users to have their audio conferencing provider set to Microsoft: 1
WARNING: "OriginalRegistrarPool" with identity "1972340558" assigned to "sip:user@labrats.us" has been
removed from configuration store.
The provider of user@labrats.us has changed to Microsoft.

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
Identity : ab2cf895-db4a-4a27-9e6a-74154fbed58b
SipAddress : sip:user@labrats.us
ServiceNumber : 17203709609
TollFreeServiceNumber :
ConferenceId : 0
BridgeId : f862865b-d49e-42be-8c67-1952c9ca8644
BridgeName : Conference Bridge
Tenant : ce701975-2de8-4dbf-a876-0ab0e031fa9c
AllowPstnOnlyMeetings : False
AllowTollFreeDialIn : True
LeaderPin : 50554

</pre>

Contents of the script:

<pre>
<#
.SYNOPSIS

This is a PowerShell script to set Microsoft as the audio conferencing provider of a set of users. It's required for applicable users to have a valid PSTN Conferencing license assigned before their provider is changed.

.DESCRIPTION
This is a PowerShell script to set Microsoft as the audio conferencing provider of a set of users. It's required for applicable users to have a valid PSTN Conferencing license assigned before their provider is changed.

.EXAMPLE

./Script.ps1 -UserList "user01@constoso.com, user02@contoso.com, user03@contoso.com"
./Script.ps1 -CsvFile ".\\CsvFile.csv"
./Script.ps1 -ACPProviderName ""Intercall""
#>
param (
[Parameter(Mandatory = $true, ParameterSetName = "CsvFile")]
[string]$CsvFile,
[Parameter(Mandatory = $true, ParameterSetName = "UserList")]
[string]$UserList,
[Parameter(Mandatory = $true, ParameterSetName = "ACPProviderName")]
[string]$ACPProviderName
)
if ($CsvFile)
{
if(!(Test-Path $CsvFile))
{
Write-Error "File does not exist."
Exit
}
$users = Get-Content $CsvFile
}
if ($UserList)
{
$users = $UserList.Split(",")
}
if ($ACPProviderName)
{
$supportedACPProviders = Get-csAudioConferencingProvider
$providerNameMatch = $supportedACPProviders | ?{$_.Identity -eq $ACPProviderName}
if ($providerNameMatch -eq $null)
{
Write-Host "The provider name is not from a supported provider, please use any of the following values: "
$supportedACPProviders | %{$_.Identity}
return
}
$allUsersInTenant = Get-csOnlineUser
$users = $allUsersInTenant | ?{$_.AcpInfo -ne $null -and $_.ACPInfo.Name -eq $ACPProviderName}
}
Write-Host "Number of users to have their audio conferencing provider set to Microsoft: " $users.count
foreach ($user in $users)
{
if ($CsvFile -or $UserList)
{
try
{
$adUser = Get-csOnlineUser -Identity $user
}
catch
{
Write-Error "There was an exception while retrieving user: $user. " $error[0].Exception.Message
Continue
}
}
else
{
$adUser = $user
}
if ($adUser -ne $null -and ($adUser.OnlineDialInConferencingPOlicy -ne $null))
{
if ($adUser.AcpInfo -eq $null -Or $adUser.AcpInfo.Name -ne "Microsoft")
{
try
{
$enableUser = Enable-CsOnlineDialInConferencingUser -Identity $adUser.ObjectId -Tenant $adUser.TenantId -ReplaceProvider
Write-Host "The provider of $user has changed to Microsoft."
$enableUser
}
catch
{
Write-Error "There was an exception while enabling user: $user. " $error[0].Exception.Message
continue;
}
}
else
{
Write-Warning "The provider of $user is already set to Microsoft."
}
}
else
{
Write-Error "$user does not have valid Audio Conferencing license assigned."
}
}
</pre>

== Verify Settings as Microsoft ==

<pre>
PS C:\> Get-CsUserAcp -Identity "user@labrats.us"

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
AcpInfo : {<acpInformation default="true">
<tollNumber>17203709609</tollNumber>
<participantPassCode>0</participantPassCode>
<domain>resources.lync.com</domain>
<name>Microsoft</name>
<url>https://dialin.lync.com/f862865b-d49e-42be-8c67-1952c9ca8644</url>
</acpInformation>}
Name : ab2cf895-db4a-4a27-9e6a-74154fbed58b
DistinguishedName : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Identity : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Guid : 8d53d4fe-e7e2-4a73-ad0f-1cc20ae06593
ObjectCategory : CN=Person,CN=Schema,CN=Configuration,DC=lync0a001,DC=local
ObjectClass : {top, person, organizationalPerson, user}
WhenChanged : 3/16/2021 6:54:45 PM
WhenCreated : 1/28/2016 8:16:30 AM
OriginatingServer : WU20A00ADS01.lync0a001.local
IsByPassValidation : False
IsValid : True
ObjectState : Unchanged
</pre>

== Set User to use PGI as Conference Provider ==

First, you may need to remove the configuration for the user.

<pre>
PS C:\> Remove-CsUserAcp -Identity "user@labrats.us"
</pre>

Verify that the configuration was removed.

<pre>
PS C:\> Get-CsUserAcp -Identity "user@labrats.us"

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
AcpInfo : {}
Name : ab2cf895-db4a-4a27-9e6a-74154fbed58b
DistinguishedName : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Identity : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Guid : 8d53d4fe-e7e2-4a73-ad0f-1cc20ae06593
ObjectCategory : CN=Person,CN=Schema,CN=Configuration,DC=lync0a001,DC=local
ObjectClass : {top, person, organizationalPerson, user}
WhenChanged : 3/16/2021 7:07:43 PM
WhenCreated : 1/28/2016 8:16:30 AM
OriginatingServer : WU20A00ADS01.lync0a001.local
IsByPassValidation : False
IsValid : True
ObjectState : Unchanged
</pre>

Next, you can set the user to PGI.

<pre>
PS C:\> Set-CsUserAcp -Identity "user@labrats.us" -TollNumber "16054755602" `
-TollFreeNumber '17127704201' -ParticipantPassCode 981705 -Domain "lync.pgi.com" `
-Name "PGi" -Url "http://www.pgi.com/lynconline/localnums.php"
</pre>

Verifying the user was set to PGI.

<pre>
PS C:\> Get-CsUserAcp -Identity "user@labrats.us"

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
AcpInfo : {<acpInformation>
<tollNumber>1 (712) 770-4201</tollNumber>
<participantPassCode>981705</participantPassCode>
<domain>lync.pgi.com</domain>
<name>PGi</name>
<url>http://www.pgi.com/lynconline/localnums.php</url>
</acpInformation>}
Name : ab2cf895-db4a-4a27-9e6a-74154fbed58b
DistinguishedName : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Identity : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Guid : 8d53d4fe-e7e2-4a73-ad0f-1cc20ae06593
ObjectCategory : CN=Person,CN=Schema,CN=Configuration,DC=lync0a001,DC=local
ObjectClass : {top, person, organizationalPerson, user}
WhenChanged : 3/16/2021 7:07:58 PM
WhenCreated : 1/28/2016 8:16:30 AM
OriginatingServer : WU20A00ADS01.lync0a001.local
IsByPassValidation : False
IsValid : True
ObjectState : Unchanged
</pre>

User:Sfiggins/Teams & S4B Powershell

2021-03-17T01:28:56Z

Sfiggins: /* Assign "Microsoft" as the Conference Provider */

== Set Execution Policy ==

Start Powershell as administrator.

Run Set-ExecutionPolicy command.

<pre>
PS C:\> Set-ExecutionPolicy -ExecutionPolicy Bypass

Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose
you to the security risks described in the about_Execution_Policies help topic at
https:/go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): A
</pre>

Verify that the policy took affect.

<pre>
PS C:\> Get-ExecutionPolicy -List

Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser Undefined
LocalMachine Bypass
</pre>

== Install MS Teams Powershell Module ==

In powershell, run the following.

<pre>
PS C:\> Install-Module MicrosoftTeams

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
</pre>

https://docs.microsoft.com/en-us/microsoftteams/teams-powershell-install

== Connect / login to the MS Teams / S4B Connector ==

'''You can do the rest as the a non-administrator user.'''

<pre>
Import-Module MicrosoftTeams
$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential
</pre>

== Assign "Microsoft" as the Conference Provider ==

<pre>
PS C:\> .\script.ps1 -userlist "user@labrats.us"
Number of users to have their audio conferencing provider set to Microsoft: 1
WARNING: "OriginalRegistrarPool" with identity "1972340558" assigned to "sip:user@labrats.us" has been
removed from configuration store.
The provider of user@labrats.us has changed to Microsoft.

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
Identity : ab2cf895-db4a-4a27-9e6a-74154fbed58b
SipAddress : sip:user@labrats.us
ServiceNumber : 17203709609
TollFreeServiceNumber :
ConferenceId : 0
BridgeId : f862865b-d49e-42be-8c67-1952c9ca8644
BridgeName : Conference Bridge
Tenant : ce701975-2de8-4dbf-a876-0ab0e031fa9c
AllowPstnOnlyMeetings : False
AllowTollFreeDialIn : True
LeaderPin : 50554

</pre>

Contents of the script:

<pre>
<#
.SYNOPSIS

This is a PowerShell script to set Microsoft as the audio conferencing provider of a set of users. It's required for applicable users to have a valid PSTN Conferencing license assigned before their provider is changed.

.DESCRIPTION
This is a PowerShell script to set Microsoft as the audio conferencing provider of a set of users. It's required for applicable users to have a valid PSTN Conferencing license assigned before their provider is changed.

.EXAMPLE

./Script.ps1 -UserList "user01@constoso.com, user02@contoso.com, user03@contoso.com"
./Script.ps1 -CsvFile ".\\CsvFile.csv"
./Script.ps1 -ACPProviderName ""Intercall""
#>
param (
[Parameter(Mandatory = $true, ParameterSetName = "CsvFile")]
[string]$CsvFile,
[Parameter(Mandatory = $true, ParameterSetName = "UserList")]
[string]$UserList,
[Parameter(Mandatory = $true, ParameterSetName = "ACPProviderName")]
[string]$ACPProviderName
)
if ($CsvFile)
{
if(!(Test-Path $CsvFile))
{
Write-Error "File does not exist."
Exit
}
$users = Get-Content $CsvFile
}
if ($UserList)
{
$users = $UserList.Split(",")
}
if ($ACPProviderName)
{
$supportedACPProviders = Get-csAudioConferencingProvider
$providerNameMatch = $supportedACPProviders | ?{$_.Identity -eq $ACPProviderName}
if ($providerNameMatch -eq $null)
{
Write-Host "The provider name is not from a supported provider, please use any of the following values: "
$supportedACPProviders | %{$_.Identity}
return
}
$allUsersInTenant = Get-csOnlineUser
$users = $allUsersInTenant | ?{$_.AcpInfo -ne $null -and $_.ACPInfo.Name -eq $ACPProviderName}
}
Write-Host "Number of users to have their audio conferencing provider set to Microsoft: " $users.count
foreach ($user in $users)
{
if ($CsvFile -or $UserList)
{
try
{
$adUser = Get-csOnlineUser -Identity $user
}
catch
{
Write-Error "There was an exception while retrieving user: $user. " $error[0].Exception.Message
Continue
}
}
else
{
$adUser = $user
}
if ($adUser -ne $null -and ($adUser.OnlineDialInConferencingPOlicy -ne $null))
{
if ($adUser.AcpInfo -eq $null -Or $adUser.AcpInfo.Name -ne "Microsoft")
{
try
{
$enableUser = Enable-CsOnlineDialInConferencingUser -Identity $adUser.ObjectId -Tenant $adUser.TenantId -ReplaceProvider
Write-Host "The provider of $user has changed to Microsoft."
$enableUser
}
catch
{
Write-Error "There was an exception while enabling user: $user. " $error[0].Exception.Message
continue;
}
}
else
{
Write-Warning "The provider of $user is already set to Microsoft."
}
}
else
{
Write-Error "$user does not have valid Audio Conferencing license assigned."
}
}
</pre>

== Verify Settings as Microsoft ==

<pre>
PS C:\> Get-CsUserAcp -Identity "user@labrats.us"

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
AcpInfo : {<acpInformation default="true">
<tollNumber>17203709609</tollNumber>
<participantPassCode>0</participantPassCode>
<domain>resources.lync.com</domain>
<name>Microsoft</name>
<url>https://dialin.lync.com/f862865b-d49e-42be-8c67-1952c9ca8644</url>
</acpInformation>}
Name : ab2cf895-db4a-4a27-9e6a-74154fbed58b
DistinguishedName : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Identity : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Guid : 8d53d4fe-e7e2-4a73-ad0f-1cc20ae06593
ObjectCategory : CN=Person,CN=Schema,CN=Configuration,DC=lync0a001,DC=local
ObjectClass : {top, person, organizationalPerson, user}
WhenChanged : 3/16/2021 6:54:45 PM
WhenCreated : 1/28/2016 8:16:30 AM
OriginatingServer : WU20A00ADS01.lync0a001.local
IsByPassValidation : False
IsValid : True
ObjectState : Unchanged
</pre>

== Set User to use PGI as Conference Provider ==

First, you may need to remove the configuration for the user.

<pre>
PS C:\> Remove-CsUserAcp -Identity "user@labrats.us"
</pre>

Verify that the configuration was removed.

<pre>
PS C:\> Get-CsUserAcp -Identity "user@labrats.us"

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
AcpInfo : {}
Name : ab2cf895-db4a-4a27-9e6a-74154fbed58b
DistinguishedName : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Identity : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Guid : 8d53d4fe-e7e2-4a73-ad0f-1cc20ae06593
ObjectCategory : CN=Person,CN=Schema,CN=Configuration,DC=lync0a001,DC=local
ObjectClass : {top, person, organizationalPerson, user}
WhenChanged : 3/16/2021 7:07:43 PM
WhenCreated : 1/28/2016 8:16:30 AM
OriginatingServer : WU20A00ADS01.lync0a001.local
IsByPassValidation : False
IsValid : True
ObjectState : Unchanged
</pre>

Next, you can set the user to PGI.

<pre>
PS C:\> Set-CsUserAcp -Identity "user@labrats.us" -TollNumber "16054755602" `
-TollFreeNumber '17127704201' -ParticipantPassCode 981705 -Domain "lync.pgi.com" `
-Name "PGi" -Url "http://www.pgi.com/lynconline/localnums.php"
</pre>

Verifying the user was set to PGI.

<pre>
PS C:\> Get-CsUserAcp -Identity "user@labrats.us"

RunspaceId : 90419993-79b4-4c75-b7c7-f6e06e4676fc
AcpInfo : {<acpInformation>
<tollNumber>1 (712) 770-4201</tollNumber>
<participantPassCode>981705</participantPassCode>
<domain>lync.pgi.com</domain>
<name>PGi</name>
<url>http://www.pgi.com/lynconline/localnums.php</url>
</acpInformation>}
Name : ab2cf895-db4a-4a27-9e6a-74154fbed58b
DistinguishedName : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Identity : CN=ab2cf895-db4a-4a27-9e6a-74154fbed58b,OU=ce701975-2de8-4dbf-a876-0ab0e031fa9c,OU=OCS
Tenants,DC=lync0a001,DC=local
Guid : 8d53d4fe-e7e2-4a73-ad0f-1cc20ae06593
ObjectCategory : CN=Person,CN=Schema,CN=Configuration,DC=lync0a001,DC=local
ObjectClass : {top, person, organizationalPerson, user}
WhenChanged : 3/16/2021 7:07:58 PM
WhenCreated : 1/28/2016 8:16:30 AM
OriginatingServer : WU20A00ADS01.lync0a001.local
IsByPassValidation : False
IsValid : True
ObjectState : Unchanged
</pre>

User:Sfiggins/Teams & S4B Powershell

2021-03-17T01:27:06Z

Sfiggins: /* Set User to use PGI as Conference Provider */

User:Sfiggins/Teams & S4B Powershell

2021-03-17T01:21:48Z

Sfiggins: Created page with "== Set Execution Policy == Start Powershell as administrator. Run Set-ExecutionPolicy command. <pre> PS C:\> Set-ExecutionPolicy -ExecutionPolicy Bypass Execution Policy C..."

User:Sfiggins/AWS IAM SWITCH ROLES

2021-02-12T01:47:48Z

Sfiggins: /* Switch Roles */

How to get into a AWS account through organizarional admin.

=== Go to AWS Console ===

https://aws.amazon.com/console/

=== Log in as IAM user ===

Click on "Sign In to the Console"

[[File:IAM_LOGIN1.png|none|frame|Login Button]]

Enter Account ID, IAM user name and Password and click "Sign in" button.

[[File:IAM_LOGIN2.png|none|frame|Login Dialogue]]

=== Switch Roles ===

Click on the account name on the top and then on "Switch Roles".

[[File:IAM_LOGIN3.png|none|frame|Core Sound Packages]]

Enter the target Account number, and role. Default role is "OrganizationalAccountAccessRole". Click on "Switch Role" to continue.

[[File:IAM_LOGIN4.png|none|frame|Core Sound Packages]]

=== Enjoy ===

User:Sfiggins/AWS IAM SWITCH ROLES

2021-02-12T01:44:18Z

Sfiggins: /* Log in as IAM user */

User:Sfiggins/AWS IAM SWITCH ROLES

2021-02-12T01:42:38Z

Sfiggins: /* Log in as IAM user */

User:Sfiggins/AWS IAM SWITCH ROLES

2021-02-12T00:44:25Z

Sfiggins:

File:IAM LOGIN4.png

2021-02-12T00:42:32Z

Sfiggins:

File:IAM LOGIN3.png

2021-02-12T00:41:51Z

Sfiggins:

File:IAM LOGIN2.png

2021-02-12T00:41:31Z

Sfiggins:

File:IAM LOGIN1.png

2021-02-12T00:40:37Z

Sfiggins:

User:Sfiggins/AWS IAM SWITCH ROLES

2021-02-12T00:39:13Z

Sfiggins:

User:Sfiggins/AWS IAM SWITCH ROLES

2021-02-12T00:34:10Z

Sfiggins: Created page with "How to get into a AWS account through organizarional admin. === Go to AWS Console === https://aws.amazon.com/console/ === Log in as IAM user ==="

How to get into a AWS account through organizarional admin.

=== Go to AWS Console ===

https://aws.amazon.com/console/

=== Log in as IAM user ===

User:Sfiggins/Asterisk 18 on CentOS7

2020-12-05T02:32:36Z

Sfiggins: /* Version 1.8 to 18.1.0 Errors */

= Install and Configure Base OS =

== Install from CentOS 7 CD (Minimal Install) ==

== Log into newly installed server ==

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
sfiggins@cn38-inverness-co.suburbanbroadband.net's password:
</pre>

== Setting up PSK login access, if desired ==

=== Copy authorized_keys from another server ===

I have another server that already has my authorized keys, so I"ll copy it from there. You can also past in your RSA key into '''~/.ssh/authorized_keys''', if you prefer.

<pre>
[sfiggins@cn38-inverness-co ~]$ scp -r 216.112.193.138:.ssh/ .

The authenticity of host '216.112.193.138 (216.112.193.138)' can't be established.
RSA key fingerprint is 5f:61:91:46:5c:c8:4c:a1:2e:25:0b:61:1e:97:d9:ed.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '216.112.193.138' (RSA) to the list of known hosts.
sfiggins@216.112.193.138's password:
known_hosts 100% 397 0.4KB/s 00:00
authorized_keys 100% 414 0.4KB/s 00:00

[sfiggins@cn38-inverness-co ~]$ logout
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

=== Login in using private key ===

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
Last login: Wed Dec 2 17:21:54 2020 from 209.116.189.54
</pre>

== Sudo to Root ==

All the installation steps in this guide must be performed as root. You can either prefix each command with '''"sudo"''' or just use sudo to become the '''root''' account and execute them as listed.

<pre>
[sfiggins@cn38-inverness-co ~]$ sudo su -

We trust you have received the usual lecture from the local System
Administrator. It usually boils down to these three things:

#1) Respect the privacy of others.
#2) Think before you type.
#3) With great power comes great responsibility.

[sudo] password for sfiggins:
Last login: Wed Dec 2 16:46:45 MST 2020 on tty1
</pre>

== Fix Sudoers ==

This fix will remove the need to reenter your puser password when running the '''"sudo"''' command. This is a preference, and does not need to be done if you prefer to enter the password each time.

<pre>
[root@cn38-inverness-co ~]# vi /etc/sudoers
</pre>

Comment out the below matching line, by adding '''"# "''' in beginning of the line.

<pre>
%wheel ALL=(ALL) ALL
</pre>

Remove the comment from the below matching line by removing the '''"# "''' from the beginning of the line.

<pre>
# %wheel ALL=(ALL) NOPASSWD: ALL
</pre>

Save this file using the '''":wq!"''' command, as this file is read-only.

== Disable and remove NetworkManager ==

The '''NetworkManager''' packages are not needed on a Linux server and they just get in the way. Removing them is the best option. They are more useful on a workstation that will be changing networks frequently.

<pre>
[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager

rm '/etc/systemd/system/multi-user.target.wants/NetworkManager.service'
rm '/etc/systemd/system/dbus-org.freedesktop.nm-dispatcher.service'
rm '/etc/systemd/system/dbus-org.freedesktop.NetworkManager.service'

[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager-dispatcher

[root@cn38-inverness-co ~]# yum erase NetworkManager-tui NetworkManager-glib NetworkManager

Loaded plugins: fastestmirror
No Match for argument: NetworkManager-glib
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
---> Package NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
NetworkManager x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 8.8 M
NetworkManager-tui x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 258 k

Transaction Summary
==============================================================================================================
Remove 2 Packages

Installed size: 9.1 M
Is this ok [y/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Erasing : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2
Verifying : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Verifying : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2

Removed:
NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7
NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7

Complete!
</pre>

== Disable SELinux ==

This mostly gets in the way, and we will disable it. There are steps that can be taken to leave this intact and functioning and still allow the system to function propperly, but I'll not discuss that here.

<pre>
[root@cn38-inverness-co ~]# setenforce 0
[root@cn38-inverness-co ~]# sed -i.bak "s/^SELINUX=.*/SELINUX=disabled/g" /etc/selinux/config
</pre>

== Update System Packages ==

Update the system packages. Some of the later steps will require give errors depending on system package levels that are available, and it is just good measure to make sure the latest packages are installed.

<pre>
[root@cn38-inverness-co ~]# yum -y update

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager-libnm.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be updated

=== SNIP ===

---> Package libstdc++.i686 0:4.8.5-44.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:

=== SNIP ===

Updating:

=== SNIP ===

Installing for dependencies:

=== SNIP ===

Transaction Summary
==============================================================================================================
Install 8 Packages (+47 Dependent packages)
Upgrade 240 Packages

Total size: 325 M
Total download size: 275 M
Downloading packages:
Delta RPMs disabled because /usr/bin/applydeltarpm not installed.
(1/230): acl-2.2.51-15.el7.x86_64.rpm | 81 kB 00:00:00

=== SNIP ===

(230/230): tzdata-2020d-2.el7.noarch.rpm | 499 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 17 MB/s | 275 MB 00:00:16
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Updating : libgcc-4.8.5-44.el7.x86_64 1/539
Installing : 1:grub2-common-2.02-0.86.el7.centos.noarch 2/539
Updating : centos-release-7-9.2009.1.el7.centos.x86_64 3/539

=== SNIP ===

Installing : rdma-core-22.4-5.el7.i686 295/539
Cleanup : tuned-2.4.1-1.el7.noarch 296/539

=== SNIP ===

Cleanup : 12:dhclient-4.2.5-36.el7.centos.x86_64 385/539

UPGRADE: Automatically re-enabling default systemd units:
brandbot.path
rhel-autorelabel.service
rhel-autorelabel-mark.service
rhel-configure.service
rhel-dmesg.service
rhel-domainname.service
rhel-import-state.service
rhel-loadmodules.service
rhel-readonly.service

Cleanup : initscripts-9.49.24-1.el7.x86_64 386/539

=== SNIP ===

Cleanup : libgcc-4.8.3-9.el7.x86_64 539/539
Verifying : glibc-common-2.17-317.el7.x86_64 1/539

=== SNIP ===

Verifying : 7:device-mapper-1.02.93-3.el7.x86_64 539/539

Installed:
grub2.x86_64 1:2.02-0.86.el7.centos grub2-tools.x86_64 1:2.02-0.86.el7.centos
grub2-tools-extra.x86_64 1:2.02-0.86.el7.centos grub2-tools-minimal.x86_64 1:2.02-0.86.el7.centos
kernel.x86_64 0:3.10.0-1160.6.1.el7 python-gobject-base.x86_64 0:3.22.0-1.el7_4.1
rdma-core.i686 0:22.4-5.el7 rdma-core.x86_64 0:22.4-5.el7

Dependency Installed:
GeoIP.x86_64 0:1.5.0-14.el7 audit-libs.i686 0:2.8.5-4.el7

=== SNIP ===

zlib.i686 0:1.2.7-18.el7

Updated:
NetworkManager-libnm.x86_64 1:1.18.8-2.el7_9

=== SNIP ===

zlib.x86_64 0:1.2.7-18.el7

Replaced:
grub2.x86_64 1:2.02-0.16.el7.centos grub2-tools.x86_64 1:2.02-0.16.el7.centos
pygobject3-base.x86_64 0:3.8.2-6.el7 rdma.noarch 0:7.1_3.17-5.el7

Complete!
</pre>

== Install Additional Packages ==

These are useful utilities that have been stripped from the base install in CentOS7. Adding these back in allows for easier troubleshooting of the server.

<pre>
[root@cn38-inverness-co ~]# yum -y install finger nc net-snmp net-snmp-perl net-snmp-utils ntp perl-Date-Manip \
perl-DBD-SQLite sssd tcp_wrappers tcpdump telnet tftp tog-pegasus traceroute \
vim-enhanced wget oddjob-mkhomedir net-tools yum-cron bind-utils

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 will be installed
--> Processing Dependency: bind-libs(x86-64) = 32:9.11.4-26.P2.el7_9.2 for package: 32:bind-utils-9.11.4-26.P2.el7_9.2.x86_64

=== SNIP ===

---> Package pcre-devel.x86_64 0:8.32-17.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bind-utils x86_64 32:9.11.4-26.P2.el7_9.2 updates 260 k

=== SNIP ===

yum-cron noarch 3.4.3-168.el7.centos base 66 k
Installing for dependencies:
autogen-libopts x86_64 5.18-5.el7 base 66 k

=== SNIP ===

zlib-devel x86_64 1.2.7-18.el7 base 50 k

Transaction Summary
==============================================================================================================
Install 21 Packages (+114 Dependent packages)

Total size: 59 M
Installed size: 166 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtalloc-2.1.16-1.el7.x86_64 1/135

=== SNIP ===

Installing : finger-0.17-52.el7.x86_64 135/135
Verifying : perl-HTTP-Tiny-0.033-3.el7.noarch 1/135

=== SNIP ===

Verifying : 2:nmap-ncat-6.40-19.el7.x86_64 135/135

Installed:
bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 finger.x86_64 0:0.17-52.el7
net-snmp.x86_64 1:5.7.2-49.el7 net-snmp-perl.x86_64 1:5.7.2-49.el7
net-snmp-utils.x86_64 1:5.7.2-49.el7 net-tools.x86_64 0:2.0-0.25.20131004git.el7
nmap-ncat.x86_64 2:6.40-19.el7 ntp.x86_64 0:4.2.6p5-29.el7.centos.2
oddjob-mkhomedir.x86_64 0:0.31.5-4.el7 perl-DBD-SQLite.x86_64 0:1.39-3.el7
perl-Date-Manip.noarch 0:6.41-2.el7 sssd.x86_64 0:1.16.5-10.el7_9.5
tcp_wrappers.x86_64 0:7.6-77.el7 tcpdump.x86_64 14:4.9.2-4.el7_7.1
telnet.x86_64 1:0.17-66.el7 tftp.x86_64 0:5.2-22.el7
tog-pegasus.x86_64 2:2.14.1-8.el7 traceroute.x86_64 3:2.0.22-2.el7
vim-enhanced.x86_64 2:7.4.629-7.el7 wget.x86_64 0:1.14-18.el7_6.1
yum-cron.noarch 0:3.4.3-168.el7.centos

Dependency Installed:
autogen-libopts.x86_64 0:5.18-5.el7

=== SNIP ===

zlib-devel.x86_64 0:1.2.7-18.el7

Complete!
</pre>

== Fix Timezone ==

This is just a preference, but it will standardize the timezone.

<pre>
[root@cn38-inverness-co ~]# rm -f /etc/localtime
[root@cn38-inverness-co ~]# ln -s /usr/share/zoneinfo/MST7MDT /etc/localtime
</pre>

== Disable RPF ==

Reverse Path Forwarding (RPF) is a security protection that will prevent inbound packets from entering an IP interface that does not have outbound routes to the source IP. It is not important to disable this if your server only has one interface, however if you have multiple network interfaces, and you may be receiving asymmetric traffic, this needs to be disabled to allow the packets to enter the system.

<pre>
[root@cn38-inverness-co ~]# echo "net.ipv4.conf.default.rp_filter = 0" > /etc/sysctl.d/rpfilter.conf
</pre>

== Install vmtools (if virtual) ==

'''Only do this step if you are installing on a virtual platform. This is not required if you are installing on bare metal.'''

<pre>
[root@cn38-inverness-co ~]# yum -y install open-vm-tools

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package open-vm-tools.x86_64 0:11.0.5-3.el7_9.1 will be installed
--> Processing Dependency: xmlsec1-openssl for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.6)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.5)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: fuse for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxslt.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxmlsec1.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libmspack.so.0()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libltdl.so.7()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Running transaction check
---> Package fuse.x86_64 0:2.9.2-11.el7 will be installed
---> Package fuse-libs.x86_64 0:2.9.2-11.el7 will be installed
---> Package libmspack.x86_64 0:0.5-0.8.alpha.el7 will be installed
---> Package libtool-ltdl.x86_64 0:2.4.2-22.el7_3 will be installed
---> Package libxslt.x86_64 0:1.1.28-6.el7 will be installed
---> Package xmlsec1.x86_64 0:1.2.20-7.el7_4 will be installed
---> Package xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
open-vm-tools x86_64 11.0.5-3.el7_9.1 updates 676 k
Installing for dependencies:
fuse x86_64 2.9.2-11.el7 base 86 k
fuse-libs x86_64 2.9.2-11.el7 base 93 k
libmspack x86_64 0.5-0.8.alpha.el7 base 64 k
libtool-ltdl x86_64 2.4.2-22.el7_3 base 49 k
libxslt x86_64 1.1.28-6.el7 base 242 k
xmlsec1 x86_64 1.2.20-7.el7_4 base 177 k
xmlsec1-openssl x86_64 1.2.20-7.el7_4 base 76 k

Transaction Summary
==============================================================================================================
Install 1 Package (+7 Dependent packages)

Total download size: 1.4 M
Installed size: 4.0 M
Downloading packages:
(1/8): fuse-2.9.2-11.el7.x86_64.rpm | 86 kB 00:00:00
(2/8): fuse-libs-2.9.2-11.el7.x86_64.rpm | 93 kB 00:00:00
(3/8): libtool-ltdl-2.4.2-22.el7_3.x86_64.rpm | 49 kB 00:00:00
(4/8): libmspack-0.5-0.8.alpha.el7.x86_64.rpm | 64 kB 00:00:00
(5/8): xmlsec1-1.2.20-7.el7_4.x86_64.rpm | 177 kB 00:00:00
(6/8): libxslt-1.1.28-6.el7.x86_64.rpm | 242 kB 00:00:00
(7/8): xmlsec1-openssl-1.2.20-7.el7_4.x86_64.rpm | 76 kB 00:00:00
(8/8): open-vm-tools-11.0.5-3.el7_9.1.x86_64.rpm | 676 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.4 MB/s | 1.4 MB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtool-ltdl-2.4.2-22.el7_3.x86_64 1/8
Installing : libxslt-1.1.28-6.el7.x86_64 2/8
Installing : xmlsec1-1.2.20-7.el7_4.x86_64 3/8
Installing : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Installing : fuse-2.9.2-11.el7.x86_64 5/8
Installing : fuse-libs-2.9.2-11.el7.x86_64 6/8
Installing : libmspack-0.5-0.8.alpha.el7.x86_64 7/8
Installing : open-vm-tools-11.0.5-3.el7_9.1.x86_64 8/8
Verifying : libmspack-0.5-0.8.alpha.el7.x86_64 1/8
Verifying : fuse-libs-2.9.2-11.el7.x86_64 2/8
Verifying : fuse-2.9.2-11.el7.x86_64 3/8
Verifying : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Verifying : libxslt-1.1.28-6.el7.x86_64 5/8
Verifying : xmlsec1-1.2.20-7.el7_4.x86_64 6/8
Verifying : open-vm-tools-11.0.5-3.el7_9.1.x86_64 7/8
Verifying : libtool-ltdl-2.4.2-22.el7_3.x86_64 8/8

Installed:
open-vm-tools.x86_64 0:11.0.5-3.el7_9.1

Dependency Installed:
fuse.x86_64 0:2.9.2-11.el7 fuse-libs.x86_64 0:2.9.2-11.el7
libmspack.x86_64 0:0.5-0.8.alpha.el7 libtool-ltdl.x86_64 0:2.4.2-22.el7_3
libxslt.x86_64 0:1.1.28-6.el7 xmlsec1.x86_64 0:1.2.20-7.el7_4
xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4

Complete!
</pre>

== Reboot Server ==

<pre>
[root@cn38-inverness-co ~]# shutdown -r now
Connection to cn38-inverness-co.suburbanbroadband.net closed by remote host.
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

== Remove old kernel ==

<pre>
[root@cn38-inverness-co ~]# rpm -qa | grep kernel

kernel-tools-libs-3.10.0-1160.6.1.el7.x86_64
kernel-headers-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-229.el7.x86_64
kernel-tools-3.10.0-1160.6.1.el7.x86_64

[root@cn38-inverness-co ~]# yum -y erase kernel-3.10.0-229.el7.x86_64

Loaded plugins: fastestmirror
Resolving Dependencies
--> Running transaction check
---> Package kernel.x86_64 0:3.10.0-229.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
kernel x86_64 3.10.0-229.el7 @anaconda 131 M

Transaction Summary
==============================================================================================================
Remove 1 Package

Installed size: 131 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : kernel-3.10.0-229.el7.x86_64 1/1
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.softdep: remove failed: No such file or directory
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.devname: remove failed: No such file or directory
Verifying : kernel-3.10.0-229.el7.x86_64 1/1

Removed:
kernel.x86_64 0:3.10.0-229.el7

Complete!
</pre>

= Download and Compile Asterisk 18.1.0 =

== Install Development Packages ==

We will be compiling Asterisk from source, so we will need to install some development tools. There may be some duplicates int he list that have already been installed earlier.

<pre>
[root@cn38-inverness-co ~]# yum -y install gcc ncurses-devel openssl-devel gcc-c++ gnutls-devel \
make wget openssh openssh-clients openssh-server ntp sendmail rsync ftp mysql mysql-server \
mysql-devel curl curl-devel traceroute telnet which rpm-build flex gcc newt-devel libusb-devel \
net-snmp-utils bison byacc libxml2-devel vixie-cron mailx xinetd tcpdump

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Package gcc-4.8.5-44.el7.x86_64 already installed and latest version

=== SNIP ===

Package 1:net-snmp-utils-5.7.2-49.el7.x86_64 already installed and latest version
No package vixie-cron available.
Package 14:tcpdump-4.9.2-4.el7_7.1.x86_64 already installed and latest version
Resolving Dependencies
--> Running transaction check
---> Package bison.x86_64 0:3.0.4-2.el7 will be installed

=== SNIP ===

---> Package libevent.x86_64 0:2.0.21-4.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bison x86_64 3.0.4-2.el7 base 674 k

=== SNIP ===

xinetd x86_64 2:2.3.15-14.el7 base 128 k
Installing for dependencies:
bzip2 x86_64 1.0.6-13.el7 base 52 k

=== SNIP ===

zip x86_64 3.0-11.el7 base 260 k

Transaction Summary
==============================================================================================================
Install 18 Packages (+27 Dependent packages)

Total download size: 30 M
Installed size: 110 M
Downloading packages:
(1/45): byacc-1.9.20130304-3.el7.x86_64.rpm | 65 kB 00:00:00

=== SNIP ===

(45/45): zip-3.0-11.el7.x86_64.rpm | 260 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 13 MB/s | 30 MB 00:00:02
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : m4-1.4.16-10.el7.x86_64 1/45

=== SNIP ===

Installing : 2:xinetd-2.3.15-14.el7.x86_64 45/45
Verifying : gcc-c++-4.8.5-44.el7.x86_64 1/45

=== SNIP ===

Verifying : gnutls-devel-3.3.29-9.el7_6.x86_64 45/45

Installed:
bison.x86_64 0:3.0.4-2.el7 byacc.x86_64 0:1.9.20130304-3.el7
flex.x86_64 0:2.5.37-6.el7 ftp.x86_64 0:0.17-67.el7
gcc-c++.x86_64 0:4.8.5-44.el7 gnutls-devel.x86_64 0:3.3.29-9.el7_6
libcurl-devel.x86_64 0:7.29.0-59.el7_9.1 libusb-devel.x86_64 1:0.1.4-3.el7
libxml2-devel.x86_64 0:2.9.1-6.el7.5 mailx.x86_64 0:12.5-19.el7
mariadb.x86_64 1:5.5.68-1.el7 mariadb-devel.x86_64 1:5.5.68-1.el7
ncurses-devel.x86_64 0:5.9-14.20130511.el7_4 newt-devel.x86_64 0:0.52.15-4.el7
rpm-build.x86_64 0:4.11.3-45.el7 rsync.x86_64 0:3.1.2-10.el7
sendmail.x86_64 0:8.14.7-6.el7 xinetd.x86_64 2:2.3.15-14.el7

Dependency Installed:
bzip2.x86_64 0:1.0.6-13.el7 cyrus-sasl.x86_64 0:2.1.26-23.el7
dwz.x86_64 0:0.11-3.el7 elfutils.x86_64 0:0.176-5.el7
gdb.x86_64 0:7.6.1-120.el7 gmp-devel.x86_64 1:6.0.0-15.el7
gnutls-c++.x86_64 0:3.3.29-9.el7_6 gnutls-dane.x86_64 0:3.3.29-9.el7_6
hesiod.x86_64 0:3.2.1-3.el7 libevent.x86_64 0:2.0.21-4.el7
libstdc++-devel.x86_64 0:4.8.5-44.el7 libtasn1-devel.x86_64 0:4.10-1.el7
libusb.x86_64 1:0.1.4-3.el7 libusbx.x86_64 0:1.0.21-1.el7
m4.x86_64 0:1.4.16-10.el7 nettle-devel.x86_64 0:2.7.1-8.el7
p11-kit-devel.x86_64 0:0.23.5-3.el7 patch.x86_64 0:2.7.1-12.el7_7
perl-Thread-Queue.noarch 0:3.02-2.el7 perl-srpm-macros.noarch 0:1-8.el7
procmail.x86_64 0:3.22-36.el7_4.1 python-srpm-macros.noarch 0:3-34.el7
redhat-rpm-config.noarch 0:9.1.0-88.el7.centos slang-devel.x86_64 0:2.2.4-11.el7
unbound-libs.x86_64 0:1.6.6-5.el7_8 unzip.x86_64 0:6.0-21.el7
zip.x86_64 0:3.0-11.el7

Complete!
== Generate RSA Key ==

<pre>
[root@cn38-inverness-co ~]# ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Created directory '/root/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:FKpB44T5QoKCZtkOoU4ZF6w7T0G98QZ60gHU9QpQM9k root@cn38-inverness-co.suburbanbroadband.net
The key's randomart image is:
+---[RSA 2048]----+
|oo*OX++.. |
|*=BB.OoE.. |
|===.=.B .. |
|o..=.*.+. |
| ...= ..S |
| o . |
| + |
| . |
| |
+----[SHA256]-----+

</pre>

== Install UW-IMAP library for IMAP integration for Voice Mails ==

We will want to configure Asterisk to store voicemails via IMAP instead of the local file system. This will allow better deployment of HA down the road.

=== Download uw-imap for storage ===

The UW-IMAP code is no longer maintained after the creator's death, so it's a good idea to archive the important parts.

<pre>
[root@cn38-inverness-co ~]# wget https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/u/uw-imap-2007f-16.el7.x86_64.rpm

--2020-12-02 18:34:30-- https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/u/uw-imap-2007f-16.el7.x86_64.rpm
Resolving download-ib01.fedoraproject.org (download-ib01.fedoraproject.org)... 152.19.134.145, 2610:28:3090:3001:dead:beef:cafe:fed6
Connecting to download-ib01.fedoraproject.org (download-ib01.fedoraproject.org)|152.19.134.145|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 68284 (67K) [application/x-rpm]
Saving to: ‘uw-imap-2007f-16.el7.x86_64.rpm’

100%[====================================================================>] 68,284 --.-K/s in 0.09s

2020-12-02 18:34:31 (703 KB/s) - ‘uw-imap-2007f-16.el7.x86_64.rpm’ saved [68284/68284]
</pre>

=== Install EPEL repo ===

We'll use EPEL to install UW-IMAP, so we have to install that first. After installation, we can go back in and disable teh EPEL repo, if we desire.

<pre>

[root@cn38-inverness-co ~]# yum -y install epel-release

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package epel-release.noarch 0:7-11 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
epel-release noarch 7-11 extras 15 k

Transaction Summary
==============================================================================================================
Install 1 Package

Total download size: 15 k
Installed size: 24 k
Downloading packages:
epel-release-7-11.noarch.rpm | 15 kB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : epel-release-7-11.noarch 1/1
Verifying : epel-release-7-11.noarch 1/1

Installed:
epel-release.noarch 0:7-11

Complete!

</pre>

=== Install uw-imap ===

Finally, the install of UW-IMAP. It will require an additional dependency be installed.

<pre>
[root@cn38-inverness-co ~]# yum install uw-imap

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
epel/x86_64/metalink | 13 kB 00:00:00
* base: mirror.dal10.us.leaseweb.net
* epel: mirror.dal.nexril.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
epel | 4.7 kB 00:00:00
(1/3): epel/x86_64/group_gz | 95 kB 00:00:00
(2/3): epel/x86_64/updateinfo | 1.0 MB 00:00:00
(3/3): epel/x86_64/primary_db | 6.9 MB 00:00:00
Resolving Dependencies
--> Running transaction check
---> Package uw-imap.x86_64 0:2007f-16.el7 will be installed
--> Processing Dependency: libc-client(x86-64) = 2007f-16.el7 for package: uw-imap-2007f-16.el7.x86_64
--> Processing Dependency: libc-client.so.2007()(64bit) for package: uw-imap-2007f-16.el7.x86_64
--> Running transaction check
---> Package libc-client.x86_64 0:2007f-16.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
uw-imap x86_64 2007f-16.el7 epel 67 k
Installing for dependencies:
libc-client x86_64 2007f-16.el7 epel 562 k

Transaction Summary
==============================================================================================================
Install 1 Package (+1 Dependent package)

Total download size: 628 k
Installed size: 1.6 M
Is this ok [y/d/N]: y
Downloading packages:
warning: /var/cache/yum/x86_64/7/epel/packages/libc-client-2007f-16.el7.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 352c64e5: NOKEY
Public key for libc-client-2007f-16.el7.x86_64.rpm is not installed
(1/2): libc-client-2007f-16.el7.x86_64.rpm | 562 kB 00:00:00
(2/2): uw-imap-2007f-16.el7.x86_64.rpm | 67 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.0 MB/s | 628 kB 00:00:00
Retrieving key from file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Importing GPG key 0x352C64E5:
Userid : "Fedora EPEL (7) <epel@fedoraproject.org>"
Fingerprint: 91e9 7d7c 4a5e 96f1 7f3e 888f 6a2f aea2 352c 64e5
Package : epel-release-7-11.noarch (@extras)
From : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Is this ok [y/N]: y
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libc-client-2007f-16.el7.x86_64 1/2
Installing : uw-imap-2007f-16.el7.x86_64 2/2
Verifying : libc-client-2007f-16.el7.x86_64 1/2
Verifying : uw-imap-2007f-16.el7.x86_64 2/2

Installed:
uw-imap.x86_64 0:2007f-16.el7

Dependency Installed:
libc-client.x86_64 0:2007f-16.el7

Complete!

</pre>

== Download Asterisk 18.1.0 ==

Change directory to /usr/local/src and download the Asterisk source code.

<pre>
[root@cn38-inverness-co ~]# cd /usr/local/src/

[root@cn38-inverness-co src]# wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz

--2020-12-02 17:39:25-- https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 27886299 (27M) [application/x-gzip]
Saving to: ‘asterisk-18-current.tar.gz’

100%[====================================================================>] 27,886,299 8.03MB/s in 3.3s

2020-12-02 17:39:29 (8.03 MB/s) - ‘asterisk-18-current.tar.gz’ saved [27886299/27886299]
</pre>

For future reference, you can also find it directly here:

[https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz]

== Uncompress Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co src]# tar -zxf asterisk-18-current.tar.gz

[root@cn38-inverness-co src]# ls
asterisk-18.1.0

[root@cn38-inverness-co src]# cd asterisk-18.1.0/

[root@cn38-inverness-co asterisk-18.1.0]# ls
addons channels include README-SERIOUSLY.bestpractices.md
agi codecs install-sh res
apps config.guess LICENSE rest-api
asterisk-18.1.0-summary.html configs main rest-api-templates
asterisk-18.1.0-summary.txt config.sub Makefile sample.call
autoconf configure Makefile.moddir_rules sounds
bootstrap.sh configure.ac Makefile.rules static-http
bridges contrib makeopts.in tests
BSDmakefile COPYING menuselect third-party
BUGS CREDITS missing UPGRADE.txt
build_tools default.exports mkinstalldirs utils
cdr doc pbx Zaptel-to-DAHDI.txt
cel formats phoneprov
ChangeLog funcs README-addons.txt
CHANGES images README.md

</pre>

== Test the prereqs ==

Run the '''"./contrib/scripts/install_prereq test"''' command in order to test the installed prerequesits. After it returns the things that need to be installed, you can just copy and paste that command. If there are packages that are not installed afterthe command due to not existing in the CentOS 7 main repo, they are probably not required.

<pre>

[root@cn38-inverness-co asterisk-18.1.0]# ./contrib/scripts/install_prereq test

#############################################
## test: test mode.
## Use the commands here to install your system.
#############################################
yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

[root@cn38-inverness-co asterisk-18.1.0]# yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
No package speexdsp-devel available.
No package portaudio-devel available.
No package xmlstarlet available.
No package gmime-devel available.
Package 1:mariadb-devel-5.5.68-1.el7.x86_64 already installed and latest version
No package radcli-devel available.
No package freetds-devel available.
No package jack-audio-connection-kit-devel available.
No package iksemel-devel available.
No package spandsp-devel available.
No package libresample-devel available.
No package uw-imap-devel available.
No package hoard available.
No package codec2-devel available.
Resolving Dependencies
--> Running transaction check
---> Package alsa-lib-devel.x86_64 0:1.1.8-1.el7 will be installed

=== SNIP ===

---> Package mesa-libglapi.x86_64 0:18.3.4-12.el7_9 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
alsa-lib-devel x86_64 1.1.8-1.el7 base 963 k

=== SNIP ===

uriparser-devel x86_64 0.7.5-10.el7 base 138 k
Installing for dependencies:
adobe-mappings-cmap noarch 20171205-3.el7 base 2.1 M

=== SNIP ===

xorg-x11-server-utils x86_64 7.7-20.el7 base 178 k

Transaction Summary
==============================================================================================================
Install 28 Packages (+117 Dependent packages)

Total download size: 56 M
Installed size: 216 M
Downloading packages:
(1/145): adobe-mappings-cmap-deprecated-20171205-3.el7.noarch.rpm | 114 kB 00:00:00

=== SNIP ===

(145/145): xorg-x11-server-utils-7.7-20.el7.x86_64.rpm | 178 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 9.3 MB/s | 56 MB 00:00:06
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libjpeg-turbo-1.2.90-8.el7.x86_64 1/145

=== SNIP ===

Installing : libedit-devel-3.0-12.20121213cvs.el7.x86_64 145/145
Verifying : libXext-1.3.3-3.el7.x86_64 1/145

=== SNIP ===

Verifying : libcgroup-0.41-21.el7.x86_64 145/145

Installed:
alsa-lib-devel.x86_64 0:1.1.8-1.el7 binutils-devel.x86_64 0:2.27-44.base.el7

=== SNIP ===

Dependency Installed:
adobe-mappings-cmap.noarch 0:20171205-3.el7

=== SNIP ===

Complete!
</pre>

== Run ./configure for Asterisk ==

For CentOS 7.X, you will get an error about needing a newer version of jansson library. It may be possible to manually install the newer version, however it is probaly fine to just use the '''--with-jansson-bundled''' flag to include the version bundled with Asterisk source code.

In addition, we will want to load the bundled pjsip channel drivers, with the '''--with-pjproject-pundled'''.

Hopefully this completed without any issues, however you should look over the output to ensure it is what you are expecting.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ./configure --with-jansson-bundled --with-pjproject-bundled

checking build system type... x86_64-pc-linux-gnu

=== SNIP ===

checking for pkg-config... /bin/pkg-config
checking pkg-config is at least version 0.9.0... yes
checking for GTK2... no
configure: creating ./config.status
config.status: creating makeopts
config.status: creating autoconfig.h
configure: Menuselect build configuration successfully completed

.$$$$$$$$$$$$$$$=..
.$7$7.. .7$$7:.
.$$:. ,$7.7
.$7. 7$$$$ .$$77
..$$. $$$$$ .$$$7
..7$ .?. $$$$$ .?. 7$$$.
$.$. .$$$7. $$$$7 .7$$$. .$$$.
.777. .$$$$$$77$$$77$$$$$7. $$$,
$$$~ .7$$$$$$$$$$$$$7. .$$$.
.$$7 .7$$$$$$$7: ?$$$.
$$$ ?7$$$$$$$$$$I .$$$7
$$$ .7$$$$$$$$$$$$$$$$ :$$$.
$$$ $$$$$$7$$$$$$$$$$$$ .$$$.
$$$ $$$ 7$$$7 .$$$ .$$$.
$$$$ $$$$7 .$$$.
7$$$7 7$$$$ 7$$$
$$$$$ $$$
$$$$7. $$ (TM)
$$$$$$$. .7$$$$$$ $$
$$$$$$$$$$$$7$$$$$$$$$.$$$$$$
$$$$$$$$$$$$$$$$.

configure: Package configured for:
configure: OS type : linux-gnu
configure: Host CPU : x86_64
configure: build-cpu:vendor:os: x86_64 : pc : linux-gnu :
configure: host-cpu:vendor:os: x86_64 : pc : linux-gnu :

</pre>

== make menuselect ==

By default, a lot of options are not included in the Asterisk build, and need to be configured. This is done by running the '''"make menu"''' command in the asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make menuselect

CC="cc" CXX="g++" LD="" AR="" RANLIB="" CFLAGS="" LDFLAGS="" make -C menuselect CONFIGURE_SILENT="--silent" gmenuselect
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Nothing to be done for `gmenuselect'.
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0'
menuselect changes saved!
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0'

</pre>

In '''Add-ons''', select '''chan_ooh323''', '''format_mp3''', '''res_config_mysql''', '''app_mysql''' and '''crd_mysql'''.

[[File:Asterisk1810-Add-ons.png|none|frame|Add-ons]]

In '''Core Sound Packages''', select '''EN-WAV''', '''EN-ULAW''', '''EN-ALAW''', '''EN-GSM''', '''EN-G729''', '''EN-G722''', '''EN-SLN16''', '''EN-SIREN7''', and '''EN-SIREN14'''.

[[File:Asterisk1810-coresound.png|none|frame|Core Sound Packages]]

In '''Music On Hold File Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-musiconhold.png|none|frame|Music On Hold File Packages]]

In '''Extras Sound Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-extrasound.png|none|frame|Extras Sound Packages]]

In '''Applications''', select '''app_voicemail''', '''app_voicemail_imap''', '''app_voicemail_odbc''', '''app_macro'''.

[[File:Asterisk1810-applications1.png|none|frame|Applications Voicemail]]
[[File:Asterisk1810-applications2.png|none|frame|Applications Macro]]

== Download MP3 sources ==

Download the required MP3 sources by running the '''contrib/scripts/get_mp3_source.sh''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# contrib/scripts/get_mp3_source.sh

A addons/mp3
A addons/mp3/MPGLIB_TODO
A addons/mp3/mpg123.h
A addons/mp3/layer3.c
A addons/mp3/mpglib.h
A addons/mp3/decode_ntom.c
A addons/mp3/interface.c
A addons/mp3/MPGLIB_README
A addons/mp3/common.c
A addons/mp3/huffman.h
A addons/mp3/tabinit.c
A addons/mp3/Makefile
A addons/mp3/README
A addons/mp3/decode_i386.c
A addons/mp3/dct64_i386.c
Exported revision 202.
</pre>

== Compile Asterisk 18.1.0 ==

We compile the Asterisk code by running the '''make''' command inside the build directory. This should compile at this point, but if there are any errors, additional changes to the system may be required. ''The output below is shortened for space.''

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make

[CC] astcanary.c -> astcanary.o
[LD] astcanary.o -> astcanary
[CC] astdb2sqlite3.c -> astdb2sqlite3.o
[CC] hash/hash.c -> hash/hash.o
[CC] hash/hash_bigkey.c -> hash/hash_bigkey.o
[CC] hash/hash_buf.c -> hash/hash_buf.o
[CC] hash/hash_func.c -> hash/hash_func.o
[CC] hash/hash_log2.c -> hash/hash_log2.o
[CC] hash/hash_page.c -> hash/hash_page.o

=== SNIP ===

[LD] chan_ooh323.o ooh323c/src/ooCmdChannel.o ooh323c/src/ooLogChan.o ooh323c/src/ooUtils.o ooh323c/src/ooGkClient.o ooh323c/src/context.o ooh323c/src/ooDateTime.o ooh323c/src/decode.o ooh323c/src/dlist.o ooh323c/src/encode.o ooh323c/src/errmgmt.o ooh323c/src/memheap.o ooh323c/src/ootrace.o ooh323c/src/oochannels.o ooh323c/src/ooh245.o ooh323c/src/ooports.o ooh323c/src/ooq931.o ooh323c/src/ooCapability.o ooh323c/src/ooSocket.o ooh323c/src/perutil.o ooh323c/src/eventHandler.o ooh323c/src/ooCalls.o ooh323c/src/ooStackCmds.o ooh323c/src/ooh323.o ooh323c/src/ooh323ep.o ooh323c/src/printHandler.o ooh323c/src/rtctype.o ooh323c/src/ooTimer.o ooh323c/src/h323/H235-SECURITY-MESSAGESDec.o ooh323c/src/h323/H235-SECURITY-MESSAGESEnc.o ooh323c/src/h323/H323-MESSAGES.o ooh323c/src/h323/H323-MESSAGESDec.o ooh323c/src/h323/H323-MESSAGESEnc.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROL.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLDec.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLEnc.o ooh323cDriver.o -> chan_ooh323.so
[CC] format_mp3.c -> format_mp3.o
[CC] mp3/common.c -> mp3/common.o
[CC] mp3/dct64_i386.c -> mp3/dct64_i386.o
[CC] mp3/decode_ntom.c -> mp3/decode_ntom.o
[CC] mp3/layer3.c -> mp3/layer3.o
[CC] mp3/tabinit.c -> mp3/tabinit.o
[CC] mp3/interface.c -> mp3/interface.o
[LD] format_mp3.o mp3/common.o mp3/dct64_i386.o mp3/decode_ntom.o mp3/layer3.o mp3/tabinit.o mp3/interface.o -> format_mp3.so
[CC] res_config_mysql.c -> res_config_mysql.o
[LD] res_config_mysql.o -> res_config_mysql.so
Building Documentation For: third-party channels pbx apps codecs formats cdr cel bridges funcs tests main res addons
+--------- Asterisk Build Complete ---------+
+ Asterisk has successfully been built, and +
+ can be installed by running: +
+ +
+ make install +
+-------------------------------------------+
</pre>

== Install for Asterisk 18.1.0 ==

We install Asterisk by running the '''make install''' command in the Asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make install
Installing modules from channels...
Installing modules from pbx...
Installing modules from apps...
Installing modules from codecs...
Installing modules from formats...
Installing modules from cdr...
Installing modules from cel...
Installing modules from bridges...
Installing modules from funcs...
Installing modules from tests...
Installing modules from main...
Installing modules from res...
Installing modules from addons...
/bin/install -c -m 755 contrib/scripts/astversion "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/astgenkey "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/autosupport "/usr/sbin/"
if [ ! -f /sbin/launchd ]; then \
./build_tools/install_subst contrib/scripts/safe_asterisk "/usr/sbin/safe_asterisk"; \
fi
/bin/install -c -m 644 doc/core-*.xml "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.dtd "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/asterisk.8 "/usr/share/man/man8"
/bin/install -c -m 644 doc/astdb*.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/astgenkey.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/autosupport.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/safe_asterisk.8 "/usr/share/man/man8"
if [ -f contrib/firmware/iax/iaxy.bin ] ; then \
/bin/install -c -m 644 contrib/firmware/iax/iaxy.bin "/var/lib/asterisk/firmware/iax/iaxy.bin"; \
fi
CFLAGS=" -I/usr/include/libxml2 -pipe -Wall -Wstrict-prototypes -Wmissing-prototypes -Wmissing-declarations -g3 " build_tools/mkpkgconfig "/usr/lib/pkgconfig";
find static-http | while read x; do \
if test -d $x; then \
/bin/install -c -m 755 -d "/var/lib/asterisk/$x"; \
else \
/bin/install -c -m 644 $x "/var/lib/asterisk/$x" ; \
fi \
done
/bin/install -c -m 644 doc/core-en_US.xml "/var/lib/asterisk/static-http";
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/static-http";
if [ -d doc/tex/asterisk ] ; then \
/bin/install -c -d "/var/lib/asterisk/static-http/docs" ; \
for n in doc/tex/asterisk/* ; do \
/bin/install -c -m 644 $n "/var/lib/asterisk/static-http/docs" ; \
done \
fi
for x in images/*.jpg; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/images" ; \
done
make -C sounds install
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/sounds'
--2020-12-02 18:52:05-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-wav-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 20176188 (19M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’

100%[====================================================================>] 20,176,188 7.79MB/s in 2.5s

2020-12-02 18:52:08 (7.79 MB/s) - ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’ saved [20176188/20176188]

--2020-12-02 18:52:09-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-ulaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10241447 (9.8M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’

100%[====================================================================>] 10,241,447 1.71MB/s in 6.4s

2020-12-02 18:52:15 (1.52 MB/s) - ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’ saved [10241447/10241447]

--2020-12-02 18:52:16-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-alaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9937284 (9.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’

100%[====================================================================>] 9,937,284 3.40MB/s in 2.8s

2020-12-02 18:52:18 (3.40 MB/s) - ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’ saved [9937284/9937284]

--2020-12-02 18:52:19-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g729-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1557751 (1.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’

100%[====================================================================>] 1,557,751 2.78MB/s in 0.5s

2020-12-02 18:52:20 (2.78 MB/s) - ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’ saved [1557751/1557751]

--2020-12-02 18:52:20-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g722-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10756090 (10M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’

100%[====================================================================>] 10,756,090 6.58MB/s in 1.6s

2020-12-02 18:52:21 (6.58 MB/s) - ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’ saved [10756090/10756090]

--2020-12-02 18:52:22-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-sln16-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 41366110 (39M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’

100%[====================================================================>] 41,366,110 11.1MB/s in 3.9s

2020-12-02 18:52:26 (10.1 MB/s) - ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’ saved [41366110/41366110]

--2020-12-02 18:52:27-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren7-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 6028362 (5.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’

100%[====================================================================>] 6,028,362 7.39MB/s in 0.8s

2020-12-02 18:52:27 (7.39 MB/s) - ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’ saved [6028362/6028362]

--2020-12-02 18:52:28-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren14-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9120763 (8.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’

100%[====================================================================>] 9,120,763 8.37MB/s in 1.0s

2020-12-02 18:52:29 (8.37 MB/s) - ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’ saved [9120763/9120763]

--2020-12-02 18:52:29-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-wav-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 35362826 (34M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’

100%[====================================================================>] 35,362,826 8.66MB/s in 4.1s

2020-12-02 18:52:33 (8.29 MB/s) - ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’ saved [35362826/35362826]

--2020-12-02 18:52:34-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 18007258 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’

100%[====================================================================>] 18,007,258 9.70MB/s in 1.8s

2020-12-02 18:52:36 (9.70 MB/s) - ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’ saved [18007258/18007258]

--2020-12-02 18:52:37-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-alaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 17464549 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’

100%[====================================================================>] 17,464,549 9.37MB/s in 1.8s

2020-12-02 18:52:39 (9.37 MB/s) - ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’ saved [17464549/17464549]

--2020-12-02 18:52:39-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-gsm-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 4253587 (4.1M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’

100%[====================================================================>] 4,253,587 6.67MB/s in 0.6s

2020-12-02 18:52:40 (6.67 MB/s) - ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’ saved [4253587/4253587]

--2020-12-02 18:52:41-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-ulaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7479839 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’

100%[====================================================================>] 7,479,839 7.98MB/s in 0.9s

2020-12-02 18:52:42 (7.98 MB/s) - ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’ saved [7479839/7479839]

--2020-12-02 18:52:42-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-alaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7496413 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-alaw-2.03.tar.gz’

100%[====================================================================>] 7,496,413 8.03MB/s in 0.9s

2020-12-02 18:52:43 (8.03 MB/s) - ‘asterisk-moh-opsound-alaw-2.03.tar.gz’ saved [7496413/7496413]

--2020-12-02 18:52:43-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-gsm-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1777967 (1.7M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-gsm-2.03.tar.gz’

100%[====================================================================>] 1,777,967 4.09MB/s in 0.4s

2020-12-02 18:52:44 (4.09 MB/s) - ‘asterisk-moh-opsound-gsm-2.03.tar.gz’ saved [1777967/1777967]

make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/sounds'
find rest-api -name "*.json" | while read x; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/rest-api" ; \
done
+---- Asterisk Installation Complete -------+
+ +
+ YOU MUST READ THE SECURITY DOCUMENT +
+ +
+ Asterisk has successfully been installed. +
+ If you would like to install the sample +
+ configuration files (overwriting any +
+ existing config files), run: +
+ +
+ For generic reference documentation: +
+ make samples +
+ +
+ For a sample basic PBX: +
+ make basic-pbx +
+ +
+ +
+----------------- or ---------------------+
+ +
+ You can go ahead and install the asterisk +
+ program documentation now or later run: +
+ +
+ make progdocs +
+ +
+ **Note** This requires that you have +
+ doxygen installed on your local system +
+-------------------------------------------+
</pre>

== Install Program Docs ==

Install the program documentation by running the '''make progdocs''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make progdocs

# Enable DOT
# Set Doxygen PROJECT_NUMBER variable
# Validate and auto-update local copy
Warning: Tag `SYMBOL_CACHE_SIZE' at line 291 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `SHOW_DIRECTORIES' at line 491 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `HTML_ALIGN_MEMBERS' at line 859 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `USE_INLINE_TREES' at line 1044 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"

Configuration file `doc/asterisk-ng-doxygen' updated.

# Run Doxygen
Warning: doxygen no longer ships with the FreeSans font.
You may want to clear or change DOT_FONTNAME.
Otherwise you run the risk that the wrong font is being used for dot generated graphs.
Searching for include files...
Searching for files in directory /usr/local/src/asterisk-18.1.0
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/mp3
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/ooh323c

=== SNIP ===

Patching output file 2546/2550
Patching output file 2547/2550
Patching output file 2548/2550
Patching output file 2549/2550
Patching output file 2550/2550
lookup cache used 65536/65536 hits=1461947 misses=70524
finished...
# Remove configuration backup file
</pre>

== Make the Asterisk 18.1.0 sample configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make samples
Installing adsi config files...
/bin/install -c -d "/etc/asterisk"
Installing configs/samples/asterisk.adsi
Installing configs/samples/telcordia-1.adsi
Installing other config files...
Installing file configs/samples/acl.conf.sample
Installing file configs/samples/adsi.conf.sample
Installing file configs/samples/agents.conf.sample
Installing file configs/samples/alarmreceiver.conf.sample
Installing file configs/samples/alsa.conf.sample
Installing file configs/samples/amd.conf.sample
Installing file configs/samples/app_mysql.conf.sample
Installing file configs/samples/app_skel.conf.sample
Installing file configs/samples/ari.conf.sample
Installing file configs/samples/ast_debug_tools.conf.sample
Installing file configs/samples/asterisk.conf.sample
Installing file configs/samples/calendar.conf.sample
Installing file configs/samples/ccss.conf.sample
Installing file configs/samples/cdr_adaptive_odbc.conf.sample
Installing file configs/samples/cdr_beanstalkd.conf.sample
Installing file configs/samples/cdr.conf.sample
Installing file configs/samples/cdr_custom.conf.sample
Installing file configs/samples/cdr_manager.conf.sample
Installing file configs/samples/cdr_mysql.conf.sample
Installing file configs/samples/cdr_odbc.conf.sample
Installing file configs/samples/cdr_pgsql.conf.sample
Installing file configs/samples/cdr_sqlite3_custom.conf.sample
Installing file configs/samples/cdr_syslog.conf.sample
Installing file configs/samples/cdr_tds.conf.sample
Installing file configs/samples/cel_beanstalkd.conf.sample
Installing file configs/samples/cel.conf.sample
Installing file configs/samples/cel_custom.conf.sample
Installing file configs/samples/cel_odbc.conf.sample
Installing file configs/samples/cel_pgsql.conf.sample
Installing file configs/samples/cel_sqlite3_custom.conf.sample
Installing file configs/samples/cel_tds.conf.sample
Installing file configs/samples/chan_dahdi.conf.sample
Installing file configs/samples/chan_mobile.conf.sample
Installing file configs/samples/cli_aliases.conf.sample
Installing file configs/samples/cli.conf.sample
Installing file configs/samples/cli_permissions.conf.sample
Installing file configs/samples/codecs.conf.sample
Installing file configs/samples/confbridge.conf.sample
Installing file configs/samples/config_test.conf.sample
Installing file configs/samples/console.conf.sample
Installing file configs/samples/dbsep.conf.sample
Installing file configs/samples/dnsmgr.conf.sample
Installing file configs/samples/dsp.conf.sample
Installing file configs/samples/dundi.conf.sample
Installing file configs/samples/enum.conf.sample
Installing file configs/samples/extconfig.conf.sample
Installing file configs/samples/extensions.ael.sample
Installing file configs/samples/extensions.conf.sample
Installing file configs/samples/extensions.lua.sample
Installing file configs/samples/extensions_minivm.conf.sample
Installing file configs/samples/features.conf.sample
Installing file configs/samples/festival.conf.sample
Installing file configs/samples/followme.conf.sample
Installing file configs/samples/func_odbc.conf.sample
Installing file configs/samples/hep.conf.sample
Installing file configs/samples/http.conf.sample
Installing file configs/samples/iax.conf.sample
Installing file configs/samples/iaxprov.conf.sample
Installing file configs/samples/indications.conf.sample
Installing file configs/samples/logger.conf.sample
Installing file configs/samples/manager.conf.sample
Installing file configs/samples/meetme.conf.sample
Installing file configs/samples/mgcp.conf.sample
Installing file configs/samples/minivm.conf.sample
Installing file configs/samples/misdn.conf.sample
Installing file configs/samples/modules.conf.sample
Installing file configs/samples/motif.conf.sample
Installing file configs/samples/musiconhold.conf.sample
Installing file configs/samples/muted.conf.sample
Installing file configs/samples/ooh323.conf.sample
Installing file configs/samples/osp.conf.sample
Installing file configs/samples/oss.conf.sample
Installing file configs/samples/phone.conf.sample
Installing file configs/samples/phoneprov.conf.sample
Installing file configs/samples/pjproject.conf.sample
Installing file configs/samples/pjsip.conf.sample
Installing file configs/samples/pjsip_notify.conf.sample
Installing file configs/samples/pjsip_wizard.conf.sample
Installing file configs/samples/prometheus.conf.sample
Installing file configs/samples/queuerules.conf.sample
Installing file configs/samples/queues.conf.sample
Installing file configs/samples/res_config_mysql.conf.sample
Installing file configs/samples/res_config_sqlite3.conf.sample
Installing file configs/samples/res_config_sqlite.conf.sample
Installing file configs/samples/res_corosync.conf.sample
Installing file configs/samples/res_curl.conf.sample
Installing file configs/samples/res_fax.conf.sample
Installing file configs/samples/res_ldap.conf.sample
Installing file configs/samples/res_odbc.conf.sample
Installing file configs/samples/resolver_unbound.conf.sample
Installing file configs/samples/res_parking.conf.sample
Installing file configs/samples/res_pgsql.conf.sample
Installing file configs/samples/res_pktccops.conf.sample
Installing file configs/samples/res_snmp.conf.sample
Installing file configs/samples/res_stun_monitor.conf.sample
Installing file configs/samples/rtp.conf.sample
Installing file configs/samples/say.conf.sample
Installing file configs/samples/sip.conf.sample
Installing file configs/samples/sip_notify.conf.sample
Installing file configs/samples/skinny.conf.sample
Installing file configs/samples/sla.conf.sample
Installing file configs/samples/smdi.conf.sample
Installing file configs/samples/sorcery.conf.sample
Installing file configs/samples/ss7.timers.sample
Installing file configs/samples/stasis.conf.sample
Installing file configs/samples/statsd.conf.sample
Installing file configs/samples/stir_shaken.conf.sample
Installing file configs/samples/test_sorcery.conf.sample
Installing file configs/samples/udptl.conf.sample
Installing file configs/samples/unistim.conf.sample
Installing file configs/samples/users.conf.sample
Installing file configs/samples/voicemail.conf.sample
Installing file configs/samples/vpb.conf.sample
Installing file configs/samples/xmpp.conf.sample
Updating asterisk.conf
/bin/install -c -d "/var/spool/asterisk/voicemail/default/1234/INBOX"
build_tools/make_sample_voicemail "//var/lib/asterisk" "//var/spool/asterisk"
Installing file phoneprov/000000000000.cfg
Installing file phoneprov/000000000000-directory.xml
Installing file phoneprov/000000000000-phone.cfg
Installing file phoneprov/polycom_line.xml
Installing file phoneprov/polycom.xml
Installing file phoneprov/snom-mac.xml
</pre>

== Make the Asterisk 18.1.0 configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make config
</pre>

== Set ldconfig ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ldconfig
</pre>

== Setup user, group and permissions ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# groupadd asterisk
[root@cn38-inverness-co asterisk-18.1.0]# useradd -r -d /var/lib/asterisk -g asterisk asterisk
[root@cn38-inverness-co asterisk-18.1.0]# usermod -aG audio,dialout asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /etc/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /var/{lib,log,spool}/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /usr/lib/asterisk
</pre>

== Set runtime parameters ==

Need to change things in there.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/sysconfig/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/asterisk/asterisk.conf
</pre>

== Enable and Start Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl enable asterisk

asterisk.service is not a native service, redirecting to /sbin/chkconfig.
Executing /sbin/chkconfig asterisk on

[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl start asterisk

</pre>

== Connect to Asterisk and verify version ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# asterisk -rvv

parse error: No category context for line 1 of /etc/asterisk/asterisk.conf
Unable to open specified master config file '/etc/asterisk/asterisk.conf', using built-in defaults
Asterisk 18.1.0, Copyright (C) 1999 - 2018, Digium, Inc. and others.
Created by Mark Spencer <markster@digium.com>
Asterisk comes with ABSOLUTELY NO WARRANTY; type 'core show warranty' for details.
This is free software, with components licensed under the GNU General Public
License version 2 and other licenses; you are welcome to redistribute it under
certain conditions. Type 'core show license' for details.
=========================================================================
Connected to Asterisk 18.1.0 currently running on cn38-inverness-co (pid = 18370)
cn38-inverness-co*CLI>
Disconnected from Asterisk server
Asterisk cleanly ending (0).
Executing last minute cleanups
</pre>

= Configure Asterisk =

== Version 1.8 to 18.1.0 Errors ==

chan_agent => chan_agent_pool

chan_local => Asterisk core, no loadable module

bridge_multiplexed => ?

app_meetme => Part of DAHDI. Replaced by app_confbridge

Failed to resolve dependencies for func_curl => load res_curl.co to modules.conf

Failed to resolve dependencies for res_config_curl => load res_curl.co to modules.conf

Failed to resolve dependencies for app_page => Disable if not in the dial plan.

MOH errors => Copy MOH directories from 1.8 VG to 18.1 VG.

User:Sfiggins/Asterisk 18 on CentOS7

2020-12-05T02:14:54Z

Sfiggins: /* Version 1.8 to 18.1.0 Errors */

User:Sfiggins/Asterisk 18 on CentOS7

2020-12-04T02:41:02Z

Sfiggins: /* Install Development Packages */

= Install and Configure Base OS =

== Install from CentOS 7 CD (Minimal Install) ==

== Log into newly installed server ==

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
sfiggins@cn38-inverness-co.suburbanbroadband.net's password:
</pre>

== Setting up PSK login access, if desired ==

=== Copy authorized_keys from another server ===

I have another server that already has my authorized keys, so I"ll copy it from there. You can also past in your RSA key into '''~/.ssh/authorized_keys''', if you prefer.

<pre>
[sfiggins@cn38-inverness-co ~]$ scp -r 216.112.193.138:.ssh/ .

The authenticity of host '216.112.193.138 (216.112.193.138)' can't be established.
RSA key fingerprint is 5f:61:91:46:5c:c8:4c:a1:2e:25:0b:61:1e:97:d9:ed.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '216.112.193.138' (RSA) to the list of known hosts.
sfiggins@216.112.193.138's password:
known_hosts 100% 397 0.4KB/s 00:00
authorized_keys 100% 414 0.4KB/s 00:00

[sfiggins@cn38-inverness-co ~]$ logout
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

=== Login in using private key ===

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
Last login: Wed Dec 2 17:21:54 2020 from 209.116.189.54
</pre>

== Sudo to Root ==

All the installation steps in this guide must be performed as root. You can either prefix each command with '''"sudo"''' or just use sudo to become the '''root''' account and execute them as listed.

<pre>
[sfiggins@cn38-inverness-co ~]$ sudo su -

We trust you have received the usual lecture from the local System
Administrator. It usually boils down to these three things:

#1) Respect the privacy of others.
#2) Think before you type.
#3) With great power comes great responsibility.

[sudo] password for sfiggins:
Last login: Wed Dec 2 16:46:45 MST 2020 on tty1
</pre>

== Fix Sudoers ==

This fix will remove the need to reenter your puser password when running the '''"sudo"''' command. This is a preference, and does not need to be done if you prefer to enter the password each time.

<pre>
[root@cn38-inverness-co ~]# vi /etc/sudoers
</pre>

Comment out the below matching line, by adding '''"# "''' in beginning of the line.

<pre>
%wheel ALL=(ALL) ALL
</pre>

Remove the comment from the below matching line by removing the '''"# "''' from the beginning of the line.

<pre>
# %wheel ALL=(ALL) NOPASSWD: ALL
</pre>

Save this file using the '''":wq!"''' command, as this file is read-only.

== Disable and remove NetworkManager ==

The '''NetworkManager''' packages are not needed on a Linux server and they just get in the way. Removing them is the best option. They are more useful on a workstation that will be changing networks frequently.

<pre>
[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager

rm '/etc/systemd/system/multi-user.target.wants/NetworkManager.service'
rm '/etc/systemd/system/dbus-org.freedesktop.nm-dispatcher.service'
rm '/etc/systemd/system/dbus-org.freedesktop.NetworkManager.service'

[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager-dispatcher

[root@cn38-inverness-co ~]# yum erase NetworkManager-tui NetworkManager-glib NetworkManager

Loaded plugins: fastestmirror
No Match for argument: NetworkManager-glib
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
---> Package NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
NetworkManager x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 8.8 M
NetworkManager-tui x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 258 k

Transaction Summary
==============================================================================================================
Remove 2 Packages

Installed size: 9.1 M
Is this ok [y/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Erasing : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2
Verifying : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Verifying : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2

Removed:
NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7
NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7

Complete!
</pre>

== Disable SELinux ==

This mostly gets in the way, and we will disable it. There are steps that can be taken to leave this intact and functioning and still allow the system to function propperly, but I'll not discuss that here.

<pre>
[root@cn38-inverness-co ~]# setenforce 0
[root@cn38-inverness-co ~]# sed -i.bak "s/^SELINUX=.*/SELINUX=disabled/g" /etc/selinux/config
</pre>

== Update System Packages ==

Update the system packages. Some of the later steps will require give errors depending on system package levels that are available, and it is just good measure to make sure the latest packages are installed.

<pre>
[root@cn38-inverness-co ~]# yum -y update

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager-libnm.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be updated

=== SNIP ===

---> Package libstdc++.i686 0:4.8.5-44.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:

=== SNIP ===

Updating:

=== SNIP ===

Installing for dependencies:

=== SNIP ===

Transaction Summary
==============================================================================================================
Install 8 Packages (+47 Dependent packages)
Upgrade 240 Packages

Total size: 325 M
Total download size: 275 M
Downloading packages:
Delta RPMs disabled because /usr/bin/applydeltarpm not installed.
(1/230): acl-2.2.51-15.el7.x86_64.rpm | 81 kB 00:00:00

=== SNIP ===

(230/230): tzdata-2020d-2.el7.noarch.rpm | 499 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 17 MB/s | 275 MB 00:00:16
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Updating : libgcc-4.8.5-44.el7.x86_64 1/539
Installing : 1:grub2-common-2.02-0.86.el7.centos.noarch 2/539
Updating : centos-release-7-9.2009.1.el7.centos.x86_64 3/539

=== SNIP ===

Installing : rdma-core-22.4-5.el7.i686 295/539
Cleanup : tuned-2.4.1-1.el7.noarch 296/539

=== SNIP ===

Cleanup : 12:dhclient-4.2.5-36.el7.centos.x86_64 385/539

UPGRADE: Automatically re-enabling default systemd units:
brandbot.path
rhel-autorelabel.service
rhel-autorelabel-mark.service
rhel-configure.service
rhel-dmesg.service
rhel-domainname.service
rhel-import-state.service
rhel-loadmodules.service
rhel-readonly.service

Cleanup : initscripts-9.49.24-1.el7.x86_64 386/539

=== SNIP ===

Cleanup : libgcc-4.8.3-9.el7.x86_64 539/539
Verifying : glibc-common-2.17-317.el7.x86_64 1/539

=== SNIP ===

Verifying : 7:device-mapper-1.02.93-3.el7.x86_64 539/539

Installed:
grub2.x86_64 1:2.02-0.86.el7.centos grub2-tools.x86_64 1:2.02-0.86.el7.centos
grub2-tools-extra.x86_64 1:2.02-0.86.el7.centos grub2-tools-minimal.x86_64 1:2.02-0.86.el7.centos
kernel.x86_64 0:3.10.0-1160.6.1.el7 python-gobject-base.x86_64 0:3.22.0-1.el7_4.1
rdma-core.i686 0:22.4-5.el7 rdma-core.x86_64 0:22.4-5.el7

Dependency Installed:
GeoIP.x86_64 0:1.5.0-14.el7 audit-libs.i686 0:2.8.5-4.el7

=== SNIP ===

zlib.i686 0:1.2.7-18.el7

Updated:
NetworkManager-libnm.x86_64 1:1.18.8-2.el7_9

=== SNIP ===

zlib.x86_64 0:1.2.7-18.el7

Replaced:
grub2.x86_64 1:2.02-0.16.el7.centos grub2-tools.x86_64 1:2.02-0.16.el7.centos
pygobject3-base.x86_64 0:3.8.2-6.el7 rdma.noarch 0:7.1_3.17-5.el7

Complete!
</pre>

== Install Additional Packages ==

These are useful utilities that have been stripped from the base install in CentOS7. Adding these back in allows for easier troubleshooting of the server.

<pre>
[root@cn38-inverness-co ~]# yum -y install finger nc net-snmp net-snmp-perl net-snmp-utils ntp perl-Date-Manip \
perl-DBD-SQLite sssd tcp_wrappers tcpdump telnet tftp tog-pegasus traceroute \
vim-enhanced wget oddjob-mkhomedir net-tools yum-cron bind-utils

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 will be installed
--> Processing Dependency: bind-libs(x86-64) = 32:9.11.4-26.P2.el7_9.2 for package: 32:bind-utils-9.11.4-26.P2.el7_9.2.x86_64

=== SNIP ===

---> Package pcre-devel.x86_64 0:8.32-17.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bind-utils x86_64 32:9.11.4-26.P2.el7_9.2 updates 260 k

=== SNIP ===

yum-cron noarch 3.4.3-168.el7.centos base 66 k
Installing for dependencies:
autogen-libopts x86_64 5.18-5.el7 base 66 k

=== SNIP ===

zlib-devel x86_64 1.2.7-18.el7 base 50 k

Transaction Summary
==============================================================================================================
Install 21 Packages (+114 Dependent packages)

Total size: 59 M
Installed size: 166 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtalloc-2.1.16-1.el7.x86_64 1/135

=== SNIP ===

Installing : finger-0.17-52.el7.x86_64 135/135
Verifying : perl-HTTP-Tiny-0.033-3.el7.noarch 1/135

=== SNIP ===

Verifying : 2:nmap-ncat-6.40-19.el7.x86_64 135/135

Installed:
bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 finger.x86_64 0:0.17-52.el7
net-snmp.x86_64 1:5.7.2-49.el7 net-snmp-perl.x86_64 1:5.7.2-49.el7
net-snmp-utils.x86_64 1:5.7.2-49.el7 net-tools.x86_64 0:2.0-0.25.20131004git.el7
nmap-ncat.x86_64 2:6.40-19.el7 ntp.x86_64 0:4.2.6p5-29.el7.centos.2
oddjob-mkhomedir.x86_64 0:0.31.5-4.el7 perl-DBD-SQLite.x86_64 0:1.39-3.el7
perl-Date-Manip.noarch 0:6.41-2.el7 sssd.x86_64 0:1.16.5-10.el7_9.5
tcp_wrappers.x86_64 0:7.6-77.el7 tcpdump.x86_64 14:4.9.2-4.el7_7.1
telnet.x86_64 1:0.17-66.el7 tftp.x86_64 0:5.2-22.el7
tog-pegasus.x86_64 2:2.14.1-8.el7 traceroute.x86_64 3:2.0.22-2.el7
vim-enhanced.x86_64 2:7.4.629-7.el7 wget.x86_64 0:1.14-18.el7_6.1
yum-cron.noarch 0:3.4.3-168.el7.centos

Dependency Installed:
autogen-libopts.x86_64 0:5.18-5.el7

=== SNIP ===

zlib-devel.x86_64 0:1.2.7-18.el7

Complete!
</pre>

== Fix Timezone ==

This is just a preference, but it will standardize the timezone.

<pre>
[root@cn38-inverness-co ~]# rm -f /etc/localtime
[root@cn38-inverness-co ~]# ln -s /usr/share/zoneinfo/MST7MDT /etc/localtime
</pre>

== Disable RPF ==

Reverse Path Forwarding (RPF) is a security protection that will prevent inbound packets from entering an IP interface that does not have outbound routes to the source IP. It is not important to disable this if your server only has one interface, however if you have multiple network interfaces, and you may be receiving asymmetric traffic, this needs to be disabled to allow the packets to enter the system.

<pre>
[root@cn38-inverness-co ~]# echo "net.ipv4.conf.default.rp_filter = 0" > /etc/sysctl.d/rpfilter.conf
</pre>

== Install vmtools (if virtual) ==

'''Only do this step if you are installing on a virtual platform. This is not required if you are installing on bare metal.'''

<pre>
[root@cn38-inverness-co ~]# yum -y install open-vm-tools

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package open-vm-tools.x86_64 0:11.0.5-3.el7_9.1 will be installed
--> Processing Dependency: xmlsec1-openssl for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.6)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.5)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: fuse for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxslt.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxmlsec1.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libmspack.so.0()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libltdl.so.7()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Running transaction check
---> Package fuse.x86_64 0:2.9.2-11.el7 will be installed
---> Package fuse-libs.x86_64 0:2.9.2-11.el7 will be installed
---> Package libmspack.x86_64 0:0.5-0.8.alpha.el7 will be installed
---> Package libtool-ltdl.x86_64 0:2.4.2-22.el7_3 will be installed
---> Package libxslt.x86_64 0:1.1.28-6.el7 will be installed
---> Package xmlsec1.x86_64 0:1.2.20-7.el7_4 will be installed
---> Package xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
open-vm-tools x86_64 11.0.5-3.el7_9.1 updates 676 k
Installing for dependencies:
fuse x86_64 2.9.2-11.el7 base 86 k
fuse-libs x86_64 2.9.2-11.el7 base 93 k
libmspack x86_64 0.5-0.8.alpha.el7 base 64 k
libtool-ltdl x86_64 2.4.2-22.el7_3 base 49 k
libxslt x86_64 1.1.28-6.el7 base 242 k
xmlsec1 x86_64 1.2.20-7.el7_4 base 177 k
xmlsec1-openssl x86_64 1.2.20-7.el7_4 base 76 k

Transaction Summary
==============================================================================================================
Install 1 Package (+7 Dependent packages)

Total download size: 1.4 M
Installed size: 4.0 M
Downloading packages:
(1/8): fuse-2.9.2-11.el7.x86_64.rpm | 86 kB 00:00:00
(2/8): fuse-libs-2.9.2-11.el7.x86_64.rpm | 93 kB 00:00:00
(3/8): libtool-ltdl-2.4.2-22.el7_3.x86_64.rpm | 49 kB 00:00:00
(4/8): libmspack-0.5-0.8.alpha.el7.x86_64.rpm | 64 kB 00:00:00
(5/8): xmlsec1-1.2.20-7.el7_4.x86_64.rpm | 177 kB 00:00:00
(6/8): libxslt-1.1.28-6.el7.x86_64.rpm | 242 kB 00:00:00
(7/8): xmlsec1-openssl-1.2.20-7.el7_4.x86_64.rpm | 76 kB 00:00:00
(8/8): open-vm-tools-11.0.5-3.el7_9.1.x86_64.rpm | 676 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.4 MB/s | 1.4 MB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtool-ltdl-2.4.2-22.el7_3.x86_64 1/8
Installing : libxslt-1.1.28-6.el7.x86_64 2/8
Installing : xmlsec1-1.2.20-7.el7_4.x86_64 3/8
Installing : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Installing : fuse-2.9.2-11.el7.x86_64 5/8
Installing : fuse-libs-2.9.2-11.el7.x86_64 6/8
Installing : libmspack-0.5-0.8.alpha.el7.x86_64 7/8
Installing : open-vm-tools-11.0.5-3.el7_9.1.x86_64 8/8
Verifying : libmspack-0.5-0.8.alpha.el7.x86_64 1/8
Verifying : fuse-libs-2.9.2-11.el7.x86_64 2/8
Verifying : fuse-2.9.2-11.el7.x86_64 3/8
Verifying : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Verifying : libxslt-1.1.28-6.el7.x86_64 5/8
Verifying : xmlsec1-1.2.20-7.el7_4.x86_64 6/8
Verifying : open-vm-tools-11.0.5-3.el7_9.1.x86_64 7/8
Verifying : libtool-ltdl-2.4.2-22.el7_3.x86_64 8/8

Installed:
open-vm-tools.x86_64 0:11.0.5-3.el7_9.1

Dependency Installed:
fuse.x86_64 0:2.9.2-11.el7 fuse-libs.x86_64 0:2.9.2-11.el7
libmspack.x86_64 0:0.5-0.8.alpha.el7 libtool-ltdl.x86_64 0:2.4.2-22.el7_3
libxslt.x86_64 0:1.1.28-6.el7 xmlsec1.x86_64 0:1.2.20-7.el7_4
xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4

Complete!
</pre>

== Reboot Server ==

<pre>
[root@cn38-inverness-co ~]# shutdown -r now
Connection to cn38-inverness-co.suburbanbroadband.net closed by remote host.
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

== Remove old kernel ==

<pre>
[root@cn38-inverness-co ~]# rpm -qa | grep kernel

kernel-tools-libs-3.10.0-1160.6.1.el7.x86_64
kernel-headers-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-229.el7.x86_64
kernel-tools-3.10.0-1160.6.1.el7.x86_64

[root@cn38-inverness-co ~]# yum -y erase kernel-3.10.0-229.el7.x86_64

Loaded plugins: fastestmirror
Resolving Dependencies
--> Running transaction check
---> Package kernel.x86_64 0:3.10.0-229.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
kernel x86_64 3.10.0-229.el7 @anaconda 131 M

Transaction Summary
==============================================================================================================
Remove 1 Package

Installed size: 131 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : kernel-3.10.0-229.el7.x86_64 1/1
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.softdep: remove failed: No such file or directory
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.devname: remove failed: No such file or directory
Verifying : kernel-3.10.0-229.el7.x86_64 1/1

Removed:
kernel.x86_64 0:3.10.0-229.el7

Complete!
</pre>

= Download and Compile Asterisk 18.1.0 =

== Install Development Packages ==

We will be compiling Asterisk from source, so we will need to install some development tools. There may be some duplicates int he list that have already been installed earlier.

<pre>
[root@cn38-inverness-co ~]# yum -y install gcc ncurses-devel openssl-devel gcc-c++ gnutls-devel \
make wget openssh openssh-clients openssh-server ntp sendmail rsync ftp mysql mysql-server \
mysql-devel curl curl-devel traceroute telnet which rpm-build flex gcc newt-devel libusb-devel \
net-snmp-utils bison byacc libxml2-devel vixie-cron mailx xinetd tcpdump

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Package gcc-4.8.5-44.el7.x86_64 already installed and latest version

=== SNIP ===

Package 1:net-snmp-utils-5.7.2-49.el7.x86_64 already installed and latest version
No package vixie-cron available.
Package 14:tcpdump-4.9.2-4.el7_7.1.x86_64 already installed and latest version
Resolving Dependencies
--> Running transaction check
---> Package bison.x86_64 0:3.0.4-2.el7 will be installed

=== SNIP ===

---> Package libevent.x86_64 0:2.0.21-4.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bison x86_64 3.0.4-2.el7 base 674 k

=== SNIP ===

xinetd x86_64 2:2.3.15-14.el7 base 128 k
Installing for dependencies:
bzip2 x86_64 1.0.6-13.el7 base 52 k

=== SNIP ===

zip x86_64 3.0-11.el7 base 260 k

Transaction Summary
==============================================================================================================
Install 18 Packages (+27 Dependent packages)

Total download size: 30 M
Installed size: 110 M
Downloading packages:
(1/45): byacc-1.9.20130304-3.el7.x86_64.rpm | 65 kB 00:00:00

=== SNIP ===

(45/45): zip-3.0-11.el7.x86_64.rpm | 260 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 13 MB/s | 30 MB 00:00:02
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : m4-1.4.16-10.el7.x86_64 1/45

=== SNIP ===

Installing : 2:xinetd-2.3.15-14.el7.x86_64 45/45
Verifying : gcc-c++-4.8.5-44.el7.x86_64 1/45

=== SNIP ===

Verifying : gnutls-devel-3.3.29-9.el7_6.x86_64 45/45

Installed:
bison.x86_64 0:3.0.4-2.el7 byacc.x86_64 0:1.9.20130304-3.el7
flex.x86_64 0:2.5.37-6.el7 ftp.x86_64 0:0.17-67.el7
gcc-c++.x86_64 0:4.8.5-44.el7 gnutls-devel.x86_64 0:3.3.29-9.el7_6
libcurl-devel.x86_64 0:7.29.0-59.el7_9.1 libusb-devel.x86_64 1:0.1.4-3.el7
libxml2-devel.x86_64 0:2.9.1-6.el7.5 mailx.x86_64 0:12.5-19.el7
mariadb.x86_64 1:5.5.68-1.el7 mariadb-devel.x86_64 1:5.5.68-1.el7
ncurses-devel.x86_64 0:5.9-14.20130511.el7_4 newt-devel.x86_64 0:0.52.15-4.el7
rpm-build.x86_64 0:4.11.3-45.el7 rsync.x86_64 0:3.1.2-10.el7
sendmail.x86_64 0:8.14.7-6.el7 xinetd.x86_64 2:2.3.15-14.el7

Dependency Installed:
bzip2.x86_64 0:1.0.6-13.el7 cyrus-sasl.x86_64 0:2.1.26-23.el7
dwz.x86_64 0:0.11-3.el7 elfutils.x86_64 0:0.176-5.el7
gdb.x86_64 0:7.6.1-120.el7 gmp-devel.x86_64 1:6.0.0-15.el7
gnutls-c++.x86_64 0:3.3.29-9.el7_6 gnutls-dane.x86_64 0:3.3.29-9.el7_6
hesiod.x86_64 0:3.2.1-3.el7 libevent.x86_64 0:2.0.21-4.el7
libstdc++-devel.x86_64 0:4.8.5-44.el7 libtasn1-devel.x86_64 0:4.10-1.el7
libusb.x86_64 1:0.1.4-3.el7 libusbx.x86_64 0:1.0.21-1.el7
m4.x86_64 0:1.4.16-10.el7 nettle-devel.x86_64 0:2.7.1-8.el7
p11-kit-devel.x86_64 0:0.23.5-3.el7 patch.x86_64 0:2.7.1-12.el7_7
perl-Thread-Queue.noarch 0:3.02-2.el7 perl-srpm-macros.noarch 0:1-8.el7
procmail.x86_64 0:3.22-36.el7_4.1 python-srpm-macros.noarch 0:3-34.el7
redhat-rpm-config.noarch 0:9.1.0-88.el7.centos slang-devel.x86_64 0:2.2.4-11.el7
unbound-libs.x86_64 0:1.6.6-5.el7_8 unzip.x86_64 0:6.0-21.el7
zip.x86_64 0:3.0-11.el7

Complete!
== Generate RSA Key ==

<pre>
[root@cn38-inverness-co ~]# ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Created directory '/root/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:FKpB44T5QoKCZtkOoU4ZF6w7T0G98QZ60gHU9QpQM9k root@cn38-inverness-co.suburbanbroadband.net
The key's randomart image is:
+---[RSA 2048]----+
|oo*OX++.. |
|*=BB.OoE.. |
|===.=.B .. |
|o..=.*.+. |
| ...= ..S |
| o . |
| + |
| . |
| |
+----[SHA256]-----+

</pre>

== Install UW-IMAP library for IMAP integration for Voice Mails ==

We will want to configure Asterisk to store voicemails via IMAP instead of the local file system. This will allow better deployment of HA down the road.

=== Download uw-imap for storage ===

The UW-IMAP code is no longer maintained after the creator's death, so it's a good idea to archive the important parts.

<pre>
[root@cn38-inverness-co ~]# wget https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/u/uw-imap-2007f-16.el7.x86_64.rpm

--2020-12-02 18:34:30-- https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/u/uw-imap-2007f-16.el7.x86_64.rpm
Resolving download-ib01.fedoraproject.org (download-ib01.fedoraproject.org)... 152.19.134.145, 2610:28:3090:3001:dead:beef:cafe:fed6
Connecting to download-ib01.fedoraproject.org (download-ib01.fedoraproject.org)|152.19.134.145|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 68284 (67K) [application/x-rpm]
Saving to: ‘uw-imap-2007f-16.el7.x86_64.rpm’

100%[====================================================================>] 68,284 --.-K/s in 0.09s

2020-12-02 18:34:31 (703 KB/s) - ‘uw-imap-2007f-16.el7.x86_64.rpm’ saved [68284/68284]
</pre>

=== Install EPEL repo ===

We'll use EPEL to install UW-IMAP, so we have to install that first. After installation, we can go back in and disable teh EPEL repo, if we desire.

<pre>

[root@cn38-inverness-co ~]# yum -y install epel-release

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package epel-release.noarch 0:7-11 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
epel-release noarch 7-11 extras 15 k

Transaction Summary
==============================================================================================================
Install 1 Package

Total download size: 15 k
Installed size: 24 k
Downloading packages:
epel-release-7-11.noarch.rpm | 15 kB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : epel-release-7-11.noarch 1/1
Verifying : epel-release-7-11.noarch 1/1

Installed:
epel-release.noarch 0:7-11

Complete!

</pre>

=== Install uw-imap ===

Finally, the install of UW-IMAP. It will require an additional dependency be installed.

<pre>
[root@cn38-inverness-co ~]# yum install uw-imap

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
epel/x86_64/metalink | 13 kB 00:00:00
* base: mirror.dal10.us.leaseweb.net
* epel: mirror.dal.nexril.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
epel | 4.7 kB 00:00:00
(1/3): epel/x86_64/group_gz | 95 kB 00:00:00
(2/3): epel/x86_64/updateinfo | 1.0 MB 00:00:00
(3/3): epel/x86_64/primary_db | 6.9 MB 00:00:00
Resolving Dependencies
--> Running transaction check
---> Package uw-imap.x86_64 0:2007f-16.el7 will be installed
--> Processing Dependency: libc-client(x86-64) = 2007f-16.el7 for package: uw-imap-2007f-16.el7.x86_64
--> Processing Dependency: libc-client.so.2007()(64bit) for package: uw-imap-2007f-16.el7.x86_64
--> Running transaction check
---> Package libc-client.x86_64 0:2007f-16.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
uw-imap x86_64 2007f-16.el7 epel 67 k
Installing for dependencies:
libc-client x86_64 2007f-16.el7 epel 562 k

Transaction Summary
==============================================================================================================
Install 1 Package (+1 Dependent package)

Total download size: 628 k
Installed size: 1.6 M
Is this ok [y/d/N]: y
Downloading packages:
warning: /var/cache/yum/x86_64/7/epel/packages/libc-client-2007f-16.el7.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 352c64e5: NOKEY
Public key for libc-client-2007f-16.el7.x86_64.rpm is not installed
(1/2): libc-client-2007f-16.el7.x86_64.rpm | 562 kB 00:00:00
(2/2): uw-imap-2007f-16.el7.x86_64.rpm | 67 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.0 MB/s | 628 kB 00:00:00
Retrieving key from file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Importing GPG key 0x352C64E5:
Userid : "Fedora EPEL (7) <epel@fedoraproject.org>"
Fingerprint: 91e9 7d7c 4a5e 96f1 7f3e 888f 6a2f aea2 352c 64e5
Package : epel-release-7-11.noarch (@extras)
From : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Is this ok [y/N]: y
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libc-client-2007f-16.el7.x86_64 1/2
Installing : uw-imap-2007f-16.el7.x86_64 2/2
Verifying : libc-client-2007f-16.el7.x86_64 1/2
Verifying : uw-imap-2007f-16.el7.x86_64 2/2

Installed:
uw-imap.x86_64 0:2007f-16.el7

Dependency Installed:
libc-client.x86_64 0:2007f-16.el7

Complete!

</pre>

== Download Asterisk 18.1.0 ==

Change directory to /usr/local/src and download the Asterisk source code.

<pre>
[root@cn38-inverness-co ~]# cd /usr/local/src/

[root@cn38-inverness-co src]# wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz

--2020-12-02 17:39:25-- https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 27886299 (27M) [application/x-gzip]
Saving to: ‘asterisk-18-current.tar.gz’

100%[====================================================================>] 27,886,299 8.03MB/s in 3.3s

2020-12-02 17:39:29 (8.03 MB/s) - ‘asterisk-18-current.tar.gz’ saved [27886299/27886299]
</pre>

For future reference, you can also find it directly here:

[https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz]

== Uncompress Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co src]# tar -zxf asterisk-18-current.tar.gz

[root@cn38-inverness-co src]# ls
asterisk-18.1.0

[root@cn38-inverness-co src]# cd asterisk-18.1.0/

[root@cn38-inverness-co asterisk-18.1.0]# ls
addons channels include README-SERIOUSLY.bestpractices.md
agi codecs install-sh res
apps config.guess LICENSE rest-api
asterisk-18.1.0-summary.html configs main rest-api-templates
asterisk-18.1.0-summary.txt config.sub Makefile sample.call
autoconf configure Makefile.moddir_rules sounds
bootstrap.sh configure.ac Makefile.rules static-http
bridges contrib makeopts.in tests
BSDmakefile COPYING menuselect third-party
BUGS CREDITS missing UPGRADE.txt
build_tools default.exports mkinstalldirs utils
cdr doc pbx Zaptel-to-DAHDI.txt
cel formats phoneprov
ChangeLog funcs README-addons.txt
CHANGES images README.md

</pre>

== Test the prereqs ==

Run the '''"./contrib/scripts/install_prereq test"''' command in order to test the installed prerequesits. After it returns the things that need to be installed, you can just copy and paste that command. If there are packages that are not installed afterthe command due to not existing in the CentOS 7 main repo, they are probably not required.

<pre>

[root@cn38-inverness-co asterisk-18.1.0]# ./contrib/scripts/install_prereq test

#############################################
## test: test mode.
## Use the commands here to install your system.
#############################################
yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

[root@cn38-inverness-co asterisk-18.1.0]# yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
No package speexdsp-devel available.
No package portaudio-devel available.
No package xmlstarlet available.
No package gmime-devel available.
Package 1:mariadb-devel-5.5.68-1.el7.x86_64 already installed and latest version
No package radcli-devel available.
No package freetds-devel available.
No package jack-audio-connection-kit-devel available.
No package iksemel-devel available.
No package spandsp-devel available.
No package libresample-devel available.
No package uw-imap-devel available.
No package hoard available.
No package codec2-devel available.
Resolving Dependencies
--> Running transaction check
---> Package alsa-lib-devel.x86_64 0:1.1.8-1.el7 will be installed

=== SNIP ===

---> Package mesa-libglapi.x86_64 0:18.3.4-12.el7_9 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
alsa-lib-devel x86_64 1.1.8-1.el7 base 963 k

=== SNIP ===

uriparser-devel x86_64 0.7.5-10.el7 base 138 k
Installing for dependencies:
adobe-mappings-cmap noarch 20171205-3.el7 base 2.1 M

=== SNIP ===

xorg-x11-server-utils x86_64 7.7-20.el7 base 178 k

Transaction Summary
==============================================================================================================
Install 28 Packages (+117 Dependent packages)

Total download size: 56 M
Installed size: 216 M
Downloading packages:
(1/145): adobe-mappings-cmap-deprecated-20171205-3.el7.noarch.rpm | 114 kB 00:00:00

=== SNIP ===

(145/145): xorg-x11-server-utils-7.7-20.el7.x86_64.rpm | 178 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 9.3 MB/s | 56 MB 00:00:06
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libjpeg-turbo-1.2.90-8.el7.x86_64 1/145

=== SNIP ===

Installing : libedit-devel-3.0-12.20121213cvs.el7.x86_64 145/145
Verifying : libXext-1.3.3-3.el7.x86_64 1/145

=== SNIP ===

Verifying : libcgroup-0.41-21.el7.x86_64 145/145

Installed:
alsa-lib-devel.x86_64 0:1.1.8-1.el7 binutils-devel.x86_64 0:2.27-44.base.el7

=== SNIP ===

Dependency Installed:
adobe-mappings-cmap.noarch 0:20171205-3.el7

=== SNIP ===

Complete!
</pre>

== Run ./configure for Asterisk ==

For CentOS 7.X, you will get an error about needing a newer version of jansson library. It may be possible to manually install the newer version, however it is probaly fine to just use the '''--with-jansson-bundled''' flag to include the version bundled with Asterisk source code.

In addition, we will want to load the bundled pjsip channel drivers, with the '''--with-pjproject-pundled'''.

Hopefully this completed without any issues, however you should look over the output to ensure it is what you are expecting.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ./configure --with-jansson-bundled --with-pjproject-bundled

checking build system type... x86_64-pc-linux-gnu

=== SNIP ===

checking for pkg-config... /bin/pkg-config
checking pkg-config is at least version 0.9.0... yes
checking for GTK2... no
configure: creating ./config.status
config.status: creating makeopts
config.status: creating autoconfig.h
configure: Menuselect build configuration successfully completed

.$$$$$$$$$$$$$$$=..
.$7$7.. .7$$7:.
.$$:. ,$7.7
.$7. 7$$$$ .$$77
..$$. $$$$$ .$$$7
..7$ .?. $$$$$ .?. 7$$$.
$.$. .$$$7. $$$$7 .7$$$. .$$$.
.777. .$$$$$$77$$$77$$$$$7. $$$,
$$$~ .7$$$$$$$$$$$$$7. .$$$.
.$$7 .7$$$$$$$7: ?$$$.
$$$ ?7$$$$$$$$$$I .$$$7
$$$ .7$$$$$$$$$$$$$$$$ :$$$.
$$$ $$$$$$7$$$$$$$$$$$$ .$$$.
$$$ $$$ 7$$$7 .$$$ .$$$.
$$$$ $$$$7 .$$$.
7$$$7 7$$$$ 7$$$
$$$$$ $$$
$$$$7. $$ (TM)
$$$$$$$. .7$$$$$$ $$
$$$$$$$$$$$$7$$$$$$$$$.$$$$$$
$$$$$$$$$$$$$$$$.

configure: Package configured for:
configure: OS type : linux-gnu
configure: Host CPU : x86_64
configure: build-cpu:vendor:os: x86_64 : pc : linux-gnu :
configure: host-cpu:vendor:os: x86_64 : pc : linux-gnu :

</pre>

== make menuselect ==

By default, a lot of options are not included in the Asterisk build, and need to be configured. This is done by running the '''"make menu"''' command in the asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make menuselect

CC="cc" CXX="g++" LD="" AR="" RANLIB="" CFLAGS="" LDFLAGS="" make -C menuselect CONFIGURE_SILENT="--silent" gmenuselect
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Nothing to be done for `gmenuselect'.
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0'
menuselect changes saved!
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0'

</pre>

In '''Add-ons''', select '''chan_ooh323''', '''format_mp3''', '''res_config_mysql''', '''app_mysql''' and '''crd_mysql'''.

[[File:Asterisk1810-Add-ons.png|none|frame|Add-ons]]

In '''Core Sound Packages''', select '''EN-WAV''', '''EN-ULAW''', '''EN-ALAW''', '''EN-GSM''', '''EN-G729''', '''EN-G722''', '''EN-SLN16''', '''EN-SIREN7''', and '''EN-SIREN14'''.

[[File:Asterisk1810-coresound.png|none|frame|Core Sound Packages]]

In '''Music On Hold File Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-musiconhold.png|none|frame|Music On Hold File Packages]]

In '''Extras Sound Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-extrasound.png|none|frame|Extras Sound Packages]]

In '''Applications''', select '''app_voicemail''', '''app_voicemail_imap''', '''app_voicemail_odbc''', '''app_macro'''.

[[File:Asterisk1810-applications1.png|none|frame|Applications Voicemail]]
[[File:Asterisk1810-applications2.png|none|frame|Applications Macro]]

== Download MP3 sources ==

Download the required MP3 sources by running the '''contrib/scripts/get_mp3_source.sh''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# contrib/scripts/get_mp3_source.sh

A addons/mp3
A addons/mp3/MPGLIB_TODO
A addons/mp3/mpg123.h
A addons/mp3/layer3.c
A addons/mp3/mpglib.h
A addons/mp3/decode_ntom.c
A addons/mp3/interface.c
A addons/mp3/MPGLIB_README
A addons/mp3/common.c
A addons/mp3/huffman.h
A addons/mp3/tabinit.c
A addons/mp3/Makefile
A addons/mp3/README
A addons/mp3/decode_i386.c
A addons/mp3/dct64_i386.c
Exported revision 202.
</pre>

== Compile Asterisk 18.1.0 ==

We compile the Asterisk code by running the '''make''' command inside the build directory. This should compile at this point, but if there are any errors, additional changes to the system may be required. ''The output below is shortened for space.''

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make

[CC] astcanary.c -> astcanary.o
[LD] astcanary.o -> astcanary
[CC] astdb2sqlite3.c -> astdb2sqlite3.o
[CC] hash/hash.c -> hash/hash.o
[CC] hash/hash_bigkey.c -> hash/hash_bigkey.o
[CC] hash/hash_buf.c -> hash/hash_buf.o
[CC] hash/hash_func.c -> hash/hash_func.o
[CC] hash/hash_log2.c -> hash/hash_log2.o
[CC] hash/hash_page.c -> hash/hash_page.o

=== SNIP ===

[LD] chan_ooh323.o ooh323c/src/ooCmdChannel.o ooh323c/src/ooLogChan.o ooh323c/src/ooUtils.o ooh323c/src/ooGkClient.o ooh323c/src/context.o ooh323c/src/ooDateTime.o ooh323c/src/decode.o ooh323c/src/dlist.o ooh323c/src/encode.o ooh323c/src/errmgmt.o ooh323c/src/memheap.o ooh323c/src/ootrace.o ooh323c/src/oochannels.o ooh323c/src/ooh245.o ooh323c/src/ooports.o ooh323c/src/ooq931.o ooh323c/src/ooCapability.o ooh323c/src/ooSocket.o ooh323c/src/perutil.o ooh323c/src/eventHandler.o ooh323c/src/ooCalls.o ooh323c/src/ooStackCmds.o ooh323c/src/ooh323.o ooh323c/src/ooh323ep.o ooh323c/src/printHandler.o ooh323c/src/rtctype.o ooh323c/src/ooTimer.o ooh323c/src/h323/H235-SECURITY-MESSAGESDec.o ooh323c/src/h323/H235-SECURITY-MESSAGESEnc.o ooh323c/src/h323/H323-MESSAGES.o ooh323c/src/h323/H323-MESSAGESDec.o ooh323c/src/h323/H323-MESSAGESEnc.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROL.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLDec.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLEnc.o ooh323cDriver.o -> chan_ooh323.so
[CC] format_mp3.c -> format_mp3.o
[CC] mp3/common.c -> mp3/common.o
[CC] mp3/dct64_i386.c -> mp3/dct64_i386.o
[CC] mp3/decode_ntom.c -> mp3/decode_ntom.o
[CC] mp3/layer3.c -> mp3/layer3.o
[CC] mp3/tabinit.c -> mp3/tabinit.o
[CC] mp3/interface.c -> mp3/interface.o
[LD] format_mp3.o mp3/common.o mp3/dct64_i386.o mp3/decode_ntom.o mp3/layer3.o mp3/tabinit.o mp3/interface.o -> format_mp3.so
[CC] res_config_mysql.c -> res_config_mysql.o
[LD] res_config_mysql.o -> res_config_mysql.so
Building Documentation For: third-party channels pbx apps codecs formats cdr cel bridges funcs tests main res addons
+--------- Asterisk Build Complete ---------+
+ Asterisk has successfully been built, and +
+ can be installed by running: +
+ +
+ make install +
+-------------------------------------------+
</pre>

== Install for Asterisk 18.1.0 ==

We install Asterisk by running the '''make install''' command in the Asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make install
Installing modules from channels...
Installing modules from pbx...
Installing modules from apps...
Installing modules from codecs...
Installing modules from formats...
Installing modules from cdr...
Installing modules from cel...
Installing modules from bridges...
Installing modules from funcs...
Installing modules from tests...
Installing modules from main...
Installing modules from res...
Installing modules from addons...
/bin/install -c -m 755 contrib/scripts/astversion "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/astgenkey "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/autosupport "/usr/sbin/"
if [ ! -f /sbin/launchd ]; then \
./build_tools/install_subst contrib/scripts/safe_asterisk "/usr/sbin/safe_asterisk"; \
fi
/bin/install -c -m 644 doc/core-*.xml "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.dtd "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/asterisk.8 "/usr/share/man/man8"
/bin/install -c -m 644 doc/astdb*.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/astgenkey.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/autosupport.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/safe_asterisk.8 "/usr/share/man/man8"
if [ -f contrib/firmware/iax/iaxy.bin ] ; then \
/bin/install -c -m 644 contrib/firmware/iax/iaxy.bin "/var/lib/asterisk/firmware/iax/iaxy.bin"; \
fi
CFLAGS=" -I/usr/include/libxml2 -pipe -Wall -Wstrict-prototypes -Wmissing-prototypes -Wmissing-declarations -g3 " build_tools/mkpkgconfig "/usr/lib/pkgconfig";
find static-http | while read x; do \
if test -d $x; then \
/bin/install -c -m 755 -d "/var/lib/asterisk/$x"; \
else \
/bin/install -c -m 644 $x "/var/lib/asterisk/$x" ; \
fi \
done
/bin/install -c -m 644 doc/core-en_US.xml "/var/lib/asterisk/static-http";
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/static-http";
if [ -d doc/tex/asterisk ] ; then \
/bin/install -c -d "/var/lib/asterisk/static-http/docs" ; \
for n in doc/tex/asterisk/* ; do \
/bin/install -c -m 644 $n "/var/lib/asterisk/static-http/docs" ; \
done \
fi
for x in images/*.jpg; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/images" ; \
done
make -C sounds install
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/sounds'
--2020-12-02 18:52:05-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-wav-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 20176188 (19M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’

100%[====================================================================>] 20,176,188 7.79MB/s in 2.5s

2020-12-02 18:52:08 (7.79 MB/s) - ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’ saved [20176188/20176188]

--2020-12-02 18:52:09-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-ulaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10241447 (9.8M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’

100%[====================================================================>] 10,241,447 1.71MB/s in 6.4s

2020-12-02 18:52:15 (1.52 MB/s) - ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’ saved [10241447/10241447]

--2020-12-02 18:52:16-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-alaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9937284 (9.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’

100%[====================================================================>] 9,937,284 3.40MB/s in 2.8s

2020-12-02 18:52:18 (3.40 MB/s) - ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’ saved [9937284/9937284]

--2020-12-02 18:52:19-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g729-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1557751 (1.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’

100%[====================================================================>] 1,557,751 2.78MB/s in 0.5s

2020-12-02 18:52:20 (2.78 MB/s) - ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’ saved [1557751/1557751]

--2020-12-02 18:52:20-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g722-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10756090 (10M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’

100%[====================================================================>] 10,756,090 6.58MB/s in 1.6s

2020-12-02 18:52:21 (6.58 MB/s) - ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’ saved [10756090/10756090]

--2020-12-02 18:52:22-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-sln16-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 41366110 (39M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’

100%[====================================================================>] 41,366,110 11.1MB/s in 3.9s

2020-12-02 18:52:26 (10.1 MB/s) - ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’ saved [41366110/41366110]

--2020-12-02 18:52:27-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren7-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 6028362 (5.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’

100%[====================================================================>] 6,028,362 7.39MB/s in 0.8s

2020-12-02 18:52:27 (7.39 MB/s) - ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’ saved [6028362/6028362]

--2020-12-02 18:52:28-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren14-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9120763 (8.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’

100%[====================================================================>] 9,120,763 8.37MB/s in 1.0s

2020-12-02 18:52:29 (8.37 MB/s) - ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’ saved [9120763/9120763]

--2020-12-02 18:52:29-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-wav-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 35362826 (34M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’

100%[====================================================================>] 35,362,826 8.66MB/s in 4.1s

2020-12-02 18:52:33 (8.29 MB/s) - ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’ saved [35362826/35362826]

--2020-12-02 18:52:34-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 18007258 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’

100%[====================================================================>] 18,007,258 9.70MB/s in 1.8s

2020-12-02 18:52:36 (9.70 MB/s) - ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’ saved [18007258/18007258]

--2020-12-02 18:52:37-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-alaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 17464549 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’

100%[====================================================================>] 17,464,549 9.37MB/s in 1.8s

2020-12-02 18:52:39 (9.37 MB/s) - ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’ saved [17464549/17464549]

--2020-12-02 18:52:39-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-gsm-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 4253587 (4.1M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’

100%[====================================================================>] 4,253,587 6.67MB/s in 0.6s

2020-12-02 18:52:40 (6.67 MB/s) - ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’ saved [4253587/4253587]

--2020-12-02 18:52:41-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-ulaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7479839 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’

100%[====================================================================>] 7,479,839 7.98MB/s in 0.9s

2020-12-02 18:52:42 (7.98 MB/s) - ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’ saved [7479839/7479839]

--2020-12-02 18:52:42-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-alaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7496413 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-alaw-2.03.tar.gz’

100%[====================================================================>] 7,496,413 8.03MB/s in 0.9s

2020-12-02 18:52:43 (8.03 MB/s) - ‘asterisk-moh-opsound-alaw-2.03.tar.gz’ saved [7496413/7496413]

--2020-12-02 18:52:43-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-gsm-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1777967 (1.7M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-gsm-2.03.tar.gz’

100%[====================================================================>] 1,777,967 4.09MB/s in 0.4s

2020-12-02 18:52:44 (4.09 MB/s) - ‘asterisk-moh-opsound-gsm-2.03.tar.gz’ saved [1777967/1777967]

make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/sounds'
find rest-api -name "*.json" | while read x; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/rest-api" ; \
done
+---- Asterisk Installation Complete -------+
+ +
+ YOU MUST READ THE SECURITY DOCUMENT +
+ +
+ Asterisk has successfully been installed. +
+ If you would like to install the sample +
+ configuration files (overwriting any +
+ existing config files), run: +
+ +
+ For generic reference documentation: +
+ make samples +
+ +
+ For a sample basic PBX: +
+ make basic-pbx +
+ +
+ +
+----------------- or ---------------------+
+ +
+ You can go ahead and install the asterisk +
+ program documentation now or later run: +
+ +
+ make progdocs +
+ +
+ **Note** This requires that you have +
+ doxygen installed on your local system +
+-------------------------------------------+
</pre>

== Install Program Docs ==

Install the program documentation by running the '''make progdocs''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make progdocs

# Enable DOT
# Set Doxygen PROJECT_NUMBER variable
# Validate and auto-update local copy
Warning: Tag `SYMBOL_CACHE_SIZE' at line 291 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `SHOW_DIRECTORIES' at line 491 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `HTML_ALIGN_MEMBERS' at line 859 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `USE_INLINE_TREES' at line 1044 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"

Configuration file `doc/asterisk-ng-doxygen' updated.

# Run Doxygen
Warning: doxygen no longer ships with the FreeSans font.
You may want to clear or change DOT_FONTNAME.
Otherwise you run the risk that the wrong font is being used for dot generated graphs.
Searching for include files...
Searching for files in directory /usr/local/src/asterisk-18.1.0
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/mp3
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/ooh323c

=== SNIP ===

Patching output file 2546/2550
Patching output file 2547/2550
Patching output file 2548/2550
Patching output file 2549/2550
Patching output file 2550/2550
lookup cache used 65536/65536 hits=1461947 misses=70524
finished...
# Remove configuration backup file
</pre>

== Make the Asterisk 18.1.0 sample configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make samples
Installing adsi config files...
/bin/install -c -d "/etc/asterisk"
Installing configs/samples/asterisk.adsi
Installing configs/samples/telcordia-1.adsi
Installing other config files...
Installing file configs/samples/acl.conf.sample
Installing file configs/samples/adsi.conf.sample
Installing file configs/samples/agents.conf.sample
Installing file configs/samples/alarmreceiver.conf.sample
Installing file configs/samples/alsa.conf.sample
Installing file configs/samples/amd.conf.sample
Installing file configs/samples/app_mysql.conf.sample
Installing file configs/samples/app_skel.conf.sample
Installing file configs/samples/ari.conf.sample
Installing file configs/samples/ast_debug_tools.conf.sample
Installing file configs/samples/asterisk.conf.sample
Installing file configs/samples/calendar.conf.sample
Installing file configs/samples/ccss.conf.sample
Installing file configs/samples/cdr_adaptive_odbc.conf.sample
Installing file configs/samples/cdr_beanstalkd.conf.sample
Installing file configs/samples/cdr.conf.sample
Installing file configs/samples/cdr_custom.conf.sample
Installing file configs/samples/cdr_manager.conf.sample
Installing file configs/samples/cdr_mysql.conf.sample
Installing file configs/samples/cdr_odbc.conf.sample
Installing file configs/samples/cdr_pgsql.conf.sample
Installing file configs/samples/cdr_sqlite3_custom.conf.sample
Installing file configs/samples/cdr_syslog.conf.sample
Installing file configs/samples/cdr_tds.conf.sample
Installing file configs/samples/cel_beanstalkd.conf.sample
Installing file configs/samples/cel.conf.sample
Installing file configs/samples/cel_custom.conf.sample
Installing file configs/samples/cel_odbc.conf.sample
Installing file configs/samples/cel_pgsql.conf.sample
Installing file configs/samples/cel_sqlite3_custom.conf.sample
Installing file configs/samples/cel_tds.conf.sample
Installing file configs/samples/chan_dahdi.conf.sample
Installing file configs/samples/chan_mobile.conf.sample
Installing file configs/samples/cli_aliases.conf.sample
Installing file configs/samples/cli.conf.sample
Installing file configs/samples/cli_permissions.conf.sample
Installing file configs/samples/codecs.conf.sample
Installing file configs/samples/confbridge.conf.sample
Installing file configs/samples/config_test.conf.sample
Installing file configs/samples/console.conf.sample
Installing file configs/samples/dbsep.conf.sample
Installing file configs/samples/dnsmgr.conf.sample
Installing file configs/samples/dsp.conf.sample
Installing file configs/samples/dundi.conf.sample
Installing file configs/samples/enum.conf.sample
Installing file configs/samples/extconfig.conf.sample
Installing file configs/samples/extensions.ael.sample
Installing file configs/samples/extensions.conf.sample
Installing file configs/samples/extensions.lua.sample
Installing file configs/samples/extensions_minivm.conf.sample
Installing file configs/samples/features.conf.sample
Installing file configs/samples/festival.conf.sample
Installing file configs/samples/followme.conf.sample
Installing file configs/samples/func_odbc.conf.sample
Installing file configs/samples/hep.conf.sample
Installing file configs/samples/http.conf.sample
Installing file configs/samples/iax.conf.sample
Installing file configs/samples/iaxprov.conf.sample
Installing file configs/samples/indications.conf.sample
Installing file configs/samples/logger.conf.sample
Installing file configs/samples/manager.conf.sample
Installing file configs/samples/meetme.conf.sample
Installing file configs/samples/mgcp.conf.sample
Installing file configs/samples/minivm.conf.sample
Installing file configs/samples/misdn.conf.sample
Installing file configs/samples/modules.conf.sample
Installing file configs/samples/motif.conf.sample
Installing file configs/samples/musiconhold.conf.sample
Installing file configs/samples/muted.conf.sample
Installing file configs/samples/ooh323.conf.sample
Installing file configs/samples/osp.conf.sample
Installing file configs/samples/oss.conf.sample
Installing file configs/samples/phone.conf.sample
Installing file configs/samples/phoneprov.conf.sample
Installing file configs/samples/pjproject.conf.sample
Installing file configs/samples/pjsip.conf.sample
Installing file configs/samples/pjsip_notify.conf.sample
Installing file configs/samples/pjsip_wizard.conf.sample
Installing file configs/samples/prometheus.conf.sample
Installing file configs/samples/queuerules.conf.sample
Installing file configs/samples/queues.conf.sample
Installing file configs/samples/res_config_mysql.conf.sample
Installing file configs/samples/res_config_sqlite3.conf.sample
Installing file configs/samples/res_config_sqlite.conf.sample
Installing file configs/samples/res_corosync.conf.sample
Installing file configs/samples/res_curl.conf.sample
Installing file configs/samples/res_fax.conf.sample
Installing file configs/samples/res_ldap.conf.sample
Installing file configs/samples/res_odbc.conf.sample
Installing file configs/samples/resolver_unbound.conf.sample
Installing file configs/samples/res_parking.conf.sample
Installing file configs/samples/res_pgsql.conf.sample
Installing file configs/samples/res_pktccops.conf.sample
Installing file configs/samples/res_snmp.conf.sample
Installing file configs/samples/res_stun_monitor.conf.sample
Installing file configs/samples/rtp.conf.sample
Installing file configs/samples/say.conf.sample
Installing file configs/samples/sip.conf.sample
Installing file configs/samples/sip_notify.conf.sample
Installing file configs/samples/skinny.conf.sample
Installing file configs/samples/sla.conf.sample
Installing file configs/samples/smdi.conf.sample
Installing file configs/samples/sorcery.conf.sample
Installing file configs/samples/ss7.timers.sample
Installing file configs/samples/stasis.conf.sample
Installing file configs/samples/statsd.conf.sample
Installing file configs/samples/stir_shaken.conf.sample
Installing file configs/samples/test_sorcery.conf.sample
Installing file configs/samples/udptl.conf.sample
Installing file configs/samples/unistim.conf.sample
Installing file configs/samples/users.conf.sample
Installing file configs/samples/voicemail.conf.sample
Installing file configs/samples/vpb.conf.sample
Installing file configs/samples/xmpp.conf.sample
Updating asterisk.conf
/bin/install -c -d "/var/spool/asterisk/voicemail/default/1234/INBOX"
build_tools/make_sample_voicemail "//var/lib/asterisk" "//var/spool/asterisk"
Installing file phoneprov/000000000000.cfg
Installing file phoneprov/000000000000-directory.xml
Installing file phoneprov/000000000000-phone.cfg
Installing file phoneprov/polycom_line.xml
Installing file phoneprov/polycom.xml
Installing file phoneprov/snom-mac.xml
</pre>

== Make the Asterisk 18.1.0 configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make config
</pre>

== Set ldconfig ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ldconfig
</pre>

== Setup user, group and permissions ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# groupadd asterisk
[root@cn38-inverness-co asterisk-18.1.0]# useradd -r -d /var/lib/asterisk -g asterisk asterisk
[root@cn38-inverness-co asterisk-18.1.0]# usermod -aG audio,dialout asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /etc/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /var/{lib,log,spool}/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /usr/lib/asterisk
</pre>

== Set runtime parameters ==

Need to change things in there.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/sysconfig/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/asterisk/asterisk.conf
</pre>

== Enable and Start Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl enable asterisk

asterisk.service is not a native service, redirecting to /sbin/chkconfig.
Executing /sbin/chkconfig asterisk on

[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl start asterisk

</pre>

== Connect to Asterisk and verify version ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# asterisk -rvv

parse error: No category context for line 1 of /etc/asterisk/asterisk.conf
Unable to open specified master config file '/etc/asterisk/asterisk.conf', using built-in defaults
Asterisk 18.1.0, Copyright (C) 1999 - 2018, Digium, Inc. and others.
Created by Mark Spencer <markster@digium.com>
Asterisk comes with ABSOLUTELY NO WARRANTY; type 'core show warranty' for details.
This is free software, with components licensed under the GNU General Public
License version 2 and other licenses; you are welcome to redistribute it under
certain conditions. Type 'core show license' for details.
=========================================================================
Connected to Asterisk 18.1.0 currently running on cn38-inverness-co (pid = 18370)
cn38-inverness-co*CLI>
Disconnected from Asterisk server
Asterisk cleanly ending (0).
Executing last minute cleanups
</pre>

= Configure Asterisk =

== Version 1.8 to 18.1.0 Errors ==

chan_agent => chan_agent_pool

chan_local => Asterisk core, no loadable module

bridge_multiplexed => ?

app_meetme => Part of DAHDI. Replaced by app_confbridge

Failed to resolve dependencies for func_curl

Failed to resolve dependencies for res_config_curl

Failed to resolve dependencies for app_page

User:Sfiggins/Asterisk 18 on CentOS7

2020-12-04T02:40:29Z

Sfiggins: /* Install UW-IMAP library for IMAP integration for Voice Mails */

= Install and Configure Base OS =

== Install from CentOS 7 CD (Minimal Install) ==

== Log into newly installed server ==

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
sfiggins@cn38-inverness-co.suburbanbroadband.net's password:
</pre>

== Setting up PSK login access, if desired ==

=== Copy authorized_keys from another server ===

I have another server that already has my authorized keys, so I"ll copy it from there. You can also past in your RSA key into '''~/.ssh/authorized_keys''', if you prefer.

<pre>
[sfiggins@cn38-inverness-co ~]$ scp -r 216.112.193.138:.ssh/ .

The authenticity of host '216.112.193.138 (216.112.193.138)' can't be established.
RSA key fingerprint is 5f:61:91:46:5c:c8:4c:a1:2e:25:0b:61:1e:97:d9:ed.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '216.112.193.138' (RSA) to the list of known hosts.
sfiggins@216.112.193.138's password:
known_hosts 100% 397 0.4KB/s 00:00
authorized_keys 100% 414 0.4KB/s 00:00

[sfiggins@cn38-inverness-co ~]$ logout
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

=== Login in using private key ===

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
Last login: Wed Dec 2 17:21:54 2020 from 209.116.189.54
</pre>

== Sudo to Root ==

All the installation steps in this guide must be performed as root. You can either prefix each command with '''"sudo"''' or just use sudo to become the '''root''' account and execute them as listed.

<pre>
[sfiggins@cn38-inverness-co ~]$ sudo su -

We trust you have received the usual lecture from the local System
Administrator. It usually boils down to these three things:

#1) Respect the privacy of others.
#2) Think before you type.
#3) With great power comes great responsibility.

[sudo] password for sfiggins:
Last login: Wed Dec 2 16:46:45 MST 2020 on tty1
</pre>

== Fix Sudoers ==

This fix will remove the need to reenter your puser password when running the '''"sudo"''' command. This is a preference, and does not need to be done if you prefer to enter the password each time.

<pre>
[root@cn38-inverness-co ~]# vi /etc/sudoers
</pre>

Comment out the below matching line, by adding '''"# "''' in beginning of the line.

<pre>
%wheel ALL=(ALL) ALL
</pre>

Remove the comment from the below matching line by removing the '''"# "''' from the beginning of the line.

<pre>
# %wheel ALL=(ALL) NOPASSWD: ALL
</pre>

Save this file using the '''":wq!"''' command, as this file is read-only.

== Disable and remove NetworkManager ==

The '''NetworkManager''' packages are not needed on a Linux server and they just get in the way. Removing them is the best option. They are more useful on a workstation that will be changing networks frequently.

<pre>
[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager

rm '/etc/systemd/system/multi-user.target.wants/NetworkManager.service'
rm '/etc/systemd/system/dbus-org.freedesktop.nm-dispatcher.service'
rm '/etc/systemd/system/dbus-org.freedesktop.NetworkManager.service'

[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager-dispatcher

[root@cn38-inverness-co ~]# yum erase NetworkManager-tui NetworkManager-glib NetworkManager

Loaded plugins: fastestmirror
No Match for argument: NetworkManager-glib
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
---> Package NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
NetworkManager x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 8.8 M
NetworkManager-tui x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 258 k

Transaction Summary
==============================================================================================================
Remove 2 Packages

Installed size: 9.1 M
Is this ok [y/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Erasing : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2
Verifying : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Verifying : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2

Removed:
NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7
NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7

Complete!
</pre>

== Disable SELinux ==

This mostly gets in the way, and we will disable it. There are steps that can be taken to leave this intact and functioning and still allow the system to function propperly, but I'll not discuss that here.

<pre>
[root@cn38-inverness-co ~]# setenforce 0
[root@cn38-inverness-co ~]# sed -i.bak "s/^SELINUX=.*/SELINUX=disabled/g" /etc/selinux/config
</pre>

== Update System Packages ==

Update the system packages. Some of the later steps will require give errors depending on system package levels that are available, and it is just good measure to make sure the latest packages are installed.

<pre>
[root@cn38-inverness-co ~]# yum -y update

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager-libnm.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be updated

=== SNIP ===

---> Package libstdc++.i686 0:4.8.5-44.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:

=== SNIP ===

Updating:

=== SNIP ===

Installing for dependencies:

=== SNIP ===

Transaction Summary
==============================================================================================================
Install 8 Packages (+47 Dependent packages)
Upgrade 240 Packages

Total size: 325 M
Total download size: 275 M
Downloading packages:
Delta RPMs disabled because /usr/bin/applydeltarpm not installed.
(1/230): acl-2.2.51-15.el7.x86_64.rpm | 81 kB 00:00:00

=== SNIP ===

(230/230): tzdata-2020d-2.el7.noarch.rpm | 499 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 17 MB/s | 275 MB 00:00:16
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Updating : libgcc-4.8.5-44.el7.x86_64 1/539
Installing : 1:grub2-common-2.02-0.86.el7.centos.noarch 2/539
Updating : centos-release-7-9.2009.1.el7.centos.x86_64 3/539

=== SNIP ===

Installing : rdma-core-22.4-5.el7.i686 295/539
Cleanup : tuned-2.4.1-1.el7.noarch 296/539

=== SNIP ===

Cleanup : 12:dhclient-4.2.5-36.el7.centos.x86_64 385/539

UPGRADE: Automatically re-enabling default systemd units:
brandbot.path
rhel-autorelabel.service
rhel-autorelabel-mark.service
rhel-configure.service
rhel-dmesg.service
rhel-domainname.service
rhel-import-state.service
rhel-loadmodules.service
rhel-readonly.service

Cleanup : initscripts-9.49.24-1.el7.x86_64 386/539

=== SNIP ===

Cleanup : libgcc-4.8.3-9.el7.x86_64 539/539
Verifying : glibc-common-2.17-317.el7.x86_64 1/539

=== SNIP ===

Verifying : 7:device-mapper-1.02.93-3.el7.x86_64 539/539

Installed:
grub2.x86_64 1:2.02-0.86.el7.centos grub2-tools.x86_64 1:2.02-0.86.el7.centos
grub2-tools-extra.x86_64 1:2.02-0.86.el7.centos grub2-tools-minimal.x86_64 1:2.02-0.86.el7.centos
kernel.x86_64 0:3.10.0-1160.6.1.el7 python-gobject-base.x86_64 0:3.22.0-1.el7_4.1
rdma-core.i686 0:22.4-5.el7 rdma-core.x86_64 0:22.4-5.el7

Dependency Installed:
GeoIP.x86_64 0:1.5.0-14.el7 audit-libs.i686 0:2.8.5-4.el7

=== SNIP ===

zlib.i686 0:1.2.7-18.el7

Updated:
NetworkManager-libnm.x86_64 1:1.18.8-2.el7_9

=== SNIP ===

zlib.x86_64 0:1.2.7-18.el7

Replaced:
grub2.x86_64 1:2.02-0.16.el7.centos grub2-tools.x86_64 1:2.02-0.16.el7.centos
pygobject3-base.x86_64 0:3.8.2-6.el7 rdma.noarch 0:7.1_3.17-5.el7

Complete!
</pre>

== Install Additional Packages ==

These are useful utilities that have been stripped from the base install in CentOS7. Adding these back in allows for easier troubleshooting of the server.

<pre>
[root@cn38-inverness-co ~]# yum -y install finger nc net-snmp net-snmp-perl net-snmp-utils ntp perl-Date-Manip \
perl-DBD-SQLite sssd tcp_wrappers tcpdump telnet tftp tog-pegasus traceroute \
vim-enhanced wget oddjob-mkhomedir net-tools yum-cron bind-utils

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 will be installed
--> Processing Dependency: bind-libs(x86-64) = 32:9.11.4-26.P2.el7_9.2 for package: 32:bind-utils-9.11.4-26.P2.el7_9.2.x86_64

=== SNIP ===

---> Package pcre-devel.x86_64 0:8.32-17.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bind-utils x86_64 32:9.11.4-26.P2.el7_9.2 updates 260 k

=== SNIP ===

yum-cron noarch 3.4.3-168.el7.centos base 66 k
Installing for dependencies:
autogen-libopts x86_64 5.18-5.el7 base 66 k

=== SNIP ===

zlib-devel x86_64 1.2.7-18.el7 base 50 k

Transaction Summary
==============================================================================================================
Install 21 Packages (+114 Dependent packages)

Total size: 59 M
Installed size: 166 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtalloc-2.1.16-1.el7.x86_64 1/135

=== SNIP ===

Installing : finger-0.17-52.el7.x86_64 135/135
Verifying : perl-HTTP-Tiny-0.033-3.el7.noarch 1/135

=== SNIP ===

Verifying : 2:nmap-ncat-6.40-19.el7.x86_64 135/135

Installed:
bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 finger.x86_64 0:0.17-52.el7
net-snmp.x86_64 1:5.7.2-49.el7 net-snmp-perl.x86_64 1:5.7.2-49.el7
net-snmp-utils.x86_64 1:5.7.2-49.el7 net-tools.x86_64 0:2.0-0.25.20131004git.el7
nmap-ncat.x86_64 2:6.40-19.el7 ntp.x86_64 0:4.2.6p5-29.el7.centos.2
oddjob-mkhomedir.x86_64 0:0.31.5-4.el7 perl-DBD-SQLite.x86_64 0:1.39-3.el7
perl-Date-Manip.noarch 0:6.41-2.el7 sssd.x86_64 0:1.16.5-10.el7_9.5
tcp_wrappers.x86_64 0:7.6-77.el7 tcpdump.x86_64 14:4.9.2-4.el7_7.1
telnet.x86_64 1:0.17-66.el7 tftp.x86_64 0:5.2-22.el7
tog-pegasus.x86_64 2:2.14.1-8.el7 traceroute.x86_64 3:2.0.22-2.el7
vim-enhanced.x86_64 2:7.4.629-7.el7 wget.x86_64 0:1.14-18.el7_6.1
yum-cron.noarch 0:3.4.3-168.el7.centos

Dependency Installed:
autogen-libopts.x86_64 0:5.18-5.el7

=== SNIP ===

zlib-devel.x86_64 0:1.2.7-18.el7

Complete!
</pre>

== Fix Timezone ==

This is just a preference, but it will standardize the timezone.

<pre>
[root@cn38-inverness-co ~]# rm -f /etc/localtime
[root@cn38-inverness-co ~]# ln -s /usr/share/zoneinfo/MST7MDT /etc/localtime
</pre>

== Disable RPF ==

Reverse Path Forwarding (RPF) is a security protection that will prevent inbound packets from entering an IP interface that does not have outbound routes to the source IP. It is not important to disable this if your server only has one interface, however if you have multiple network interfaces, and you may be receiving asymmetric traffic, this needs to be disabled to allow the packets to enter the system.

<pre>
[root@cn38-inverness-co ~]# echo "net.ipv4.conf.default.rp_filter = 0" > /etc/sysctl.d/rpfilter.conf
</pre>

== Install vmtools (if virtual) ==

'''Only do this step if you are installing on a virtual platform. This is not required if you are installing on bare metal.'''

<pre>
[root@cn38-inverness-co ~]# yum -y install open-vm-tools

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package open-vm-tools.x86_64 0:11.0.5-3.el7_9.1 will be installed
--> Processing Dependency: xmlsec1-openssl for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.6)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.5)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: fuse for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxslt.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxmlsec1.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libmspack.so.0()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libltdl.so.7()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Running transaction check
---> Package fuse.x86_64 0:2.9.2-11.el7 will be installed
---> Package fuse-libs.x86_64 0:2.9.2-11.el7 will be installed
---> Package libmspack.x86_64 0:0.5-0.8.alpha.el7 will be installed
---> Package libtool-ltdl.x86_64 0:2.4.2-22.el7_3 will be installed
---> Package libxslt.x86_64 0:1.1.28-6.el7 will be installed
---> Package xmlsec1.x86_64 0:1.2.20-7.el7_4 will be installed
---> Package xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
open-vm-tools x86_64 11.0.5-3.el7_9.1 updates 676 k
Installing for dependencies:
fuse x86_64 2.9.2-11.el7 base 86 k
fuse-libs x86_64 2.9.2-11.el7 base 93 k
libmspack x86_64 0.5-0.8.alpha.el7 base 64 k
libtool-ltdl x86_64 2.4.2-22.el7_3 base 49 k
libxslt x86_64 1.1.28-6.el7 base 242 k
xmlsec1 x86_64 1.2.20-7.el7_4 base 177 k
xmlsec1-openssl x86_64 1.2.20-7.el7_4 base 76 k

Transaction Summary
==============================================================================================================
Install 1 Package (+7 Dependent packages)

Total download size: 1.4 M
Installed size: 4.0 M
Downloading packages:
(1/8): fuse-2.9.2-11.el7.x86_64.rpm | 86 kB 00:00:00
(2/8): fuse-libs-2.9.2-11.el7.x86_64.rpm | 93 kB 00:00:00
(3/8): libtool-ltdl-2.4.2-22.el7_3.x86_64.rpm | 49 kB 00:00:00
(4/8): libmspack-0.5-0.8.alpha.el7.x86_64.rpm | 64 kB 00:00:00
(5/8): xmlsec1-1.2.20-7.el7_4.x86_64.rpm | 177 kB 00:00:00
(6/8): libxslt-1.1.28-6.el7.x86_64.rpm | 242 kB 00:00:00
(7/8): xmlsec1-openssl-1.2.20-7.el7_4.x86_64.rpm | 76 kB 00:00:00
(8/8): open-vm-tools-11.0.5-3.el7_9.1.x86_64.rpm | 676 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.4 MB/s | 1.4 MB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtool-ltdl-2.4.2-22.el7_3.x86_64 1/8
Installing : libxslt-1.1.28-6.el7.x86_64 2/8
Installing : xmlsec1-1.2.20-7.el7_4.x86_64 3/8
Installing : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Installing : fuse-2.9.2-11.el7.x86_64 5/8
Installing : fuse-libs-2.9.2-11.el7.x86_64 6/8
Installing : libmspack-0.5-0.8.alpha.el7.x86_64 7/8
Installing : open-vm-tools-11.0.5-3.el7_9.1.x86_64 8/8
Verifying : libmspack-0.5-0.8.alpha.el7.x86_64 1/8
Verifying : fuse-libs-2.9.2-11.el7.x86_64 2/8
Verifying : fuse-2.9.2-11.el7.x86_64 3/8
Verifying : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Verifying : libxslt-1.1.28-6.el7.x86_64 5/8
Verifying : xmlsec1-1.2.20-7.el7_4.x86_64 6/8
Verifying : open-vm-tools-11.0.5-3.el7_9.1.x86_64 7/8
Verifying : libtool-ltdl-2.4.2-22.el7_3.x86_64 8/8

Installed:
open-vm-tools.x86_64 0:11.0.5-3.el7_9.1

Dependency Installed:
fuse.x86_64 0:2.9.2-11.el7 fuse-libs.x86_64 0:2.9.2-11.el7
libmspack.x86_64 0:0.5-0.8.alpha.el7 libtool-ltdl.x86_64 0:2.4.2-22.el7_3
libxslt.x86_64 0:1.1.28-6.el7 xmlsec1.x86_64 0:1.2.20-7.el7_4
xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4

Complete!
</pre>

== Reboot Server ==

<pre>
[root@cn38-inverness-co ~]# shutdown -r now
Connection to cn38-inverness-co.suburbanbroadband.net closed by remote host.
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

== Remove old kernel ==

<pre>
[root@cn38-inverness-co ~]# rpm -qa | grep kernel

kernel-tools-libs-3.10.0-1160.6.1.el7.x86_64
kernel-headers-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-229.el7.x86_64
kernel-tools-3.10.0-1160.6.1.el7.x86_64

[root@cn38-inverness-co ~]# yum -y erase kernel-3.10.0-229.el7.x86_64

Loaded plugins: fastestmirror
Resolving Dependencies
--> Running transaction check
---> Package kernel.x86_64 0:3.10.0-229.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
kernel x86_64 3.10.0-229.el7 @anaconda 131 M

Transaction Summary
==============================================================================================================
Remove 1 Package

Installed size: 131 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : kernel-3.10.0-229.el7.x86_64 1/1
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.softdep: remove failed: No such file or directory
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.devname: remove failed: No such file or directory
Verifying : kernel-3.10.0-229.el7.x86_64 1/1

Removed:
kernel.x86_64 0:3.10.0-229.el7

Complete!
</pre>

= Download and Compile Asterisk 18.1.0 =

== Install Development Packages ==

We will be compiling Asterisk from source, so we will need to install some development tools. There may be some duplicates int he list that have already been installed earlier.

<pre>
[root@cn38-inverness-co ~]# yum -y install gcc ncurses-devel openssl-devel gcc-c++ gnutls-devel \
make wget openssh openssh-clients openssh-server ntp sendmail rsync ftp mysql mysql-server \
mysql-devel curl curl-devel traceroute telnet which rpm-build flex gcc newt-devel libusb-devel \
net-snmp-utils bison byacc libxml2-devel vixie-cron mailx xinetd tcpdump

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Package gcc-4.8.5-44.el7.x86_64 already installed and latest version

=== SNIP ===

Package 1:net-snmp-utils-5.7.2-49.el7.x86_64 already installed and latest version
No package vixie-cron available.
Package 14:tcpdump-4.9.2-4.el7_7.1.x86_64 already installed and latest version
Resolving Dependencies
--> Running transaction check
---> Package bison.x86_64 0:3.0.4-2.el7 will be installed

=== SNIP ===

---> Package libevent.x86_64 0:2.0.21-4.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bison x86_64 3.0.4-2.el7 base 674 k

=== SNIP ===

xinetd x86_64 2:2.3.15-14.el7 base 128 k
Installing for dependencies:
bzip2 x86_64 1.0.6-13.el7 base 52 k

=== SNIP ===

zip x86_64 3.0-11.el7 base 260 k

Transaction Summary
==============================================================================================================
Install 18 Packages (+27 Dependent packages)

Total download size: 30 M
Installed size: 110 M
Downloading packages:
(1/45): byacc-1.9.20130304-3.el7.x86_64.rpm | 65 kB 00:00:00

=== SNIP ===

(45/45): zip-3.0-11.el7.x86_64.rpm | 260 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 13 MB/s | 30 MB 00:00:02
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : m4-1.4.16-10.el7.x86_64 1/45

=== SNIP ===

Installing : 2:xinetd-2.3.15-14.el7.x86_64 45/45
Verifying : gcc-c++-4.8.5-44.el7.x86_64 1/45

=== SNIP ===

Verifying : gnutls-devel-3.3.29-9.el7_6.x86_64 45/45

Installed:
bison.x86_64 0:3.0.4-2.el7 byacc.x86_64 0:1.9.20130304-3.el7
flex.x86_64 0:2.5.37-6.el7 ftp.x86_64 0:0.17-67.el7
gcc-c++.x86_64 0:4.8.5-44.el7 gnutls-devel.x86_64 0:3.3.29-9.el7_6
libcurl-devel.x86_64 0:7.29.0-59.el7_9.1 libusb-devel.x86_64 1:0.1.4-3.el7
libxml2-devel.x86_64 0:2.9.1-6.el7.5 mailx.x86_64 0:12.5-19.el7
mariadb.x86_64 1:5.5.68-1.el7 mariadb-devel.x86_64 1:5.5.68-1.el7
ncurses-devel.x86_64 0:5.9-14.20130511.el7_4 newt-devel.x86_64 0:0.52.15-4.el7
rpm-build.x86_64 0:4.11.3-45.el7 rsync.x86_64 0:3.1.2-10.el7
sendmail.x86_64 0:8.14.7-6.el7 xinetd.x86_64 2:2.3.15-14.el7

Dependency Installed:
bzip2.x86_64 0:1.0.6-13.el7 cyrus-sasl.x86_64 0:2.1.26-23.el7
dwz.x86_64 0:0.11-3.el7 elfutils.x86_64 0:0.176-5.el7
gdb.x86_64 0:7.6.1-120.el7 gmp-devel.x86_64 1:6.0.0-15.el7
gnutls-c++.x86_64 0:3.3.29-9.el7_6 gnutls-dane.x86_64 0:3.3.29-9.el7_6
hesiod.x86_64 0:3.2.1-3.el7 libevent.x86_64 0:2.0.21-4.el7
libstdc++-devel.x86_64 0:4.8.5-44.el7 libtasn1-devel.x86_64 0:4.10-1.el7
libusb.x86_64 1:0.1.4-3.el7 libusbx.x86_64 0:1.0.21-1.el7
m4.x86_64 0:1.4.16-10.el7 nettle-devel.x86_64 0:2.7.1-8.el7
p11-kit-devel.x86_64 0:0.23.5-3.el7 patch.x86_64 0:2.7.1-12.el7_7
perl-Thread-Queue.noarch 0:3.02-2.el7 perl-srpm-macros.noarch 0:1-8.el7
procmail.x86_64 0:3.22-36.el7_4.1 python-srpm-macros.noarch 0:3-34.el7
redhat-rpm-config.noarch 0:9.1.0-88.el7.centos slang-devel.x86_64 0:2.2.4-11.el7
unbound-libs.x86_64 0:1.6.6-5.el7_8 unzip.x86_64 0:6.0-21.el7
zip.x86_64 0:3.0-11.el7

Complete!
== Generate RSA Key ==

<pre>
[root@cn38-inverness-co ~]# ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Created directory '/root/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:FKpB44T5QoKCZtkOoU4ZF6w7T0G98QZ60gHU9QpQM9k root@cn38-inverness-co.suburbanbroadband.net
The key's randomart image is:
+---[RSA 2048]----+
|oo*OX++.. |
|*=BB.OoE.. |
|===.=.B .. |
|o..=.*.+. |
| ...= ..S |
| o . |
| + |
| . |
| |
+----[SHA256]-----+

</pre>

== Download Asterisk 18.1.0 ==

Change directory to /usr/local/src and download the Asterisk source code.

<pre>
[root@cn38-inverness-co ~]# cd /usr/local/src/

[root@cn38-inverness-co src]# wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz

--2020-12-02 17:39:25-- https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 27886299 (27M) [application/x-gzip]
Saving to: ‘asterisk-18-current.tar.gz’

100%[====================================================================>] 27,886,299 8.03MB/s in 3.3s

2020-12-02 17:39:29 (8.03 MB/s) - ‘asterisk-18-current.tar.gz’ saved [27886299/27886299]
</pre>

For future reference, you can also find it directly here:

[https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz]

== Uncompress Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co src]# tar -zxf asterisk-18-current.tar.gz

[root@cn38-inverness-co src]# ls
asterisk-18.1.0

[root@cn38-inverness-co src]# cd asterisk-18.1.0/

[root@cn38-inverness-co asterisk-18.1.0]# ls
addons channels include README-SERIOUSLY.bestpractices.md
agi codecs install-sh res
apps config.guess LICENSE rest-api
asterisk-18.1.0-summary.html configs main rest-api-templates
asterisk-18.1.0-summary.txt config.sub Makefile sample.call
autoconf configure Makefile.moddir_rules sounds
bootstrap.sh configure.ac Makefile.rules static-http
bridges contrib makeopts.in tests
BSDmakefile COPYING menuselect third-party
BUGS CREDITS missing UPGRADE.txt
build_tools default.exports mkinstalldirs utils
cdr doc pbx Zaptel-to-DAHDI.txt
cel formats phoneprov
ChangeLog funcs README-addons.txt
CHANGES images README.md

</pre>

== Test the prereqs ==

Run the '''"./contrib/scripts/install_prereq test"''' command in order to test the installed prerequesits. After it returns the things that need to be installed, you can just copy and paste that command. If there are packages that are not installed afterthe command due to not existing in the CentOS 7 main repo, they are probably not required.

<pre>

[root@cn38-inverness-co asterisk-18.1.0]# ./contrib/scripts/install_prereq test

#############################################
## test: test mode.
## Use the commands here to install your system.
#############################################
yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

[root@cn38-inverness-co asterisk-18.1.0]# yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
No package speexdsp-devel available.
No package portaudio-devel available.
No package xmlstarlet available.
No package gmime-devel available.
Package 1:mariadb-devel-5.5.68-1.el7.x86_64 already installed and latest version
No package radcli-devel available.
No package freetds-devel available.
No package jack-audio-connection-kit-devel available.
No package iksemel-devel available.
No package spandsp-devel available.
No package libresample-devel available.
No package uw-imap-devel available.
No package hoard available.
No package codec2-devel available.
Resolving Dependencies
--> Running transaction check
---> Package alsa-lib-devel.x86_64 0:1.1.8-1.el7 will be installed

=== SNIP ===

---> Package mesa-libglapi.x86_64 0:18.3.4-12.el7_9 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
alsa-lib-devel x86_64 1.1.8-1.el7 base 963 k

=== SNIP ===

uriparser-devel x86_64 0.7.5-10.el7 base 138 k
Installing for dependencies:
adobe-mappings-cmap noarch 20171205-3.el7 base 2.1 M

=== SNIP ===

xorg-x11-server-utils x86_64 7.7-20.el7 base 178 k

Transaction Summary
==============================================================================================================
Install 28 Packages (+117 Dependent packages)

Total download size: 56 M
Installed size: 216 M
Downloading packages:
(1/145): adobe-mappings-cmap-deprecated-20171205-3.el7.noarch.rpm | 114 kB 00:00:00

=== SNIP ===

(145/145): xorg-x11-server-utils-7.7-20.el7.x86_64.rpm | 178 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 9.3 MB/s | 56 MB 00:00:06
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libjpeg-turbo-1.2.90-8.el7.x86_64 1/145

=== SNIP ===

Installing : libedit-devel-3.0-12.20121213cvs.el7.x86_64 145/145
Verifying : libXext-1.3.3-3.el7.x86_64 1/145

=== SNIP ===

Verifying : libcgroup-0.41-21.el7.x86_64 145/145

Installed:
alsa-lib-devel.x86_64 0:1.1.8-1.el7 binutils-devel.x86_64 0:2.27-44.base.el7

=== SNIP ===

Dependency Installed:
adobe-mappings-cmap.noarch 0:20171205-3.el7

=== SNIP ===

Complete!
</pre>

== Run ./configure for Asterisk ==

For CentOS 7.X, you will get an error about needing a newer version of jansson library. It may be possible to manually install the newer version, however it is probaly fine to just use the '''--with-jansson-bundled''' flag to include the version bundled with Asterisk source code.

In addition, we will want to load the bundled pjsip channel drivers, with the '''--with-pjproject-pundled'''.

Hopefully this completed without any issues, however you should look over the output to ensure it is what you are expecting.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ./configure --with-jansson-bundled --with-pjproject-bundled

checking build system type... x86_64-pc-linux-gnu

=== SNIP ===

checking for pkg-config... /bin/pkg-config
checking pkg-config is at least version 0.9.0... yes
checking for GTK2... no
configure: creating ./config.status
config.status: creating makeopts
config.status: creating autoconfig.h
configure: Menuselect build configuration successfully completed

.$$$$$$$$$$$$$$$=..
.$7$7.. .7$$7:.
.$$:. ,$7.7
.$7. 7$$$$ .$$77
..$$. $$$$$ .$$$7
..7$ .?. $$$$$ .?. 7$$$.
$.$. .$$$7. $$$$7 .7$$$. .$$$.
.777. .$$$$$$77$$$77$$$$$7. $$$,
$$$~ .7$$$$$$$$$$$$$7. .$$$.
.$$7 .7$$$$$$$7: ?$$$.
$$$ ?7$$$$$$$$$$I .$$$7
$$$ .7$$$$$$$$$$$$$$$$ :$$$.
$$$ $$$$$$7$$$$$$$$$$$$ .$$$.
$$$ $$$ 7$$$7 .$$$ .$$$.
$$$$ $$$$7 .$$$.
7$$$7 7$$$$ 7$$$
$$$$$ $$$
$$$$7. $$ (TM)
$$$$$$$. .7$$$$$$ $$
$$$$$$$$$$$$7$$$$$$$$$.$$$$$$
$$$$$$$$$$$$$$$$.

configure: Package configured for:
configure: OS type : linux-gnu
configure: Host CPU : x86_64
configure: build-cpu:vendor:os: x86_64 : pc : linux-gnu :
configure: host-cpu:vendor:os: x86_64 : pc : linux-gnu :

</pre>

== make menuselect ==

By default, a lot of options are not included in the Asterisk build, and need to be configured. This is done by running the '''"make menu"''' command in the asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make menuselect

CC="cc" CXX="g++" LD="" AR="" RANLIB="" CFLAGS="" LDFLAGS="" make -C menuselect CONFIGURE_SILENT="--silent" gmenuselect
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Nothing to be done for `gmenuselect'.
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0'
menuselect changes saved!
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0'

</pre>

In '''Add-ons''', select '''chan_ooh323''', '''format_mp3''', '''res_config_mysql''', '''app_mysql''' and '''crd_mysql'''.

[[File:Asterisk1810-Add-ons.png|none|frame|Add-ons]]

In '''Core Sound Packages''', select '''EN-WAV''', '''EN-ULAW''', '''EN-ALAW''', '''EN-GSM''', '''EN-G729''', '''EN-G722''', '''EN-SLN16''', '''EN-SIREN7''', and '''EN-SIREN14'''.

[[File:Asterisk1810-coresound.png|none|frame|Core Sound Packages]]

In '''Music On Hold File Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-musiconhold.png|none|frame|Music On Hold File Packages]]

In '''Extras Sound Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-extrasound.png|none|frame|Extras Sound Packages]]

In '''Applications''', select '''app_voicemail''', '''app_voicemail_imap''', '''app_voicemail_odbc''', '''app_macro'''.

[[File:Asterisk1810-applications1.png|none|frame|Applications Voicemail]]
[[File:Asterisk1810-applications2.png|none|frame|Applications Macro]]

== Download MP3 sources ==

Download the required MP3 sources by running the '''contrib/scripts/get_mp3_source.sh''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# contrib/scripts/get_mp3_source.sh

A addons/mp3
A addons/mp3/MPGLIB_TODO
A addons/mp3/mpg123.h
A addons/mp3/layer3.c
A addons/mp3/mpglib.h
A addons/mp3/decode_ntom.c
A addons/mp3/interface.c
A addons/mp3/MPGLIB_README
A addons/mp3/common.c
A addons/mp3/huffman.h
A addons/mp3/tabinit.c
A addons/mp3/Makefile
A addons/mp3/README
A addons/mp3/decode_i386.c
A addons/mp3/dct64_i386.c
Exported revision 202.
</pre>

== Compile Asterisk 18.1.0 ==

We compile the Asterisk code by running the '''make''' command inside the build directory. This should compile at this point, but if there are any errors, additional changes to the system may be required. ''The output below is shortened for space.''

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make

[CC] astcanary.c -> astcanary.o
[LD] astcanary.o -> astcanary
[CC] astdb2sqlite3.c -> astdb2sqlite3.o
[CC] hash/hash.c -> hash/hash.o
[CC] hash/hash_bigkey.c -> hash/hash_bigkey.o
[CC] hash/hash_buf.c -> hash/hash_buf.o
[CC] hash/hash_func.c -> hash/hash_func.o
[CC] hash/hash_log2.c -> hash/hash_log2.o
[CC] hash/hash_page.c -> hash/hash_page.o

=== SNIP ===

[LD] chan_ooh323.o ooh323c/src/ooCmdChannel.o ooh323c/src/ooLogChan.o ooh323c/src/ooUtils.o ooh323c/src/ooGkClient.o ooh323c/src/context.o ooh323c/src/ooDateTime.o ooh323c/src/decode.o ooh323c/src/dlist.o ooh323c/src/encode.o ooh323c/src/errmgmt.o ooh323c/src/memheap.o ooh323c/src/ootrace.o ooh323c/src/oochannels.o ooh323c/src/ooh245.o ooh323c/src/ooports.o ooh323c/src/ooq931.o ooh323c/src/ooCapability.o ooh323c/src/ooSocket.o ooh323c/src/perutil.o ooh323c/src/eventHandler.o ooh323c/src/ooCalls.o ooh323c/src/ooStackCmds.o ooh323c/src/ooh323.o ooh323c/src/ooh323ep.o ooh323c/src/printHandler.o ooh323c/src/rtctype.o ooh323c/src/ooTimer.o ooh323c/src/h323/H235-SECURITY-MESSAGESDec.o ooh323c/src/h323/H235-SECURITY-MESSAGESEnc.o ooh323c/src/h323/H323-MESSAGES.o ooh323c/src/h323/H323-MESSAGESDec.o ooh323c/src/h323/H323-MESSAGESEnc.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROL.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLDec.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLEnc.o ooh323cDriver.o -> chan_ooh323.so
[CC] format_mp3.c -> format_mp3.o
[CC] mp3/common.c -> mp3/common.o
[CC] mp3/dct64_i386.c -> mp3/dct64_i386.o
[CC] mp3/decode_ntom.c -> mp3/decode_ntom.o
[CC] mp3/layer3.c -> mp3/layer3.o
[CC] mp3/tabinit.c -> mp3/tabinit.o
[CC] mp3/interface.c -> mp3/interface.o
[LD] format_mp3.o mp3/common.o mp3/dct64_i386.o mp3/decode_ntom.o mp3/layer3.o mp3/tabinit.o mp3/interface.o -> format_mp3.so
[CC] res_config_mysql.c -> res_config_mysql.o
[LD] res_config_mysql.o -> res_config_mysql.so
Building Documentation For: third-party channels pbx apps codecs formats cdr cel bridges funcs tests main res addons
+--------- Asterisk Build Complete ---------+
+ Asterisk has successfully been built, and +
+ can be installed by running: +
+ +
+ make install +
+-------------------------------------------+
</pre>

== Install for Asterisk 18.1.0 ==

We install Asterisk by running the '''make install''' command in the Asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make install
Installing modules from channels...
Installing modules from pbx...
Installing modules from apps...
Installing modules from codecs...
Installing modules from formats...
Installing modules from cdr...
Installing modules from cel...
Installing modules from bridges...
Installing modules from funcs...
Installing modules from tests...
Installing modules from main...
Installing modules from res...
Installing modules from addons...
/bin/install -c -m 755 contrib/scripts/astversion "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/astgenkey "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/autosupport "/usr/sbin/"
if [ ! -f /sbin/launchd ]; then \
./build_tools/install_subst contrib/scripts/safe_asterisk "/usr/sbin/safe_asterisk"; \
fi
/bin/install -c -m 644 doc/core-*.xml "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.dtd "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/asterisk.8 "/usr/share/man/man8"
/bin/install -c -m 644 doc/astdb*.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/astgenkey.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/autosupport.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/safe_asterisk.8 "/usr/share/man/man8"
if [ -f contrib/firmware/iax/iaxy.bin ] ; then \
/bin/install -c -m 644 contrib/firmware/iax/iaxy.bin "/var/lib/asterisk/firmware/iax/iaxy.bin"; \
fi
CFLAGS=" -I/usr/include/libxml2 -pipe -Wall -Wstrict-prototypes -Wmissing-prototypes -Wmissing-declarations -g3 " build_tools/mkpkgconfig "/usr/lib/pkgconfig";
find static-http | while read x; do \
if test -d $x; then \
/bin/install -c -m 755 -d "/var/lib/asterisk/$x"; \
else \
/bin/install -c -m 644 $x "/var/lib/asterisk/$x" ; \
fi \
done
/bin/install -c -m 644 doc/core-en_US.xml "/var/lib/asterisk/static-http";
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/static-http";
if [ -d doc/tex/asterisk ] ; then \
/bin/install -c -d "/var/lib/asterisk/static-http/docs" ; \
for n in doc/tex/asterisk/* ; do \
/bin/install -c -m 644 $n "/var/lib/asterisk/static-http/docs" ; \
done \
fi
for x in images/*.jpg; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/images" ; \
done
make -C sounds install
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/sounds'
--2020-12-02 18:52:05-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-wav-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 20176188 (19M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’

100%[====================================================================>] 20,176,188 7.79MB/s in 2.5s

2020-12-02 18:52:08 (7.79 MB/s) - ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’ saved [20176188/20176188]

--2020-12-02 18:52:09-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-ulaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10241447 (9.8M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’

100%[====================================================================>] 10,241,447 1.71MB/s in 6.4s

2020-12-02 18:52:15 (1.52 MB/s) - ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’ saved [10241447/10241447]

--2020-12-02 18:52:16-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-alaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9937284 (9.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’

100%[====================================================================>] 9,937,284 3.40MB/s in 2.8s

2020-12-02 18:52:18 (3.40 MB/s) - ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’ saved [9937284/9937284]

--2020-12-02 18:52:19-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g729-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1557751 (1.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’

100%[====================================================================>] 1,557,751 2.78MB/s in 0.5s

2020-12-02 18:52:20 (2.78 MB/s) - ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’ saved [1557751/1557751]

--2020-12-02 18:52:20-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g722-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10756090 (10M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’

100%[====================================================================>] 10,756,090 6.58MB/s in 1.6s

2020-12-02 18:52:21 (6.58 MB/s) - ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’ saved [10756090/10756090]

--2020-12-02 18:52:22-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-sln16-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 41366110 (39M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’

100%[====================================================================>] 41,366,110 11.1MB/s in 3.9s

2020-12-02 18:52:26 (10.1 MB/s) - ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’ saved [41366110/41366110]

--2020-12-02 18:52:27-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren7-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 6028362 (5.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’

100%[====================================================================>] 6,028,362 7.39MB/s in 0.8s

2020-12-02 18:52:27 (7.39 MB/s) - ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’ saved [6028362/6028362]

--2020-12-02 18:52:28-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren14-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9120763 (8.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’

100%[====================================================================>] 9,120,763 8.37MB/s in 1.0s

2020-12-02 18:52:29 (8.37 MB/s) - ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’ saved [9120763/9120763]

--2020-12-02 18:52:29-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-wav-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 35362826 (34M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’

100%[====================================================================>] 35,362,826 8.66MB/s in 4.1s

2020-12-02 18:52:33 (8.29 MB/s) - ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’ saved [35362826/35362826]

--2020-12-02 18:52:34-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 18007258 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’

100%[====================================================================>] 18,007,258 9.70MB/s in 1.8s

2020-12-02 18:52:36 (9.70 MB/s) - ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’ saved [18007258/18007258]

--2020-12-02 18:52:37-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-alaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 17464549 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’

100%[====================================================================>] 17,464,549 9.37MB/s in 1.8s

2020-12-02 18:52:39 (9.37 MB/s) - ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’ saved [17464549/17464549]

--2020-12-02 18:52:39-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-gsm-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 4253587 (4.1M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’

100%[====================================================================>] 4,253,587 6.67MB/s in 0.6s

2020-12-02 18:52:40 (6.67 MB/s) - ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’ saved [4253587/4253587]

--2020-12-02 18:52:41-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-ulaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7479839 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’

100%[====================================================================>] 7,479,839 7.98MB/s in 0.9s

2020-12-02 18:52:42 (7.98 MB/s) - ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’ saved [7479839/7479839]

--2020-12-02 18:52:42-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-alaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7496413 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-alaw-2.03.tar.gz’

100%[====================================================================>] 7,496,413 8.03MB/s in 0.9s

2020-12-02 18:52:43 (8.03 MB/s) - ‘asterisk-moh-opsound-alaw-2.03.tar.gz’ saved [7496413/7496413]

--2020-12-02 18:52:43-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-gsm-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1777967 (1.7M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-gsm-2.03.tar.gz’

100%[====================================================================>] 1,777,967 4.09MB/s in 0.4s

2020-12-02 18:52:44 (4.09 MB/s) - ‘asterisk-moh-opsound-gsm-2.03.tar.gz’ saved [1777967/1777967]

make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/sounds'
find rest-api -name "*.json" | while read x; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/rest-api" ; \
done
+---- Asterisk Installation Complete -------+
+ +
+ YOU MUST READ THE SECURITY DOCUMENT +
+ +
+ Asterisk has successfully been installed. +
+ If you would like to install the sample +
+ configuration files (overwriting any +
+ existing config files), run: +
+ +
+ For generic reference documentation: +
+ make samples +
+ +
+ For a sample basic PBX: +
+ make basic-pbx +
+ +
+ +
+----------------- or ---------------------+
+ +
+ You can go ahead and install the asterisk +
+ program documentation now or later run: +
+ +
+ make progdocs +
+ +
+ **Note** This requires that you have +
+ doxygen installed on your local system +
+-------------------------------------------+
</pre>

== Install Program Docs ==

Install the program documentation by running the '''make progdocs''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make progdocs

# Enable DOT
# Set Doxygen PROJECT_NUMBER variable
# Validate and auto-update local copy
Warning: Tag `SYMBOL_CACHE_SIZE' at line 291 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `SHOW_DIRECTORIES' at line 491 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `HTML_ALIGN_MEMBERS' at line 859 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `USE_INLINE_TREES' at line 1044 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"

Configuration file `doc/asterisk-ng-doxygen' updated.

# Run Doxygen
Warning: doxygen no longer ships with the FreeSans font.
You may want to clear or change DOT_FONTNAME.
Otherwise you run the risk that the wrong font is being used for dot generated graphs.
Searching for include files...
Searching for files in directory /usr/local/src/asterisk-18.1.0
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/mp3
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/ooh323c

=== SNIP ===

Patching output file 2546/2550
Patching output file 2547/2550
Patching output file 2548/2550
Patching output file 2549/2550
Patching output file 2550/2550
lookup cache used 65536/65536 hits=1461947 misses=70524
finished...
# Remove configuration backup file
</pre>

== Make the Asterisk 18.1.0 sample configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make samples
Installing adsi config files...
/bin/install -c -d "/etc/asterisk"
Installing configs/samples/asterisk.adsi
Installing configs/samples/telcordia-1.adsi
Installing other config files...
Installing file configs/samples/acl.conf.sample
Installing file configs/samples/adsi.conf.sample
Installing file configs/samples/agents.conf.sample
Installing file configs/samples/alarmreceiver.conf.sample
Installing file configs/samples/alsa.conf.sample
Installing file configs/samples/amd.conf.sample
Installing file configs/samples/app_mysql.conf.sample
Installing file configs/samples/app_skel.conf.sample
Installing file configs/samples/ari.conf.sample
Installing file configs/samples/ast_debug_tools.conf.sample
Installing file configs/samples/asterisk.conf.sample
Installing file configs/samples/calendar.conf.sample
Installing file configs/samples/ccss.conf.sample
Installing file configs/samples/cdr_adaptive_odbc.conf.sample
Installing file configs/samples/cdr_beanstalkd.conf.sample
Installing file configs/samples/cdr.conf.sample
Installing file configs/samples/cdr_custom.conf.sample
Installing file configs/samples/cdr_manager.conf.sample
Installing file configs/samples/cdr_mysql.conf.sample
Installing file configs/samples/cdr_odbc.conf.sample
Installing file configs/samples/cdr_pgsql.conf.sample
Installing file configs/samples/cdr_sqlite3_custom.conf.sample
Installing file configs/samples/cdr_syslog.conf.sample
Installing file configs/samples/cdr_tds.conf.sample
Installing file configs/samples/cel_beanstalkd.conf.sample
Installing file configs/samples/cel.conf.sample
Installing file configs/samples/cel_custom.conf.sample
Installing file configs/samples/cel_odbc.conf.sample
Installing file configs/samples/cel_pgsql.conf.sample
Installing file configs/samples/cel_sqlite3_custom.conf.sample
Installing file configs/samples/cel_tds.conf.sample
Installing file configs/samples/chan_dahdi.conf.sample
Installing file configs/samples/chan_mobile.conf.sample
Installing file configs/samples/cli_aliases.conf.sample
Installing file configs/samples/cli.conf.sample
Installing file configs/samples/cli_permissions.conf.sample
Installing file configs/samples/codecs.conf.sample
Installing file configs/samples/confbridge.conf.sample
Installing file configs/samples/config_test.conf.sample
Installing file configs/samples/console.conf.sample
Installing file configs/samples/dbsep.conf.sample
Installing file configs/samples/dnsmgr.conf.sample
Installing file configs/samples/dsp.conf.sample
Installing file configs/samples/dundi.conf.sample
Installing file configs/samples/enum.conf.sample
Installing file configs/samples/extconfig.conf.sample
Installing file configs/samples/extensions.ael.sample
Installing file configs/samples/extensions.conf.sample
Installing file configs/samples/extensions.lua.sample
Installing file configs/samples/extensions_minivm.conf.sample
Installing file configs/samples/features.conf.sample
Installing file configs/samples/festival.conf.sample
Installing file configs/samples/followme.conf.sample
Installing file configs/samples/func_odbc.conf.sample
Installing file configs/samples/hep.conf.sample
Installing file configs/samples/http.conf.sample
Installing file configs/samples/iax.conf.sample
Installing file configs/samples/iaxprov.conf.sample
Installing file configs/samples/indications.conf.sample
Installing file configs/samples/logger.conf.sample
Installing file configs/samples/manager.conf.sample
Installing file configs/samples/meetme.conf.sample
Installing file configs/samples/mgcp.conf.sample
Installing file configs/samples/minivm.conf.sample
Installing file configs/samples/misdn.conf.sample
Installing file configs/samples/modules.conf.sample
Installing file configs/samples/motif.conf.sample
Installing file configs/samples/musiconhold.conf.sample
Installing file configs/samples/muted.conf.sample
Installing file configs/samples/ooh323.conf.sample
Installing file configs/samples/osp.conf.sample
Installing file configs/samples/oss.conf.sample
Installing file configs/samples/phone.conf.sample
Installing file configs/samples/phoneprov.conf.sample
Installing file configs/samples/pjproject.conf.sample
Installing file configs/samples/pjsip.conf.sample
Installing file configs/samples/pjsip_notify.conf.sample
Installing file configs/samples/pjsip_wizard.conf.sample
Installing file configs/samples/prometheus.conf.sample
Installing file configs/samples/queuerules.conf.sample
Installing file configs/samples/queues.conf.sample
Installing file configs/samples/res_config_mysql.conf.sample
Installing file configs/samples/res_config_sqlite3.conf.sample
Installing file configs/samples/res_config_sqlite.conf.sample
Installing file configs/samples/res_corosync.conf.sample
Installing file configs/samples/res_curl.conf.sample
Installing file configs/samples/res_fax.conf.sample
Installing file configs/samples/res_ldap.conf.sample
Installing file configs/samples/res_odbc.conf.sample
Installing file configs/samples/resolver_unbound.conf.sample
Installing file configs/samples/res_parking.conf.sample
Installing file configs/samples/res_pgsql.conf.sample
Installing file configs/samples/res_pktccops.conf.sample
Installing file configs/samples/res_snmp.conf.sample
Installing file configs/samples/res_stun_monitor.conf.sample
Installing file configs/samples/rtp.conf.sample
Installing file configs/samples/say.conf.sample
Installing file configs/samples/sip.conf.sample
Installing file configs/samples/sip_notify.conf.sample
Installing file configs/samples/skinny.conf.sample
Installing file configs/samples/sla.conf.sample
Installing file configs/samples/smdi.conf.sample
Installing file configs/samples/sorcery.conf.sample
Installing file configs/samples/ss7.timers.sample
Installing file configs/samples/stasis.conf.sample
Installing file configs/samples/statsd.conf.sample
Installing file configs/samples/stir_shaken.conf.sample
Installing file configs/samples/test_sorcery.conf.sample
Installing file configs/samples/udptl.conf.sample
Installing file configs/samples/unistim.conf.sample
Installing file configs/samples/users.conf.sample
Installing file configs/samples/voicemail.conf.sample
Installing file configs/samples/vpb.conf.sample
Installing file configs/samples/xmpp.conf.sample
Updating asterisk.conf
/bin/install -c -d "/var/spool/asterisk/voicemail/default/1234/INBOX"
build_tools/make_sample_voicemail "//var/lib/asterisk" "//var/spool/asterisk"
Installing file phoneprov/000000000000.cfg
Installing file phoneprov/000000000000-directory.xml
Installing file phoneprov/000000000000-phone.cfg
Installing file phoneprov/polycom_line.xml
Installing file phoneprov/polycom.xml
Installing file phoneprov/snom-mac.xml
</pre>

== Make the Asterisk 18.1.0 configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make config
</pre>

== Set ldconfig ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ldconfig
</pre>

== Setup user, group and permissions ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# groupadd asterisk
[root@cn38-inverness-co asterisk-18.1.0]# useradd -r -d /var/lib/asterisk -g asterisk asterisk
[root@cn38-inverness-co asterisk-18.1.0]# usermod -aG audio,dialout asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /etc/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /var/{lib,log,spool}/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /usr/lib/asterisk
</pre>

== Set runtime parameters ==

Need to change things in there.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/sysconfig/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/asterisk/asterisk.conf
</pre>

== Enable and Start Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl enable asterisk

asterisk.service is not a native service, redirecting to /sbin/chkconfig.
Executing /sbin/chkconfig asterisk on

[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl start asterisk

</pre>

== Connect to Asterisk and verify version ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# asterisk -rvv

parse error: No category context for line 1 of /etc/asterisk/asterisk.conf
Unable to open specified master config file '/etc/asterisk/asterisk.conf', using built-in defaults
Asterisk 18.1.0, Copyright (C) 1999 - 2018, Digium, Inc. and others.
Created by Mark Spencer <markster@digium.com>
Asterisk comes with ABSOLUTELY NO WARRANTY; type 'core show warranty' for details.
This is free software, with components licensed under the GNU General Public
License version 2 and other licenses; you are welcome to redistribute it under
certain conditions. Type 'core show license' for details.
=========================================================================
Connected to Asterisk 18.1.0 currently running on cn38-inverness-co (pid = 18370)
cn38-inverness-co*CLI>
Disconnected from Asterisk server
Asterisk cleanly ending (0).
Executing last minute cleanups
</pre>

= Configure Asterisk =

== Version 1.8 to 18.1.0 Errors ==

chan_agent => chan_agent_pool

chan_local => Asterisk core, no loadable module

bridge_multiplexed => ?

app_meetme => Part of DAHDI. Replaced by app_confbridge

Failed to resolve dependencies for func_curl

Failed to resolve dependencies for res_config_curl

Failed to resolve dependencies for app_page

User:Sfiggins/Asterisk 18 on CentOS7

2020-12-04T02:39:37Z

Sfiggins: /* Version 1.8 to 18.1.0 Errors */

= Install and Configure Base OS =

== Install from CentOS 7 CD (Minimal Install) ==

== Log into newly installed server ==

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
sfiggins@cn38-inverness-co.suburbanbroadband.net's password:
</pre>

== Setting up PSK login access, if desired ==

=== Copy authorized_keys from another server ===

I have another server that already has my authorized keys, so I"ll copy it from there. You can also past in your RSA key into '''~/.ssh/authorized_keys''', if you prefer.

<pre>
[sfiggins@cn38-inverness-co ~]$ scp -r 216.112.193.138:.ssh/ .

The authenticity of host '216.112.193.138 (216.112.193.138)' can't be established.
RSA key fingerprint is 5f:61:91:46:5c:c8:4c:a1:2e:25:0b:61:1e:97:d9:ed.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '216.112.193.138' (RSA) to the list of known hosts.
sfiggins@216.112.193.138's password:
known_hosts 100% 397 0.4KB/s 00:00
authorized_keys 100% 414 0.4KB/s 00:00

[sfiggins@cn38-inverness-co ~]$ logout
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

=== Login in using private key ===

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
Last login: Wed Dec 2 17:21:54 2020 from 209.116.189.54
</pre>

== Sudo to Root ==

All the installation steps in this guide must be performed as root. You can either prefix each command with '''"sudo"''' or just use sudo to become the '''root''' account and execute them as listed.

<pre>
[sfiggins@cn38-inverness-co ~]$ sudo su -

We trust you have received the usual lecture from the local System
Administrator. It usually boils down to these three things:

#1) Respect the privacy of others.
#2) Think before you type.
#3) With great power comes great responsibility.

[sudo] password for sfiggins:
Last login: Wed Dec 2 16:46:45 MST 2020 on tty1
</pre>

== Fix Sudoers ==

This fix will remove the need to reenter your puser password when running the '''"sudo"''' command. This is a preference, and does not need to be done if you prefer to enter the password each time.

<pre>
[root@cn38-inverness-co ~]# vi /etc/sudoers
</pre>

Comment out the below matching line, by adding '''"# "''' in beginning of the line.

<pre>
%wheel ALL=(ALL) ALL
</pre>

Remove the comment from the below matching line by removing the '''"# "''' from the beginning of the line.

<pre>
# %wheel ALL=(ALL) NOPASSWD: ALL
</pre>

Save this file using the '''":wq!"''' command, as this file is read-only.

== Disable and remove NetworkManager ==

The '''NetworkManager''' packages are not needed on a Linux server and they just get in the way. Removing them is the best option. They are more useful on a workstation that will be changing networks frequently.

<pre>
[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager

rm '/etc/systemd/system/multi-user.target.wants/NetworkManager.service'
rm '/etc/systemd/system/dbus-org.freedesktop.nm-dispatcher.service'
rm '/etc/systemd/system/dbus-org.freedesktop.NetworkManager.service'

[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager-dispatcher

[root@cn38-inverness-co ~]# yum erase NetworkManager-tui NetworkManager-glib NetworkManager

Loaded plugins: fastestmirror
No Match for argument: NetworkManager-glib
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
---> Package NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
NetworkManager x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 8.8 M
NetworkManager-tui x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 258 k

Transaction Summary
==============================================================================================================
Remove 2 Packages

Installed size: 9.1 M
Is this ok [y/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Erasing : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2
Verifying : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Verifying : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2

Removed:
NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7
NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7

Complete!
</pre>

== Disable SELinux ==

This mostly gets in the way, and we will disable it. There are steps that can be taken to leave this intact and functioning and still allow the system to function propperly, but I'll not discuss that here.

<pre>
[root@cn38-inverness-co ~]# setenforce 0
[root@cn38-inverness-co ~]# sed -i.bak "s/^SELINUX=.*/SELINUX=disabled/g" /etc/selinux/config
</pre>

== Update System Packages ==

Update the system packages. Some of the later steps will require give errors depending on system package levels that are available, and it is just good measure to make sure the latest packages are installed.

<pre>
[root@cn38-inverness-co ~]# yum -y update

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager-libnm.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be updated

=== SNIP ===

---> Package libstdc++.i686 0:4.8.5-44.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:

=== SNIP ===

Updating:

=== SNIP ===

Installing for dependencies:

=== SNIP ===

Transaction Summary
==============================================================================================================
Install 8 Packages (+47 Dependent packages)
Upgrade 240 Packages

Total size: 325 M
Total download size: 275 M
Downloading packages:
Delta RPMs disabled because /usr/bin/applydeltarpm not installed.
(1/230): acl-2.2.51-15.el7.x86_64.rpm | 81 kB 00:00:00

=== SNIP ===

(230/230): tzdata-2020d-2.el7.noarch.rpm | 499 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 17 MB/s | 275 MB 00:00:16
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Updating : libgcc-4.8.5-44.el7.x86_64 1/539
Installing : 1:grub2-common-2.02-0.86.el7.centos.noarch 2/539
Updating : centos-release-7-9.2009.1.el7.centos.x86_64 3/539

=== SNIP ===

Installing : rdma-core-22.4-5.el7.i686 295/539
Cleanup : tuned-2.4.1-1.el7.noarch 296/539

=== SNIP ===

Cleanup : 12:dhclient-4.2.5-36.el7.centos.x86_64 385/539

UPGRADE: Automatically re-enabling default systemd units:
brandbot.path
rhel-autorelabel.service
rhel-autorelabel-mark.service
rhel-configure.service
rhel-dmesg.service
rhel-domainname.service
rhel-import-state.service
rhel-loadmodules.service
rhel-readonly.service

Cleanup : initscripts-9.49.24-1.el7.x86_64 386/539

=== SNIP ===

Cleanup : libgcc-4.8.3-9.el7.x86_64 539/539
Verifying : glibc-common-2.17-317.el7.x86_64 1/539

=== SNIP ===

Verifying : 7:device-mapper-1.02.93-3.el7.x86_64 539/539

Installed:
grub2.x86_64 1:2.02-0.86.el7.centos grub2-tools.x86_64 1:2.02-0.86.el7.centos
grub2-tools-extra.x86_64 1:2.02-0.86.el7.centos grub2-tools-minimal.x86_64 1:2.02-0.86.el7.centos
kernel.x86_64 0:3.10.0-1160.6.1.el7 python-gobject-base.x86_64 0:3.22.0-1.el7_4.1
rdma-core.i686 0:22.4-5.el7 rdma-core.x86_64 0:22.4-5.el7

Dependency Installed:
GeoIP.x86_64 0:1.5.0-14.el7 audit-libs.i686 0:2.8.5-4.el7

=== SNIP ===

zlib.i686 0:1.2.7-18.el7

Updated:
NetworkManager-libnm.x86_64 1:1.18.8-2.el7_9

=== SNIP ===

zlib.x86_64 0:1.2.7-18.el7

Replaced:
grub2.x86_64 1:2.02-0.16.el7.centos grub2-tools.x86_64 1:2.02-0.16.el7.centos
pygobject3-base.x86_64 0:3.8.2-6.el7 rdma.noarch 0:7.1_3.17-5.el7

Complete!
</pre>

== Install Additional Packages ==

These are useful utilities that have been stripped from the base install in CentOS7. Adding these back in allows for easier troubleshooting of the server.

<pre>
[root@cn38-inverness-co ~]# yum -y install finger nc net-snmp net-snmp-perl net-snmp-utils ntp perl-Date-Manip \
perl-DBD-SQLite sssd tcp_wrappers tcpdump telnet tftp tog-pegasus traceroute \
vim-enhanced wget oddjob-mkhomedir net-tools yum-cron bind-utils

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 will be installed
--> Processing Dependency: bind-libs(x86-64) = 32:9.11.4-26.P2.el7_9.2 for package: 32:bind-utils-9.11.4-26.P2.el7_9.2.x86_64

=== SNIP ===

---> Package pcre-devel.x86_64 0:8.32-17.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bind-utils x86_64 32:9.11.4-26.P2.el7_9.2 updates 260 k

=== SNIP ===

yum-cron noarch 3.4.3-168.el7.centos base 66 k
Installing for dependencies:
autogen-libopts x86_64 5.18-5.el7 base 66 k

=== SNIP ===

zlib-devel x86_64 1.2.7-18.el7 base 50 k

Transaction Summary
==============================================================================================================
Install 21 Packages (+114 Dependent packages)

Total size: 59 M
Installed size: 166 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtalloc-2.1.16-1.el7.x86_64 1/135

=== SNIP ===

Installing : finger-0.17-52.el7.x86_64 135/135
Verifying : perl-HTTP-Tiny-0.033-3.el7.noarch 1/135

=== SNIP ===

Verifying : 2:nmap-ncat-6.40-19.el7.x86_64 135/135

Installed:
bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 finger.x86_64 0:0.17-52.el7
net-snmp.x86_64 1:5.7.2-49.el7 net-snmp-perl.x86_64 1:5.7.2-49.el7
net-snmp-utils.x86_64 1:5.7.2-49.el7 net-tools.x86_64 0:2.0-0.25.20131004git.el7
nmap-ncat.x86_64 2:6.40-19.el7 ntp.x86_64 0:4.2.6p5-29.el7.centos.2
oddjob-mkhomedir.x86_64 0:0.31.5-4.el7 perl-DBD-SQLite.x86_64 0:1.39-3.el7
perl-Date-Manip.noarch 0:6.41-2.el7 sssd.x86_64 0:1.16.5-10.el7_9.5
tcp_wrappers.x86_64 0:7.6-77.el7 tcpdump.x86_64 14:4.9.2-4.el7_7.1
telnet.x86_64 1:0.17-66.el7 tftp.x86_64 0:5.2-22.el7
tog-pegasus.x86_64 2:2.14.1-8.el7 traceroute.x86_64 3:2.0.22-2.el7
vim-enhanced.x86_64 2:7.4.629-7.el7 wget.x86_64 0:1.14-18.el7_6.1
yum-cron.noarch 0:3.4.3-168.el7.centos

Dependency Installed:
autogen-libopts.x86_64 0:5.18-5.el7

=== SNIP ===

zlib-devel.x86_64 0:1.2.7-18.el7

Complete!
</pre>

== Fix Timezone ==

This is just a preference, but it will standardize the timezone.

<pre>
[root@cn38-inverness-co ~]# rm -f /etc/localtime
[root@cn38-inverness-co ~]# ln -s /usr/share/zoneinfo/MST7MDT /etc/localtime
</pre>

== Disable RPF ==

Reverse Path Forwarding (RPF) is a security protection that will prevent inbound packets from entering an IP interface that does not have outbound routes to the source IP. It is not important to disable this if your server only has one interface, however if you have multiple network interfaces, and you may be receiving asymmetric traffic, this needs to be disabled to allow the packets to enter the system.

<pre>
[root@cn38-inverness-co ~]# echo "net.ipv4.conf.default.rp_filter = 0" > /etc/sysctl.d/rpfilter.conf
</pre>

== Install vmtools (if virtual) ==

'''Only do this step if you are installing on a virtual platform. This is not required if you are installing on bare metal.'''

<pre>
[root@cn38-inverness-co ~]# yum -y install open-vm-tools

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package open-vm-tools.x86_64 0:11.0.5-3.el7_9.1 will be installed
--> Processing Dependency: xmlsec1-openssl for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.6)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.5)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: fuse for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxslt.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxmlsec1.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libmspack.so.0()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libltdl.so.7()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Running transaction check
---> Package fuse.x86_64 0:2.9.2-11.el7 will be installed
---> Package fuse-libs.x86_64 0:2.9.2-11.el7 will be installed
---> Package libmspack.x86_64 0:0.5-0.8.alpha.el7 will be installed
---> Package libtool-ltdl.x86_64 0:2.4.2-22.el7_3 will be installed
---> Package libxslt.x86_64 0:1.1.28-6.el7 will be installed
---> Package xmlsec1.x86_64 0:1.2.20-7.el7_4 will be installed
---> Package xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
open-vm-tools x86_64 11.0.5-3.el7_9.1 updates 676 k
Installing for dependencies:
fuse x86_64 2.9.2-11.el7 base 86 k
fuse-libs x86_64 2.9.2-11.el7 base 93 k
libmspack x86_64 0.5-0.8.alpha.el7 base 64 k
libtool-ltdl x86_64 2.4.2-22.el7_3 base 49 k
libxslt x86_64 1.1.28-6.el7 base 242 k
xmlsec1 x86_64 1.2.20-7.el7_4 base 177 k
xmlsec1-openssl x86_64 1.2.20-7.el7_4 base 76 k

Transaction Summary
==============================================================================================================
Install 1 Package (+7 Dependent packages)

Total download size: 1.4 M
Installed size: 4.0 M
Downloading packages:
(1/8): fuse-2.9.2-11.el7.x86_64.rpm | 86 kB 00:00:00
(2/8): fuse-libs-2.9.2-11.el7.x86_64.rpm | 93 kB 00:00:00
(3/8): libtool-ltdl-2.4.2-22.el7_3.x86_64.rpm | 49 kB 00:00:00
(4/8): libmspack-0.5-0.8.alpha.el7.x86_64.rpm | 64 kB 00:00:00
(5/8): xmlsec1-1.2.20-7.el7_4.x86_64.rpm | 177 kB 00:00:00
(6/8): libxslt-1.1.28-6.el7.x86_64.rpm | 242 kB 00:00:00
(7/8): xmlsec1-openssl-1.2.20-7.el7_4.x86_64.rpm | 76 kB 00:00:00
(8/8): open-vm-tools-11.0.5-3.el7_9.1.x86_64.rpm | 676 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.4 MB/s | 1.4 MB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtool-ltdl-2.4.2-22.el7_3.x86_64 1/8
Installing : libxslt-1.1.28-6.el7.x86_64 2/8
Installing : xmlsec1-1.2.20-7.el7_4.x86_64 3/8
Installing : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Installing : fuse-2.9.2-11.el7.x86_64 5/8
Installing : fuse-libs-2.9.2-11.el7.x86_64 6/8
Installing : libmspack-0.5-0.8.alpha.el7.x86_64 7/8
Installing : open-vm-tools-11.0.5-3.el7_9.1.x86_64 8/8
Verifying : libmspack-0.5-0.8.alpha.el7.x86_64 1/8
Verifying : fuse-libs-2.9.2-11.el7.x86_64 2/8
Verifying : fuse-2.9.2-11.el7.x86_64 3/8
Verifying : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Verifying : libxslt-1.1.28-6.el7.x86_64 5/8
Verifying : xmlsec1-1.2.20-7.el7_4.x86_64 6/8
Verifying : open-vm-tools-11.0.5-3.el7_9.1.x86_64 7/8
Verifying : libtool-ltdl-2.4.2-22.el7_3.x86_64 8/8

Installed:
open-vm-tools.x86_64 0:11.0.5-3.el7_9.1

Dependency Installed:
fuse.x86_64 0:2.9.2-11.el7 fuse-libs.x86_64 0:2.9.2-11.el7
libmspack.x86_64 0:0.5-0.8.alpha.el7 libtool-ltdl.x86_64 0:2.4.2-22.el7_3
libxslt.x86_64 0:1.1.28-6.el7 xmlsec1.x86_64 0:1.2.20-7.el7_4
xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4

Complete!
</pre>

== Reboot Server ==

<pre>
[root@cn38-inverness-co ~]# shutdown -r now
Connection to cn38-inverness-co.suburbanbroadband.net closed by remote host.
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

== Remove old kernel ==

<pre>
[root@cn38-inverness-co ~]# rpm -qa | grep kernel

kernel-tools-libs-3.10.0-1160.6.1.el7.x86_64
kernel-headers-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-229.el7.x86_64
kernel-tools-3.10.0-1160.6.1.el7.x86_64

[root@cn38-inverness-co ~]# yum -y erase kernel-3.10.0-229.el7.x86_64

Loaded plugins: fastestmirror
Resolving Dependencies
--> Running transaction check
---> Package kernel.x86_64 0:3.10.0-229.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
kernel x86_64 3.10.0-229.el7 @anaconda 131 M

Transaction Summary
==============================================================================================================
Remove 1 Package

Installed size: 131 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : kernel-3.10.0-229.el7.x86_64 1/1
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.softdep: remove failed: No such file or directory
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.devname: remove failed: No such file or directory
Verifying : kernel-3.10.0-229.el7.x86_64 1/1

Removed:
kernel.x86_64 0:3.10.0-229.el7

Complete!
</pre>

= Download and Compile Asterisk 18.1.0 =

== Install Development Packages ==

We will be compiling Asterisk from source, so we will need to install some development tools. There may be some duplicates int he list that have already been installed earlier.

<pre>
[root@cn38-inverness-co ~]# yum -y install gcc ncurses-devel openssl-devel gcc-c++ gnutls-devel \
make wget openssh openssh-clients openssh-server ntp sendmail rsync ftp mysql mysql-server \
mysql-devel curl curl-devel traceroute telnet which rpm-build flex gcc newt-devel libusb-devel \
net-snmp-utils bison byacc libxml2-devel vixie-cron mailx xinetd tcpdump

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Package gcc-4.8.5-44.el7.x86_64 already installed and latest version

=== SNIP ===

Package 1:net-snmp-utils-5.7.2-49.el7.x86_64 already installed and latest version
No package vixie-cron available.
Package 14:tcpdump-4.9.2-4.el7_7.1.x86_64 already installed and latest version
Resolving Dependencies
--> Running transaction check
---> Package bison.x86_64 0:3.0.4-2.el7 will be installed

=== SNIP ===

---> Package libevent.x86_64 0:2.0.21-4.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bison x86_64 3.0.4-2.el7 base 674 k

=== SNIP ===

xinetd x86_64 2:2.3.15-14.el7 base 128 k
Installing for dependencies:
bzip2 x86_64 1.0.6-13.el7 base 52 k

=== SNIP ===

zip x86_64 3.0-11.el7 base 260 k

Transaction Summary
==============================================================================================================
Install 18 Packages (+27 Dependent packages)

Total download size: 30 M
Installed size: 110 M
Downloading packages:
(1/45): byacc-1.9.20130304-3.el7.x86_64.rpm | 65 kB 00:00:00

=== SNIP ===

(45/45): zip-3.0-11.el7.x86_64.rpm | 260 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 13 MB/s | 30 MB 00:00:02
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : m4-1.4.16-10.el7.x86_64 1/45

=== SNIP ===

Installing : 2:xinetd-2.3.15-14.el7.x86_64 45/45
Verifying : gcc-c++-4.8.5-44.el7.x86_64 1/45

=== SNIP ===

Verifying : gnutls-devel-3.3.29-9.el7_6.x86_64 45/45

Installed:
bison.x86_64 0:3.0.4-2.el7 byacc.x86_64 0:1.9.20130304-3.el7
flex.x86_64 0:2.5.37-6.el7 ftp.x86_64 0:0.17-67.el7
gcc-c++.x86_64 0:4.8.5-44.el7 gnutls-devel.x86_64 0:3.3.29-9.el7_6
libcurl-devel.x86_64 0:7.29.0-59.el7_9.1 libusb-devel.x86_64 1:0.1.4-3.el7
libxml2-devel.x86_64 0:2.9.1-6.el7.5 mailx.x86_64 0:12.5-19.el7
mariadb.x86_64 1:5.5.68-1.el7 mariadb-devel.x86_64 1:5.5.68-1.el7
ncurses-devel.x86_64 0:5.9-14.20130511.el7_4 newt-devel.x86_64 0:0.52.15-4.el7
rpm-build.x86_64 0:4.11.3-45.el7 rsync.x86_64 0:3.1.2-10.el7
sendmail.x86_64 0:8.14.7-6.el7 xinetd.x86_64 2:2.3.15-14.el7

Dependency Installed:
bzip2.x86_64 0:1.0.6-13.el7 cyrus-sasl.x86_64 0:2.1.26-23.el7
dwz.x86_64 0:0.11-3.el7 elfutils.x86_64 0:0.176-5.el7
gdb.x86_64 0:7.6.1-120.el7 gmp-devel.x86_64 1:6.0.0-15.el7
gnutls-c++.x86_64 0:3.3.29-9.el7_6 gnutls-dane.x86_64 0:3.3.29-9.el7_6
hesiod.x86_64 0:3.2.1-3.el7 libevent.x86_64 0:2.0.21-4.el7
libstdc++-devel.x86_64 0:4.8.5-44.el7 libtasn1-devel.x86_64 0:4.10-1.el7
libusb.x86_64 1:0.1.4-3.el7 libusbx.x86_64 0:1.0.21-1.el7
m4.x86_64 0:1.4.16-10.el7 nettle-devel.x86_64 0:2.7.1-8.el7
p11-kit-devel.x86_64 0:0.23.5-3.el7 patch.x86_64 0:2.7.1-12.el7_7
perl-Thread-Queue.noarch 0:3.02-2.el7 perl-srpm-macros.noarch 0:1-8.el7
procmail.x86_64 0:3.22-36.el7_4.1 python-srpm-macros.noarch 0:3-34.el7
redhat-rpm-config.noarch 0:9.1.0-88.el7.centos slang-devel.x86_64 0:2.2.4-11.el7
unbound-libs.x86_64 0:1.6.6-5.el7_8 unzip.x86_64 0:6.0-21.el7
zip.x86_64 0:3.0-11.el7

Complete!
== Generate RSA Key ==

<pre>
[root@cn38-inverness-co ~]# ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Created directory '/root/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:FKpB44T5QoKCZtkOoU4ZF6w7T0G98QZ60gHU9QpQM9k root@cn38-inverness-co.suburbanbroadband.net
The key's randomart image is:
+---[RSA 2048]----+
|oo*OX++.. |
|*=BB.OoE.. |
|===.=.B .. |
|o..=.*.+. |
| ...= ..S |
| o . |
| + |
| . |
| |
+----[SHA256]-----+

</pre>

== Download Asterisk 18.1.0 ==

Change directory to /usr/local/src and download the Asterisk source code.

<pre>
[root@cn38-inverness-co ~]# cd /usr/local/src/

[root@cn38-inverness-co src]# wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz

--2020-12-02 17:39:25-- https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 27886299 (27M) [application/x-gzip]
Saving to: ‘asterisk-18-current.tar.gz’

100%[====================================================================>] 27,886,299 8.03MB/s in 3.3s

2020-12-02 17:39:29 (8.03 MB/s) - ‘asterisk-18-current.tar.gz’ saved [27886299/27886299]
</pre>

For future reference, you can also find it directly here:

[https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz]

== Uncompress Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co src]# tar -zxf asterisk-18-current.tar.gz

[root@cn38-inverness-co src]# ls
asterisk-18.1.0

[root@cn38-inverness-co src]# cd asterisk-18.1.0/

[root@cn38-inverness-co asterisk-18.1.0]# ls
addons channels include README-SERIOUSLY.bestpractices.md
agi codecs install-sh res
apps config.guess LICENSE rest-api
asterisk-18.1.0-summary.html configs main rest-api-templates
asterisk-18.1.0-summary.txt config.sub Makefile sample.call
autoconf configure Makefile.moddir_rules sounds
bootstrap.sh configure.ac Makefile.rules static-http
bridges contrib makeopts.in tests
BSDmakefile COPYING menuselect third-party
BUGS CREDITS missing UPGRADE.txt
build_tools default.exports mkinstalldirs utils
cdr doc pbx Zaptel-to-DAHDI.txt
cel formats phoneprov
ChangeLog funcs README-addons.txt
CHANGES images README.md

</pre>

== Test the prereqs ==

Run the '''"./contrib/scripts/install_prereq test"''' command in order to test the installed prerequesits. After it returns the things that need to be installed, you can just copy and paste that command. If there are packages that are not installed afterthe command due to not existing in the CentOS 7 main repo, they are probably not required.

<pre>

[root@cn38-inverness-co asterisk-18.1.0]# ./contrib/scripts/install_prereq test

#############################################
## test: test mode.
## Use the commands here to install your system.
#############################################
yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

[root@cn38-inverness-co asterisk-18.1.0]# yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
No package speexdsp-devel available.
No package portaudio-devel available.
No package xmlstarlet available.
No package gmime-devel available.
Package 1:mariadb-devel-5.5.68-1.el7.x86_64 already installed and latest version
No package radcli-devel available.
No package freetds-devel available.
No package jack-audio-connection-kit-devel available.
No package iksemel-devel available.
No package spandsp-devel available.
No package libresample-devel available.
No package uw-imap-devel available.
No package hoard available.
No package codec2-devel available.
Resolving Dependencies
--> Running transaction check
---> Package alsa-lib-devel.x86_64 0:1.1.8-1.el7 will be installed

=== SNIP ===

---> Package mesa-libglapi.x86_64 0:18.3.4-12.el7_9 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
alsa-lib-devel x86_64 1.1.8-1.el7 base 963 k

=== SNIP ===

uriparser-devel x86_64 0.7.5-10.el7 base 138 k
Installing for dependencies:
adobe-mappings-cmap noarch 20171205-3.el7 base 2.1 M

=== SNIP ===

xorg-x11-server-utils x86_64 7.7-20.el7 base 178 k

Transaction Summary
==============================================================================================================
Install 28 Packages (+117 Dependent packages)

Total download size: 56 M
Installed size: 216 M
Downloading packages:
(1/145): adobe-mappings-cmap-deprecated-20171205-3.el7.noarch.rpm | 114 kB 00:00:00

=== SNIP ===

(145/145): xorg-x11-server-utils-7.7-20.el7.x86_64.rpm | 178 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 9.3 MB/s | 56 MB 00:00:06
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libjpeg-turbo-1.2.90-8.el7.x86_64 1/145

=== SNIP ===

Installing : libedit-devel-3.0-12.20121213cvs.el7.x86_64 145/145
Verifying : libXext-1.3.3-3.el7.x86_64 1/145

=== SNIP ===

Verifying : libcgroup-0.41-21.el7.x86_64 145/145

Installed:
alsa-lib-devel.x86_64 0:1.1.8-1.el7 binutils-devel.x86_64 0:2.27-44.base.el7

=== SNIP ===

Dependency Installed:
adobe-mappings-cmap.noarch 0:20171205-3.el7

=== SNIP ===

Complete!
</pre>

== Run ./configure for Asterisk ==

For CentOS 7.X, you will get an error about needing a newer version of jansson library. It may be possible to manually install the newer version, however it is probaly fine to just use the '''--with-jansson-bundled''' flag to include the version bundled with Asterisk source code.

In addition, we will want to load the bundled pjsip channel drivers, with the '''--with-pjproject-pundled'''.

Hopefully this completed without any issues, however you should look over the output to ensure it is what you are expecting.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ./configure --with-jansson-bundled --with-pjproject-bundled

checking build system type... x86_64-pc-linux-gnu

=== SNIP ===

checking for pkg-config... /bin/pkg-config
checking pkg-config is at least version 0.9.0... yes
checking for GTK2... no
configure: creating ./config.status
config.status: creating makeopts
config.status: creating autoconfig.h
configure: Menuselect build configuration successfully completed

.$$$$$$$$$$$$$$$=..
.$7$7.. .7$$7:.
.$$:. ,$7.7
.$7. 7$$$$ .$$77
..$$. $$$$$ .$$$7
..7$ .?. $$$$$ .?. 7$$$.
$.$. .$$$7. $$$$7 .7$$$. .$$$.
.777. .$$$$$$77$$$77$$$$$7. $$$,
$$$~ .7$$$$$$$$$$$$$7. .$$$.
.$$7 .7$$$$$$$7: ?$$$.
$$$ ?7$$$$$$$$$$I .$$$7
$$$ .7$$$$$$$$$$$$$$$$ :$$$.
$$$ $$$$$$7$$$$$$$$$$$$ .$$$.
$$$ $$$ 7$$$7 .$$$ .$$$.
$$$$ $$$$7 .$$$.
7$$$7 7$$$$ 7$$$
$$$$$ $$$
$$$$7. $$ (TM)
$$$$$$$. .7$$$$$$ $$
$$$$$$$$$$$$7$$$$$$$$$.$$$$$$
$$$$$$$$$$$$$$$$.

configure: Package configured for:
configure: OS type : linux-gnu
configure: Host CPU : x86_64
configure: build-cpu:vendor:os: x86_64 : pc : linux-gnu :
configure: host-cpu:vendor:os: x86_64 : pc : linux-gnu :

</pre>

== Install UW-IMAP library for IMAP integration for Voice Mails ==

We will want to configure Asterisk to store voicemails via IMAP instead of the local file system. This will allow better deployment of HA down the road.

=== Download uw-imap for storage ===

The UW-IMAP code is no longer maintained after the creator's death, so it's a good idea to archive the important parts.

<pre>
[root@cn38-inverness-co ~]# wget https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/u/uw-imap-2007f-16.el7.x86_64.rpm

--2020-12-02 18:34:30-- https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/u/uw-imap-2007f-16.el7.x86_64.rpm
Resolving download-ib01.fedoraproject.org (download-ib01.fedoraproject.org)... 152.19.134.145, 2610:28:3090:3001:dead:beef:cafe:fed6
Connecting to download-ib01.fedoraproject.org (download-ib01.fedoraproject.org)|152.19.134.145|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 68284 (67K) [application/x-rpm]
Saving to: ‘uw-imap-2007f-16.el7.x86_64.rpm’

100%[====================================================================>] 68,284 --.-K/s in 0.09s

2020-12-02 18:34:31 (703 KB/s) - ‘uw-imap-2007f-16.el7.x86_64.rpm’ saved [68284/68284]
</pre>

=== Install EPEL repo ===

We'll use EPEL to install UW-IMAP, so we have to install that first. After installation, we can go back in and disable teh EPEL repo, if we desire.

<pre>

[root@cn38-inverness-co ~]# yum -y install epel-release

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package epel-release.noarch 0:7-11 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
epel-release noarch 7-11 extras 15 k

Transaction Summary
==============================================================================================================
Install 1 Package

Total download size: 15 k
Installed size: 24 k
Downloading packages:
epel-release-7-11.noarch.rpm | 15 kB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : epel-release-7-11.noarch 1/1
Verifying : epel-release-7-11.noarch 1/1

Installed:
epel-release.noarch 0:7-11

Complete!

</pre>

=== Install uw-imap ===

Finally, the install of UW-IMAP. It will require an additional dependency be installed.

<pre>
[root@cn38-inverness-co ~]# yum install uw-imap

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
epel/x86_64/metalink | 13 kB 00:00:00
* base: mirror.dal10.us.leaseweb.net
* epel: mirror.dal.nexril.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
epel | 4.7 kB 00:00:00
(1/3): epel/x86_64/group_gz | 95 kB 00:00:00
(2/3): epel/x86_64/updateinfo | 1.0 MB 00:00:00
(3/3): epel/x86_64/primary_db | 6.9 MB 00:00:00
Resolving Dependencies
--> Running transaction check
---> Package uw-imap.x86_64 0:2007f-16.el7 will be installed
--> Processing Dependency: libc-client(x86-64) = 2007f-16.el7 for package: uw-imap-2007f-16.el7.x86_64
--> Processing Dependency: libc-client.so.2007()(64bit) for package: uw-imap-2007f-16.el7.x86_64
--> Running transaction check
---> Package libc-client.x86_64 0:2007f-16.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
uw-imap x86_64 2007f-16.el7 epel 67 k
Installing for dependencies:
libc-client x86_64 2007f-16.el7 epel 562 k

Transaction Summary
==============================================================================================================
Install 1 Package (+1 Dependent package)

Total download size: 628 k
Installed size: 1.6 M
Is this ok [y/d/N]: y
Downloading packages:
warning: /var/cache/yum/x86_64/7/epel/packages/libc-client-2007f-16.el7.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 352c64e5: NOKEY
Public key for libc-client-2007f-16.el7.x86_64.rpm is not installed
(1/2): libc-client-2007f-16.el7.x86_64.rpm | 562 kB 00:00:00
(2/2): uw-imap-2007f-16.el7.x86_64.rpm | 67 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.0 MB/s | 628 kB 00:00:00
Retrieving key from file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Importing GPG key 0x352C64E5:
Userid : "Fedora EPEL (7) <epel@fedoraproject.org>"
Fingerprint: 91e9 7d7c 4a5e 96f1 7f3e 888f 6a2f aea2 352c 64e5
Package : epel-release-7-11.noarch (@extras)
From : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Is this ok [y/N]: y
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libc-client-2007f-16.el7.x86_64 1/2
Installing : uw-imap-2007f-16.el7.x86_64 2/2
Verifying : libc-client-2007f-16.el7.x86_64 1/2
Verifying : uw-imap-2007f-16.el7.x86_64 2/2

Installed:
uw-imap.x86_64 0:2007f-16.el7

Dependency Installed:
libc-client.x86_64 0:2007f-16.el7

Complete!

</pre>

== make menuselect ==

By default, a lot of options are not included in the Asterisk build, and need to be configured. This is done by running the '''"make menu"''' command in the asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make menuselect

CC="cc" CXX="g++" LD="" AR="" RANLIB="" CFLAGS="" LDFLAGS="" make -C menuselect CONFIGURE_SILENT="--silent" gmenuselect
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Nothing to be done for `gmenuselect'.
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0'
menuselect changes saved!
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0'

</pre>

In '''Add-ons''', select '''chan_ooh323''', '''format_mp3''', '''res_config_mysql''', '''app_mysql''' and '''crd_mysql'''.

[[File:Asterisk1810-Add-ons.png|none|frame|Add-ons]]

In '''Core Sound Packages''', select '''EN-WAV''', '''EN-ULAW''', '''EN-ALAW''', '''EN-GSM''', '''EN-G729''', '''EN-G722''', '''EN-SLN16''', '''EN-SIREN7''', and '''EN-SIREN14'''.

[[File:Asterisk1810-coresound.png|none|frame|Core Sound Packages]]

In '''Music On Hold File Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-musiconhold.png|none|frame|Music On Hold File Packages]]

In '''Extras Sound Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-extrasound.png|none|frame|Extras Sound Packages]]

In '''Applications''', select '''app_voicemail''', '''app_voicemail_imap''', '''app_voicemail_odbc''', '''app_macro'''.

[[File:Asterisk1810-applications1.png|none|frame|Applications Voicemail]]
[[File:Asterisk1810-applications2.png|none|frame|Applications Macro]]

== Download MP3 sources ==

Download the required MP3 sources by running the '''contrib/scripts/get_mp3_source.sh''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# contrib/scripts/get_mp3_source.sh

A addons/mp3
A addons/mp3/MPGLIB_TODO
A addons/mp3/mpg123.h
A addons/mp3/layer3.c
A addons/mp3/mpglib.h
A addons/mp3/decode_ntom.c
A addons/mp3/interface.c
A addons/mp3/MPGLIB_README
A addons/mp3/common.c
A addons/mp3/huffman.h
A addons/mp3/tabinit.c
A addons/mp3/Makefile
A addons/mp3/README
A addons/mp3/decode_i386.c
A addons/mp3/dct64_i386.c
Exported revision 202.
</pre>

== Compile Asterisk 18.1.0 ==

We compile the Asterisk code by running the '''make''' command inside the build directory. This should compile at this point, but if there are any errors, additional changes to the system may be required. ''The output below is shortened for space.''

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make

[CC] astcanary.c -> astcanary.o
[LD] astcanary.o -> astcanary
[CC] astdb2sqlite3.c -> astdb2sqlite3.o
[CC] hash/hash.c -> hash/hash.o
[CC] hash/hash_bigkey.c -> hash/hash_bigkey.o
[CC] hash/hash_buf.c -> hash/hash_buf.o
[CC] hash/hash_func.c -> hash/hash_func.o
[CC] hash/hash_log2.c -> hash/hash_log2.o
[CC] hash/hash_page.c -> hash/hash_page.o

=== SNIP ===

[LD] chan_ooh323.o ooh323c/src/ooCmdChannel.o ooh323c/src/ooLogChan.o ooh323c/src/ooUtils.o ooh323c/src/ooGkClient.o ooh323c/src/context.o ooh323c/src/ooDateTime.o ooh323c/src/decode.o ooh323c/src/dlist.o ooh323c/src/encode.o ooh323c/src/errmgmt.o ooh323c/src/memheap.o ooh323c/src/ootrace.o ooh323c/src/oochannels.o ooh323c/src/ooh245.o ooh323c/src/ooports.o ooh323c/src/ooq931.o ooh323c/src/ooCapability.o ooh323c/src/ooSocket.o ooh323c/src/perutil.o ooh323c/src/eventHandler.o ooh323c/src/ooCalls.o ooh323c/src/ooStackCmds.o ooh323c/src/ooh323.o ooh323c/src/ooh323ep.o ooh323c/src/printHandler.o ooh323c/src/rtctype.o ooh323c/src/ooTimer.o ooh323c/src/h323/H235-SECURITY-MESSAGESDec.o ooh323c/src/h323/H235-SECURITY-MESSAGESEnc.o ooh323c/src/h323/H323-MESSAGES.o ooh323c/src/h323/H323-MESSAGESDec.o ooh323c/src/h323/H323-MESSAGESEnc.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROL.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLDec.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLEnc.o ooh323cDriver.o -> chan_ooh323.so
[CC] format_mp3.c -> format_mp3.o
[CC] mp3/common.c -> mp3/common.o
[CC] mp3/dct64_i386.c -> mp3/dct64_i386.o
[CC] mp3/decode_ntom.c -> mp3/decode_ntom.o
[CC] mp3/layer3.c -> mp3/layer3.o
[CC] mp3/tabinit.c -> mp3/tabinit.o
[CC] mp3/interface.c -> mp3/interface.o
[LD] format_mp3.o mp3/common.o mp3/dct64_i386.o mp3/decode_ntom.o mp3/layer3.o mp3/tabinit.o mp3/interface.o -> format_mp3.so
[CC] res_config_mysql.c -> res_config_mysql.o
[LD] res_config_mysql.o -> res_config_mysql.so
Building Documentation For: third-party channels pbx apps codecs formats cdr cel bridges funcs tests main res addons
+--------- Asterisk Build Complete ---------+
+ Asterisk has successfully been built, and +
+ can be installed by running: +
+ +
+ make install +
+-------------------------------------------+
</pre>

== Install for Asterisk 18.1.0 ==

We install Asterisk by running the '''make install''' command in the Asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make install
Installing modules from channels...
Installing modules from pbx...
Installing modules from apps...
Installing modules from codecs...
Installing modules from formats...
Installing modules from cdr...
Installing modules from cel...
Installing modules from bridges...
Installing modules from funcs...
Installing modules from tests...
Installing modules from main...
Installing modules from res...
Installing modules from addons...
/bin/install -c -m 755 contrib/scripts/astversion "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/astgenkey "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/autosupport "/usr/sbin/"
if [ ! -f /sbin/launchd ]; then \
./build_tools/install_subst contrib/scripts/safe_asterisk "/usr/sbin/safe_asterisk"; \
fi
/bin/install -c -m 644 doc/core-*.xml "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.dtd "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/asterisk.8 "/usr/share/man/man8"
/bin/install -c -m 644 doc/astdb*.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/astgenkey.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/autosupport.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/safe_asterisk.8 "/usr/share/man/man8"
if [ -f contrib/firmware/iax/iaxy.bin ] ; then \
/bin/install -c -m 644 contrib/firmware/iax/iaxy.bin "/var/lib/asterisk/firmware/iax/iaxy.bin"; \
fi
CFLAGS=" -I/usr/include/libxml2 -pipe -Wall -Wstrict-prototypes -Wmissing-prototypes -Wmissing-declarations -g3 " build_tools/mkpkgconfig "/usr/lib/pkgconfig";
find static-http | while read x; do \
if test -d $x; then \
/bin/install -c -m 755 -d "/var/lib/asterisk/$x"; \
else \
/bin/install -c -m 644 $x "/var/lib/asterisk/$x" ; \
fi \
done
/bin/install -c -m 644 doc/core-en_US.xml "/var/lib/asterisk/static-http";
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/static-http";
if [ -d doc/tex/asterisk ] ; then \
/bin/install -c -d "/var/lib/asterisk/static-http/docs" ; \
for n in doc/tex/asterisk/* ; do \
/bin/install -c -m 644 $n "/var/lib/asterisk/static-http/docs" ; \
done \
fi
for x in images/*.jpg; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/images" ; \
done
make -C sounds install
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/sounds'
--2020-12-02 18:52:05-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-wav-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 20176188 (19M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’

100%[====================================================================>] 20,176,188 7.79MB/s in 2.5s

2020-12-02 18:52:08 (7.79 MB/s) - ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’ saved [20176188/20176188]

--2020-12-02 18:52:09-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-ulaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10241447 (9.8M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’

100%[====================================================================>] 10,241,447 1.71MB/s in 6.4s

2020-12-02 18:52:15 (1.52 MB/s) - ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’ saved [10241447/10241447]

--2020-12-02 18:52:16-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-alaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9937284 (9.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’

100%[====================================================================>] 9,937,284 3.40MB/s in 2.8s

2020-12-02 18:52:18 (3.40 MB/s) - ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’ saved [9937284/9937284]

--2020-12-02 18:52:19-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g729-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1557751 (1.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’

100%[====================================================================>] 1,557,751 2.78MB/s in 0.5s

2020-12-02 18:52:20 (2.78 MB/s) - ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’ saved [1557751/1557751]

--2020-12-02 18:52:20-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g722-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10756090 (10M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’

100%[====================================================================>] 10,756,090 6.58MB/s in 1.6s

2020-12-02 18:52:21 (6.58 MB/s) - ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’ saved [10756090/10756090]

--2020-12-02 18:52:22-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-sln16-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 41366110 (39M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’

100%[====================================================================>] 41,366,110 11.1MB/s in 3.9s

2020-12-02 18:52:26 (10.1 MB/s) - ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’ saved [41366110/41366110]

--2020-12-02 18:52:27-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren7-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 6028362 (5.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’

100%[====================================================================>] 6,028,362 7.39MB/s in 0.8s

2020-12-02 18:52:27 (7.39 MB/s) - ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’ saved [6028362/6028362]

--2020-12-02 18:52:28-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren14-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9120763 (8.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’

100%[====================================================================>] 9,120,763 8.37MB/s in 1.0s

2020-12-02 18:52:29 (8.37 MB/s) - ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’ saved [9120763/9120763]

--2020-12-02 18:52:29-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-wav-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 35362826 (34M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’

100%[====================================================================>] 35,362,826 8.66MB/s in 4.1s

2020-12-02 18:52:33 (8.29 MB/s) - ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’ saved [35362826/35362826]

--2020-12-02 18:52:34-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 18007258 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’

100%[====================================================================>] 18,007,258 9.70MB/s in 1.8s

2020-12-02 18:52:36 (9.70 MB/s) - ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’ saved [18007258/18007258]

--2020-12-02 18:52:37-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-alaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 17464549 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’

100%[====================================================================>] 17,464,549 9.37MB/s in 1.8s

2020-12-02 18:52:39 (9.37 MB/s) - ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’ saved [17464549/17464549]

--2020-12-02 18:52:39-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-gsm-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 4253587 (4.1M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’

100%[====================================================================>] 4,253,587 6.67MB/s in 0.6s

2020-12-02 18:52:40 (6.67 MB/s) - ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’ saved [4253587/4253587]

--2020-12-02 18:52:41-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-ulaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7479839 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’

100%[====================================================================>] 7,479,839 7.98MB/s in 0.9s

2020-12-02 18:52:42 (7.98 MB/s) - ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’ saved [7479839/7479839]

--2020-12-02 18:52:42-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-alaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7496413 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-alaw-2.03.tar.gz’

100%[====================================================================>] 7,496,413 8.03MB/s in 0.9s

2020-12-02 18:52:43 (8.03 MB/s) - ‘asterisk-moh-opsound-alaw-2.03.tar.gz’ saved [7496413/7496413]

--2020-12-02 18:52:43-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-gsm-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1777967 (1.7M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-gsm-2.03.tar.gz’

100%[====================================================================>] 1,777,967 4.09MB/s in 0.4s

2020-12-02 18:52:44 (4.09 MB/s) - ‘asterisk-moh-opsound-gsm-2.03.tar.gz’ saved [1777967/1777967]

make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/sounds'
find rest-api -name "*.json" | while read x; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/rest-api" ; \
done
+---- Asterisk Installation Complete -------+
+ +
+ YOU MUST READ THE SECURITY DOCUMENT +
+ +
+ Asterisk has successfully been installed. +
+ If you would like to install the sample +
+ configuration files (overwriting any +
+ existing config files), run: +
+ +
+ For generic reference documentation: +
+ make samples +
+ +
+ For a sample basic PBX: +
+ make basic-pbx +
+ +
+ +
+----------------- or ---------------------+
+ +
+ You can go ahead and install the asterisk +
+ program documentation now or later run: +
+ +
+ make progdocs +
+ +
+ **Note** This requires that you have +
+ doxygen installed on your local system +
+-------------------------------------------+
</pre>

== Install Program Docs ==

Install the program documentation by running the '''make progdocs''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make progdocs

# Enable DOT
# Set Doxygen PROJECT_NUMBER variable
# Validate and auto-update local copy
Warning: Tag `SYMBOL_CACHE_SIZE' at line 291 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `SHOW_DIRECTORIES' at line 491 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `HTML_ALIGN_MEMBERS' at line 859 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `USE_INLINE_TREES' at line 1044 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"

Configuration file `doc/asterisk-ng-doxygen' updated.

# Run Doxygen
Warning: doxygen no longer ships with the FreeSans font.
You may want to clear or change DOT_FONTNAME.
Otherwise you run the risk that the wrong font is being used for dot generated graphs.
Searching for include files...
Searching for files in directory /usr/local/src/asterisk-18.1.0
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/mp3
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/ooh323c

=== SNIP ===

Patching output file 2546/2550
Patching output file 2547/2550
Patching output file 2548/2550
Patching output file 2549/2550
Patching output file 2550/2550
lookup cache used 65536/65536 hits=1461947 misses=70524
finished...
# Remove configuration backup file
</pre>

== Make the Asterisk 18.1.0 sample configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make samples
Installing adsi config files...
/bin/install -c -d "/etc/asterisk"
Installing configs/samples/asterisk.adsi
Installing configs/samples/telcordia-1.adsi
Installing other config files...
Installing file configs/samples/acl.conf.sample
Installing file configs/samples/adsi.conf.sample
Installing file configs/samples/agents.conf.sample
Installing file configs/samples/alarmreceiver.conf.sample
Installing file configs/samples/alsa.conf.sample
Installing file configs/samples/amd.conf.sample
Installing file configs/samples/app_mysql.conf.sample
Installing file configs/samples/app_skel.conf.sample
Installing file configs/samples/ari.conf.sample
Installing file configs/samples/ast_debug_tools.conf.sample
Installing file configs/samples/asterisk.conf.sample
Installing file configs/samples/calendar.conf.sample
Installing file configs/samples/ccss.conf.sample
Installing file configs/samples/cdr_adaptive_odbc.conf.sample
Installing file configs/samples/cdr_beanstalkd.conf.sample
Installing file configs/samples/cdr.conf.sample
Installing file configs/samples/cdr_custom.conf.sample
Installing file configs/samples/cdr_manager.conf.sample
Installing file configs/samples/cdr_mysql.conf.sample
Installing file configs/samples/cdr_odbc.conf.sample
Installing file configs/samples/cdr_pgsql.conf.sample
Installing file configs/samples/cdr_sqlite3_custom.conf.sample
Installing file configs/samples/cdr_syslog.conf.sample
Installing file configs/samples/cdr_tds.conf.sample
Installing file configs/samples/cel_beanstalkd.conf.sample
Installing file configs/samples/cel.conf.sample
Installing file configs/samples/cel_custom.conf.sample
Installing file configs/samples/cel_odbc.conf.sample
Installing file configs/samples/cel_pgsql.conf.sample
Installing file configs/samples/cel_sqlite3_custom.conf.sample
Installing file configs/samples/cel_tds.conf.sample
Installing file configs/samples/chan_dahdi.conf.sample
Installing file configs/samples/chan_mobile.conf.sample
Installing file configs/samples/cli_aliases.conf.sample
Installing file configs/samples/cli.conf.sample
Installing file configs/samples/cli_permissions.conf.sample
Installing file configs/samples/codecs.conf.sample
Installing file configs/samples/confbridge.conf.sample
Installing file configs/samples/config_test.conf.sample
Installing file configs/samples/console.conf.sample
Installing file configs/samples/dbsep.conf.sample
Installing file configs/samples/dnsmgr.conf.sample
Installing file configs/samples/dsp.conf.sample
Installing file configs/samples/dundi.conf.sample
Installing file configs/samples/enum.conf.sample
Installing file configs/samples/extconfig.conf.sample
Installing file configs/samples/extensions.ael.sample
Installing file configs/samples/extensions.conf.sample
Installing file configs/samples/extensions.lua.sample
Installing file configs/samples/extensions_minivm.conf.sample
Installing file configs/samples/features.conf.sample
Installing file configs/samples/festival.conf.sample
Installing file configs/samples/followme.conf.sample
Installing file configs/samples/func_odbc.conf.sample
Installing file configs/samples/hep.conf.sample
Installing file configs/samples/http.conf.sample
Installing file configs/samples/iax.conf.sample
Installing file configs/samples/iaxprov.conf.sample
Installing file configs/samples/indications.conf.sample
Installing file configs/samples/logger.conf.sample
Installing file configs/samples/manager.conf.sample
Installing file configs/samples/meetme.conf.sample
Installing file configs/samples/mgcp.conf.sample
Installing file configs/samples/minivm.conf.sample
Installing file configs/samples/misdn.conf.sample
Installing file configs/samples/modules.conf.sample
Installing file configs/samples/motif.conf.sample
Installing file configs/samples/musiconhold.conf.sample
Installing file configs/samples/muted.conf.sample
Installing file configs/samples/ooh323.conf.sample
Installing file configs/samples/osp.conf.sample
Installing file configs/samples/oss.conf.sample
Installing file configs/samples/phone.conf.sample
Installing file configs/samples/phoneprov.conf.sample
Installing file configs/samples/pjproject.conf.sample
Installing file configs/samples/pjsip.conf.sample
Installing file configs/samples/pjsip_notify.conf.sample
Installing file configs/samples/pjsip_wizard.conf.sample
Installing file configs/samples/prometheus.conf.sample
Installing file configs/samples/queuerules.conf.sample
Installing file configs/samples/queues.conf.sample
Installing file configs/samples/res_config_mysql.conf.sample
Installing file configs/samples/res_config_sqlite3.conf.sample
Installing file configs/samples/res_config_sqlite.conf.sample
Installing file configs/samples/res_corosync.conf.sample
Installing file configs/samples/res_curl.conf.sample
Installing file configs/samples/res_fax.conf.sample
Installing file configs/samples/res_ldap.conf.sample
Installing file configs/samples/res_odbc.conf.sample
Installing file configs/samples/resolver_unbound.conf.sample
Installing file configs/samples/res_parking.conf.sample
Installing file configs/samples/res_pgsql.conf.sample
Installing file configs/samples/res_pktccops.conf.sample
Installing file configs/samples/res_snmp.conf.sample
Installing file configs/samples/res_stun_monitor.conf.sample
Installing file configs/samples/rtp.conf.sample
Installing file configs/samples/say.conf.sample
Installing file configs/samples/sip.conf.sample
Installing file configs/samples/sip_notify.conf.sample
Installing file configs/samples/skinny.conf.sample
Installing file configs/samples/sla.conf.sample
Installing file configs/samples/smdi.conf.sample
Installing file configs/samples/sorcery.conf.sample
Installing file configs/samples/ss7.timers.sample
Installing file configs/samples/stasis.conf.sample
Installing file configs/samples/statsd.conf.sample
Installing file configs/samples/stir_shaken.conf.sample
Installing file configs/samples/test_sorcery.conf.sample
Installing file configs/samples/udptl.conf.sample
Installing file configs/samples/unistim.conf.sample
Installing file configs/samples/users.conf.sample
Installing file configs/samples/voicemail.conf.sample
Installing file configs/samples/vpb.conf.sample
Installing file configs/samples/xmpp.conf.sample
Updating asterisk.conf
/bin/install -c -d "/var/spool/asterisk/voicemail/default/1234/INBOX"
build_tools/make_sample_voicemail "//var/lib/asterisk" "//var/spool/asterisk"
Installing file phoneprov/000000000000.cfg
Installing file phoneprov/000000000000-directory.xml
Installing file phoneprov/000000000000-phone.cfg
Installing file phoneprov/polycom_line.xml
Installing file phoneprov/polycom.xml
Installing file phoneprov/snom-mac.xml
</pre>

== Make the Asterisk 18.1.0 configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make config
</pre>

== Set ldconfig ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ldconfig
</pre>

== Setup user, group and permissions ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# groupadd asterisk
[root@cn38-inverness-co asterisk-18.1.0]# useradd -r -d /var/lib/asterisk -g asterisk asterisk
[root@cn38-inverness-co asterisk-18.1.0]# usermod -aG audio,dialout asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /etc/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /var/{lib,log,spool}/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /usr/lib/asterisk
</pre>

== Set runtime parameters ==

Need to change things in there.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/sysconfig/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/asterisk/asterisk.conf
</pre>

== Enable and Start Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl enable asterisk

asterisk.service is not a native service, redirecting to /sbin/chkconfig.
Executing /sbin/chkconfig asterisk on

[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl start asterisk

</pre>

== Connect to Asterisk and verify version ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# asterisk -rvv

parse error: No category context for line 1 of /etc/asterisk/asterisk.conf
Unable to open specified master config file '/etc/asterisk/asterisk.conf', using built-in defaults
Asterisk 18.1.0, Copyright (C) 1999 - 2018, Digium, Inc. and others.
Created by Mark Spencer <markster@digium.com>
Asterisk comes with ABSOLUTELY NO WARRANTY; type 'core show warranty' for details.
This is free software, with components licensed under the GNU General Public
License version 2 and other licenses; you are welcome to redistribute it under
certain conditions. Type 'core show license' for details.
=========================================================================
Connected to Asterisk 18.1.0 currently running on cn38-inverness-co (pid = 18370)
cn38-inverness-co*CLI>
Disconnected from Asterisk server
Asterisk cleanly ending (0).
Executing last minute cleanups
</pre>

= Configure Asterisk =

== Version 1.8 to 18.1.0 Errors ==

chan_agent => chan_agent_pool

chan_local => Asterisk core, no loadable module

bridge_multiplexed => ?

app_meetme => Part of DAHDI. Replaced by app_confbridge

Failed to resolve dependencies for func_curl

Failed to resolve dependencies for res_config_curl

Failed to resolve dependencies for app_page

User:Sfiggins/Asterisk 18 on CentOS7

2020-12-04T02:23:56Z

Sfiggins: /* Run ./configure for Asterisk */

= Install and Configure Base OS =

== Install from CentOS 7 CD (Minimal Install) ==

== Log into newly installed server ==

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
sfiggins@cn38-inverness-co.suburbanbroadband.net's password:
</pre>

== Setting up PSK login access, if desired ==

=== Copy authorized_keys from another server ===

I have another server that already has my authorized keys, so I"ll copy it from there. You can also past in your RSA key into '''~/.ssh/authorized_keys''', if you prefer.

<pre>
[sfiggins@cn38-inverness-co ~]$ scp -r 216.112.193.138:.ssh/ .

The authenticity of host '216.112.193.138 (216.112.193.138)' can't be established.
RSA key fingerprint is 5f:61:91:46:5c:c8:4c:a1:2e:25:0b:61:1e:97:d9:ed.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '216.112.193.138' (RSA) to the list of known hosts.
sfiggins@216.112.193.138's password:
known_hosts 100% 397 0.4KB/s 00:00
authorized_keys 100% 414 0.4KB/s 00:00

[sfiggins@cn38-inverness-co ~]$ logout
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

=== Login in using private key ===

<pre>
Seans-MacBook-Pro:~ sfiggins$ ssh cn38-inverness-co.suburbanbroadband.net
Warning: Permanently added 'cn38-inverness-co.suburbanbroadband.net,216.112.193.139' (RSA) to the list of known hosts.
Last login: Wed Dec 2 17:21:54 2020 from 209.116.189.54
</pre>

== Sudo to Root ==

All the installation steps in this guide must be performed as root. You can either prefix each command with '''"sudo"''' or just use sudo to become the '''root''' account and execute them as listed.

<pre>
[sfiggins@cn38-inverness-co ~]$ sudo su -

We trust you have received the usual lecture from the local System
Administrator. It usually boils down to these three things:

#1) Respect the privacy of others.
#2) Think before you type.
#3) With great power comes great responsibility.

[sudo] password for sfiggins:
Last login: Wed Dec 2 16:46:45 MST 2020 on tty1
</pre>

== Fix Sudoers ==

This fix will remove the need to reenter your puser password when running the '''"sudo"''' command. This is a preference, and does not need to be done if you prefer to enter the password each time.

<pre>
[root@cn38-inverness-co ~]# vi /etc/sudoers
</pre>

Comment out the below matching line, by adding '''"# "''' in beginning of the line.

<pre>
%wheel ALL=(ALL) ALL
</pre>

Remove the comment from the below matching line by removing the '''"# "''' from the beginning of the line.

<pre>
# %wheel ALL=(ALL) NOPASSWD: ALL
</pre>

Save this file using the '''":wq!"''' command, as this file is read-only.

== Disable and remove NetworkManager ==

The '''NetworkManager''' packages are not needed on a Linux server and they just get in the way. Removing them is the best option. They are more useful on a workstation that will be changing networks frequently.

<pre>
[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager

rm '/etc/systemd/system/multi-user.target.wants/NetworkManager.service'
rm '/etc/systemd/system/dbus-org.freedesktop.nm-dispatcher.service'
rm '/etc/systemd/system/dbus-org.freedesktop.NetworkManager.service'

[root@cn38-inverness-co ~]# /bin/systemctl disable NetworkManager-dispatcher

[root@cn38-inverness-co ~]# yum erase NetworkManager-tui NetworkManager-glib NetworkManager

Loaded plugins: fastestmirror
No Match for argument: NetworkManager-glib
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
---> Package NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
NetworkManager x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 8.8 M
NetworkManager-tui x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 @anaconda 258 k

Transaction Summary
==============================================================================================================
Remove 2 Packages

Installed size: 9.1 M
Is this ok [y/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Erasing : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2
Verifying : 1:NetworkManager-tui-1.0.0-14.git20150121.b4ea599c.el7.x86_64 1/2
Verifying : 1:NetworkManager-1.0.0-14.git20150121.b4ea599c.el7.x86_64 2/2

Removed:
NetworkManager.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7
NetworkManager-tui.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7

Complete!
</pre>

== Disable SELinux ==

This mostly gets in the way, and we will disable it. There are steps that can be taken to leave this intact and functioning and still allow the system to function propperly, but I'll not discuss that here.

<pre>
[root@cn38-inverness-co ~]# setenforce 0
[root@cn38-inverness-co ~]# sed -i.bak "s/^SELINUX=.*/SELINUX=disabled/g" /etc/selinux/config
</pre>

== Update System Packages ==

Update the system packages. Some of the later steps will require give errors depending on system package levels that are available, and it is just good measure to make sure the latest packages are installed.

<pre>
[root@cn38-inverness-co ~]# yum -y update

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package NetworkManager-libnm.x86_64 1:1.0.0-14.git20150121.b4ea599c.el7 will be updated

=== SNIP ===

---> Package libstdc++.i686 0:4.8.5-44.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:

=== SNIP ===

Updating:

=== SNIP ===

Installing for dependencies:

=== SNIP ===

Transaction Summary
==============================================================================================================
Install 8 Packages (+47 Dependent packages)
Upgrade 240 Packages

Total size: 325 M
Total download size: 275 M
Downloading packages:
Delta RPMs disabled because /usr/bin/applydeltarpm not installed.
(1/230): acl-2.2.51-15.el7.x86_64.rpm | 81 kB 00:00:00

=== SNIP ===

(230/230): tzdata-2020d-2.el7.noarch.rpm | 499 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 17 MB/s | 275 MB 00:00:16
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Updating : libgcc-4.8.5-44.el7.x86_64 1/539
Installing : 1:grub2-common-2.02-0.86.el7.centos.noarch 2/539
Updating : centos-release-7-9.2009.1.el7.centos.x86_64 3/539

=== SNIP ===

Installing : rdma-core-22.4-5.el7.i686 295/539
Cleanup : tuned-2.4.1-1.el7.noarch 296/539

=== SNIP ===

Cleanup : 12:dhclient-4.2.5-36.el7.centos.x86_64 385/539

UPGRADE: Automatically re-enabling default systemd units:
brandbot.path
rhel-autorelabel.service
rhel-autorelabel-mark.service
rhel-configure.service
rhel-dmesg.service
rhel-domainname.service
rhel-import-state.service
rhel-loadmodules.service
rhel-readonly.service

Cleanup : initscripts-9.49.24-1.el7.x86_64 386/539

=== SNIP ===

Cleanup : libgcc-4.8.3-9.el7.x86_64 539/539
Verifying : glibc-common-2.17-317.el7.x86_64 1/539

=== SNIP ===

Verifying : 7:device-mapper-1.02.93-3.el7.x86_64 539/539

Installed:
grub2.x86_64 1:2.02-0.86.el7.centos grub2-tools.x86_64 1:2.02-0.86.el7.centos
grub2-tools-extra.x86_64 1:2.02-0.86.el7.centos grub2-tools-minimal.x86_64 1:2.02-0.86.el7.centos
kernel.x86_64 0:3.10.0-1160.6.1.el7 python-gobject-base.x86_64 0:3.22.0-1.el7_4.1
rdma-core.i686 0:22.4-5.el7 rdma-core.x86_64 0:22.4-5.el7

Dependency Installed:
GeoIP.x86_64 0:1.5.0-14.el7 audit-libs.i686 0:2.8.5-4.el7

=== SNIP ===

zlib.i686 0:1.2.7-18.el7

Updated:
NetworkManager-libnm.x86_64 1:1.18.8-2.el7_9

=== SNIP ===

zlib.x86_64 0:1.2.7-18.el7

Replaced:
grub2.x86_64 1:2.02-0.16.el7.centos grub2-tools.x86_64 1:2.02-0.16.el7.centos
pygobject3-base.x86_64 0:3.8.2-6.el7 rdma.noarch 0:7.1_3.17-5.el7

Complete!
</pre>

== Install Additional Packages ==

These are useful utilities that have been stripped from the base install in CentOS7. Adding these back in allows for easier troubleshooting of the server.

<pre>
[root@cn38-inverness-co ~]# yum -y install finger nc net-snmp net-snmp-perl net-snmp-utils ntp perl-Date-Manip \
perl-DBD-SQLite sssd tcp_wrappers tcpdump telnet tftp tog-pegasus traceroute \
vim-enhanced wget oddjob-mkhomedir net-tools yum-cron bind-utils

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 will be installed
--> Processing Dependency: bind-libs(x86-64) = 32:9.11.4-26.P2.el7_9.2 for package: 32:bind-utils-9.11.4-26.P2.el7_9.2.x86_64

=== SNIP ===

---> Package pcre-devel.x86_64 0:8.32-17.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bind-utils x86_64 32:9.11.4-26.P2.el7_9.2 updates 260 k

=== SNIP ===

yum-cron noarch 3.4.3-168.el7.centos base 66 k
Installing for dependencies:
autogen-libopts x86_64 5.18-5.el7 base 66 k

=== SNIP ===

zlib-devel x86_64 1.2.7-18.el7 base 50 k

Transaction Summary
==============================================================================================================
Install 21 Packages (+114 Dependent packages)

Total size: 59 M
Installed size: 166 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtalloc-2.1.16-1.el7.x86_64 1/135

=== SNIP ===

Installing : finger-0.17-52.el7.x86_64 135/135
Verifying : perl-HTTP-Tiny-0.033-3.el7.noarch 1/135

=== SNIP ===

Verifying : 2:nmap-ncat-6.40-19.el7.x86_64 135/135

Installed:
bind-utils.x86_64 32:9.11.4-26.P2.el7_9.2 finger.x86_64 0:0.17-52.el7
net-snmp.x86_64 1:5.7.2-49.el7 net-snmp-perl.x86_64 1:5.7.2-49.el7
net-snmp-utils.x86_64 1:5.7.2-49.el7 net-tools.x86_64 0:2.0-0.25.20131004git.el7
nmap-ncat.x86_64 2:6.40-19.el7 ntp.x86_64 0:4.2.6p5-29.el7.centos.2
oddjob-mkhomedir.x86_64 0:0.31.5-4.el7 perl-DBD-SQLite.x86_64 0:1.39-3.el7
perl-Date-Manip.noarch 0:6.41-2.el7 sssd.x86_64 0:1.16.5-10.el7_9.5
tcp_wrappers.x86_64 0:7.6-77.el7 tcpdump.x86_64 14:4.9.2-4.el7_7.1
telnet.x86_64 1:0.17-66.el7 tftp.x86_64 0:5.2-22.el7
tog-pegasus.x86_64 2:2.14.1-8.el7 traceroute.x86_64 3:2.0.22-2.el7
vim-enhanced.x86_64 2:7.4.629-7.el7 wget.x86_64 0:1.14-18.el7_6.1
yum-cron.noarch 0:3.4.3-168.el7.centos

Dependency Installed:
autogen-libopts.x86_64 0:5.18-5.el7

=== SNIP ===

zlib-devel.x86_64 0:1.2.7-18.el7

Complete!
</pre>

== Fix Timezone ==

This is just a preference, but it will standardize the timezone.

<pre>
[root@cn38-inverness-co ~]# rm -f /etc/localtime
[root@cn38-inverness-co ~]# ln -s /usr/share/zoneinfo/MST7MDT /etc/localtime
</pre>

== Disable RPF ==

Reverse Path Forwarding (RPF) is a security protection that will prevent inbound packets from entering an IP interface that does not have outbound routes to the source IP. It is not important to disable this if your server only has one interface, however if you have multiple network interfaces, and you may be receiving asymmetric traffic, this needs to be disabled to allow the packets to enter the system.

<pre>
[root@cn38-inverness-co ~]# echo "net.ipv4.conf.default.rp_filter = 0" > /etc/sysctl.d/rpfilter.conf
</pre>

== Install vmtools (if virtual) ==

'''Only do this step if you are installing on a virtual platform. This is not required if you are installing on bare metal.'''

<pre>
[root@cn38-inverness-co ~]# yum -y install open-vm-tools

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package open-vm-tools.x86_64 0:11.0.5-3.el7_9.1 will be installed
--> Processing Dependency: xmlsec1-openssl for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.6)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2(FUSE_2.5)(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: fuse for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxslt.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libxmlsec1.so.1()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libmspack.so.0()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libltdl.so.7()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Processing Dependency: libfuse.so.2()(64bit) for package: open-vm-tools-11.0.5-3.el7_9.1.x86_64
--> Running transaction check
---> Package fuse.x86_64 0:2.9.2-11.el7 will be installed
---> Package fuse-libs.x86_64 0:2.9.2-11.el7 will be installed
---> Package libmspack.x86_64 0:0.5-0.8.alpha.el7 will be installed
---> Package libtool-ltdl.x86_64 0:2.4.2-22.el7_3 will be installed
---> Package libxslt.x86_64 0:1.1.28-6.el7 will be installed
---> Package xmlsec1.x86_64 0:1.2.20-7.el7_4 will be installed
---> Package xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
open-vm-tools x86_64 11.0.5-3.el7_9.1 updates 676 k
Installing for dependencies:
fuse x86_64 2.9.2-11.el7 base 86 k
fuse-libs x86_64 2.9.2-11.el7 base 93 k
libmspack x86_64 0.5-0.8.alpha.el7 base 64 k
libtool-ltdl x86_64 2.4.2-22.el7_3 base 49 k
libxslt x86_64 1.1.28-6.el7 base 242 k
xmlsec1 x86_64 1.2.20-7.el7_4 base 177 k
xmlsec1-openssl x86_64 1.2.20-7.el7_4 base 76 k

Transaction Summary
==============================================================================================================
Install 1 Package (+7 Dependent packages)

Total download size: 1.4 M
Installed size: 4.0 M
Downloading packages:
(1/8): fuse-2.9.2-11.el7.x86_64.rpm | 86 kB 00:00:00
(2/8): fuse-libs-2.9.2-11.el7.x86_64.rpm | 93 kB 00:00:00
(3/8): libtool-ltdl-2.4.2-22.el7_3.x86_64.rpm | 49 kB 00:00:00
(4/8): libmspack-0.5-0.8.alpha.el7.x86_64.rpm | 64 kB 00:00:00
(5/8): xmlsec1-1.2.20-7.el7_4.x86_64.rpm | 177 kB 00:00:00
(6/8): libxslt-1.1.28-6.el7.x86_64.rpm | 242 kB 00:00:00
(7/8): xmlsec1-openssl-1.2.20-7.el7_4.x86_64.rpm | 76 kB 00:00:00
(8/8): open-vm-tools-11.0.5-3.el7_9.1.x86_64.rpm | 676 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.4 MB/s | 1.4 MB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libtool-ltdl-2.4.2-22.el7_3.x86_64 1/8
Installing : libxslt-1.1.28-6.el7.x86_64 2/8
Installing : xmlsec1-1.2.20-7.el7_4.x86_64 3/8
Installing : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Installing : fuse-2.9.2-11.el7.x86_64 5/8
Installing : fuse-libs-2.9.2-11.el7.x86_64 6/8
Installing : libmspack-0.5-0.8.alpha.el7.x86_64 7/8
Installing : open-vm-tools-11.0.5-3.el7_9.1.x86_64 8/8
Verifying : libmspack-0.5-0.8.alpha.el7.x86_64 1/8
Verifying : fuse-libs-2.9.2-11.el7.x86_64 2/8
Verifying : fuse-2.9.2-11.el7.x86_64 3/8
Verifying : xmlsec1-openssl-1.2.20-7.el7_4.x86_64 4/8
Verifying : libxslt-1.1.28-6.el7.x86_64 5/8
Verifying : xmlsec1-1.2.20-7.el7_4.x86_64 6/8
Verifying : open-vm-tools-11.0.5-3.el7_9.1.x86_64 7/8
Verifying : libtool-ltdl-2.4.2-22.el7_3.x86_64 8/8

Installed:
open-vm-tools.x86_64 0:11.0.5-3.el7_9.1

Dependency Installed:
fuse.x86_64 0:2.9.2-11.el7 fuse-libs.x86_64 0:2.9.2-11.el7
libmspack.x86_64 0:0.5-0.8.alpha.el7 libtool-ltdl.x86_64 0:2.4.2-22.el7_3
libxslt.x86_64 0:1.1.28-6.el7 xmlsec1.x86_64 0:1.2.20-7.el7_4
xmlsec1-openssl.x86_64 0:1.2.20-7.el7_4

Complete!
</pre>

== Reboot Server ==

<pre>
[root@cn38-inverness-co ~]# shutdown -r now
Connection to cn38-inverness-co.suburbanbroadband.net closed by remote host.
Connection to cn38-inverness-co.suburbanbroadband.net closed.
</pre>

== Remove old kernel ==

<pre>
[root@cn38-inverness-co ~]# rpm -qa | grep kernel

kernel-tools-libs-3.10.0-1160.6.1.el7.x86_64
kernel-headers-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-1160.6.1.el7.x86_64
kernel-3.10.0-229.el7.x86_64
kernel-tools-3.10.0-1160.6.1.el7.x86_64

[root@cn38-inverness-co ~]# yum -y erase kernel-3.10.0-229.el7.x86_64

Loaded plugins: fastestmirror
Resolving Dependencies
--> Running transaction check
---> Package kernel.x86_64 0:3.10.0-229.el7 will be erased
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Removing:
kernel x86_64 3.10.0-229.el7 @anaconda 131 M

Transaction Summary
==============================================================================================================
Remove 1 Package

Installed size: 131 M
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Erasing : kernel-3.10.0-229.el7.x86_64 1/1
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.softdep: remove failed: No such file or directory
warning: file /lib/modules/3.10.0-229.el7.x86_64/modules.devname: remove failed: No such file or directory
Verifying : kernel-3.10.0-229.el7.x86_64 1/1

Removed:
kernel.x86_64 0:3.10.0-229.el7

Complete!
</pre>

= Download and Compile Asterisk 18.1.0 =

== Install Development Packages ==

We will be compiling Asterisk from source, so we will need to install some development tools. There may be some duplicates int he list that have already been installed earlier.

<pre>
[root@cn38-inverness-co ~]# yum -y install gcc ncurses-devel openssl-devel gcc-c++ gnutls-devel \
make wget openssh openssh-clients openssh-server ntp sendmail rsync ftp mysql mysql-server \
mysql-devel curl curl-devel traceroute telnet which rpm-build flex gcc newt-devel libusb-devel \
net-snmp-utils bison byacc libxml2-devel vixie-cron mailx xinetd tcpdump

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Package gcc-4.8.5-44.el7.x86_64 already installed and latest version

=== SNIP ===

Package 1:net-snmp-utils-5.7.2-49.el7.x86_64 already installed and latest version
No package vixie-cron available.
Package 14:tcpdump-4.9.2-4.el7_7.1.x86_64 already installed and latest version
Resolving Dependencies
--> Running transaction check
---> Package bison.x86_64 0:3.0.4-2.el7 will be installed

=== SNIP ===

---> Package libevent.x86_64 0:2.0.21-4.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
bison x86_64 3.0.4-2.el7 base 674 k

=== SNIP ===

xinetd x86_64 2:2.3.15-14.el7 base 128 k
Installing for dependencies:
bzip2 x86_64 1.0.6-13.el7 base 52 k

=== SNIP ===

zip x86_64 3.0-11.el7 base 260 k

Transaction Summary
==============================================================================================================
Install 18 Packages (+27 Dependent packages)

Total download size: 30 M
Installed size: 110 M
Downloading packages:
(1/45): byacc-1.9.20130304-3.el7.x86_64.rpm | 65 kB 00:00:00

=== SNIP ===

(45/45): zip-3.0-11.el7.x86_64.rpm | 260 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 13 MB/s | 30 MB 00:00:02
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : m4-1.4.16-10.el7.x86_64 1/45

=== SNIP ===

Installing : 2:xinetd-2.3.15-14.el7.x86_64 45/45
Verifying : gcc-c++-4.8.5-44.el7.x86_64 1/45

=== SNIP ===

Verifying : gnutls-devel-3.3.29-9.el7_6.x86_64 45/45

Installed:
bison.x86_64 0:3.0.4-2.el7 byacc.x86_64 0:1.9.20130304-3.el7
flex.x86_64 0:2.5.37-6.el7 ftp.x86_64 0:0.17-67.el7
gcc-c++.x86_64 0:4.8.5-44.el7 gnutls-devel.x86_64 0:3.3.29-9.el7_6
libcurl-devel.x86_64 0:7.29.0-59.el7_9.1 libusb-devel.x86_64 1:0.1.4-3.el7
libxml2-devel.x86_64 0:2.9.1-6.el7.5 mailx.x86_64 0:12.5-19.el7
mariadb.x86_64 1:5.5.68-1.el7 mariadb-devel.x86_64 1:5.5.68-1.el7
ncurses-devel.x86_64 0:5.9-14.20130511.el7_4 newt-devel.x86_64 0:0.52.15-4.el7
rpm-build.x86_64 0:4.11.3-45.el7 rsync.x86_64 0:3.1.2-10.el7
sendmail.x86_64 0:8.14.7-6.el7 xinetd.x86_64 2:2.3.15-14.el7

Dependency Installed:
bzip2.x86_64 0:1.0.6-13.el7 cyrus-sasl.x86_64 0:2.1.26-23.el7
dwz.x86_64 0:0.11-3.el7 elfutils.x86_64 0:0.176-5.el7
gdb.x86_64 0:7.6.1-120.el7 gmp-devel.x86_64 1:6.0.0-15.el7
gnutls-c++.x86_64 0:3.3.29-9.el7_6 gnutls-dane.x86_64 0:3.3.29-9.el7_6
hesiod.x86_64 0:3.2.1-3.el7 libevent.x86_64 0:2.0.21-4.el7
libstdc++-devel.x86_64 0:4.8.5-44.el7 libtasn1-devel.x86_64 0:4.10-1.el7
libusb.x86_64 1:0.1.4-3.el7 libusbx.x86_64 0:1.0.21-1.el7
m4.x86_64 0:1.4.16-10.el7 nettle-devel.x86_64 0:2.7.1-8.el7
p11-kit-devel.x86_64 0:0.23.5-3.el7 patch.x86_64 0:2.7.1-12.el7_7
perl-Thread-Queue.noarch 0:3.02-2.el7 perl-srpm-macros.noarch 0:1-8.el7
procmail.x86_64 0:3.22-36.el7_4.1 python-srpm-macros.noarch 0:3-34.el7
redhat-rpm-config.noarch 0:9.1.0-88.el7.centos slang-devel.x86_64 0:2.2.4-11.el7
unbound-libs.x86_64 0:1.6.6-5.el7_8 unzip.x86_64 0:6.0-21.el7
zip.x86_64 0:3.0-11.el7

Complete!
== Generate RSA Key ==

<pre>
[root@cn38-inverness-co ~]# ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Created directory '/root/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:FKpB44T5QoKCZtkOoU4ZF6w7T0G98QZ60gHU9QpQM9k root@cn38-inverness-co.suburbanbroadband.net
The key's randomart image is:
+---[RSA 2048]----+
|oo*OX++.. |
|*=BB.OoE.. |
|===.=.B .. |
|o..=.*.+. |
| ...= ..S |
| o . |
| + |
| . |
| |
+----[SHA256]-----+

</pre>

== Download Asterisk 18.1.0 ==

Change directory to /usr/local/src and download the Asterisk source code.

<pre>
[root@cn38-inverness-co ~]# cd /usr/local/src/

[root@cn38-inverness-co src]# wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz

--2020-12-02 17:39:25-- https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 27886299 (27M) [application/x-gzip]
Saving to: ‘asterisk-18-current.tar.gz’

100%[====================================================================>] 27,886,299 8.03MB/s in 3.3s

2020-12-02 17:39:29 (8.03 MB/s) - ‘asterisk-18-current.tar.gz’ saved [27886299/27886299]
</pre>

For future reference, you can also find it directly here:

[https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18.1.0.tar.gz]

== Uncompress Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co src]# tar -zxf asterisk-18-current.tar.gz

[root@cn38-inverness-co src]# ls
asterisk-18.1.0

[root@cn38-inverness-co src]# cd asterisk-18.1.0/

[root@cn38-inverness-co asterisk-18.1.0]# ls
addons channels include README-SERIOUSLY.bestpractices.md
agi codecs install-sh res
apps config.guess LICENSE rest-api
asterisk-18.1.0-summary.html configs main rest-api-templates
asterisk-18.1.0-summary.txt config.sub Makefile sample.call
autoconf configure Makefile.moddir_rules sounds
bootstrap.sh configure.ac Makefile.rules static-http
bridges contrib makeopts.in tests
BSDmakefile COPYING menuselect third-party
BUGS CREDITS missing UPGRADE.txt
build_tools default.exports mkinstalldirs utils
cdr doc pbx Zaptel-to-DAHDI.txt
cel formats phoneprov
ChangeLog funcs README-addons.txt
CHANGES images README.md

</pre>

== Test the prereqs ==

Run the '''"./contrib/scripts/install_prereq test"''' command in order to test the installed prerequesits. After it returns the things that need to be installed, you can just copy and paste that command. If there are packages that are not installed afterthe command due to not existing in the CentOS 7 main repo, they are probably not required.

<pre>

[root@cn38-inverness-co asterisk-18.1.0]# ./contrib/scripts/install_prereq test

#############################################
## test: test mode.
## Use the commands here to install your system.
#############################################
yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

[root@cn38-inverness-co asterisk-18.1.0]# yum install --skip-broken --assumeyes libedit-devel jansson-devel \
libuuid-devel sqlite-devel speex-devel speexdsp-devel libogg-devel libvorbis-devel alsa-lib-devel \
portaudio-devel xmlstarlet postgresql-devel unixODBC-devel neon-devel gmime-devel lua-devel uriparser-devel \
libxslt-devel mysql-devel bluez-libs-devel radcli-devel freetds-devel jack-audio-connection-kit-devel \
libcap-devel iksemel-devel corosynclib-devel libical-devel spandsp-devel libresample-devel uw-imap-devel \
binutils-devel libsrtp-devel gsm-devel doxygen graphviz openldap-devel hoard codec2-devel fftw-devel \
libsndfile-devel unbound-devel subversion

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
No package speexdsp-devel available.
No package portaudio-devel available.
No package xmlstarlet available.
No package gmime-devel available.
Package 1:mariadb-devel-5.5.68-1.el7.x86_64 already installed and latest version
No package radcli-devel available.
No package freetds-devel available.
No package jack-audio-connection-kit-devel available.
No package iksemel-devel available.
No package spandsp-devel available.
No package libresample-devel available.
No package uw-imap-devel available.
No package hoard available.
No package codec2-devel available.
Resolving Dependencies
--> Running transaction check
---> Package alsa-lib-devel.x86_64 0:1.1.8-1.el7 will be installed

=== SNIP ===

---> Package mesa-libglapi.x86_64 0:18.3.4-12.el7_9 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
alsa-lib-devel x86_64 1.1.8-1.el7 base 963 k

=== SNIP ===

uriparser-devel x86_64 0.7.5-10.el7 base 138 k
Installing for dependencies:
adobe-mappings-cmap noarch 20171205-3.el7 base 2.1 M

=== SNIP ===

xorg-x11-server-utils x86_64 7.7-20.el7 base 178 k

Transaction Summary
==============================================================================================================
Install 28 Packages (+117 Dependent packages)

Total download size: 56 M
Installed size: 216 M
Downloading packages:
(1/145): adobe-mappings-cmap-deprecated-20171205-3.el7.noarch.rpm | 114 kB 00:00:00

=== SNIP ===

(145/145): xorg-x11-server-utils-7.7-20.el7.x86_64.rpm | 178 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 9.3 MB/s | 56 MB 00:00:06
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libjpeg-turbo-1.2.90-8.el7.x86_64 1/145

=== SNIP ===

Installing : libedit-devel-3.0-12.20121213cvs.el7.x86_64 145/145
Verifying : libXext-1.3.3-3.el7.x86_64 1/145

=== SNIP ===

Verifying : libcgroup-0.41-21.el7.x86_64 145/145

Installed:
alsa-lib-devel.x86_64 0:1.1.8-1.el7 binutils-devel.x86_64 0:2.27-44.base.el7

=== SNIP ===

Dependency Installed:
adobe-mappings-cmap.noarch 0:20171205-3.el7

=== SNIP ===

Complete!
</pre>

== Run ./configure for Asterisk ==

For CentOS 7.X, you will get an error about needing a newer version of jansson library. It may be possible to manually install the newer version, however it is probaly fine to just use the '''--with-jansson-bundled''' flag to include the version bundled with Asterisk source code.

In addition, we will want to load the bundled pjsip channel drivers, with the '''--with-pjproject-pundled'''.

Hopefully this completed without any issues, however you should look over the output to ensure it is what you are expecting.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ./configure --with-jansson-bundled --with-pjproject-bundled

checking build system type... x86_64-pc-linux-gnu

=== SNIP ===

checking for pkg-config... /bin/pkg-config
checking pkg-config is at least version 0.9.0... yes
checking for GTK2... no
configure: creating ./config.status
config.status: creating makeopts
config.status: creating autoconfig.h
configure: Menuselect build configuration successfully completed

.$$$$$$$$$$$$$$$=..
.$7$7.. .7$$7:.
.$$:. ,$7.7
.$7. 7$$$$ .$$77
..$$. $$$$$ .$$$7
..7$ .?. $$$$$ .?. 7$$$.
$.$. .$$$7. $$$$7 .7$$$. .$$$.
.777. .$$$$$$77$$$77$$$$$7. $$$,
$$$~ .7$$$$$$$$$$$$$7. .$$$.
.$$7 .7$$$$$$$7: ?$$$.
$$$ ?7$$$$$$$$$$I .$$$7
$$$ .7$$$$$$$$$$$$$$$$ :$$$.
$$$ $$$$$$7$$$$$$$$$$$$ .$$$.
$$$ $$$ 7$$$7 .$$$ .$$$.
$$$$ $$$$7 .$$$.
7$$$7 7$$$$ 7$$$
$$$$$ $$$
$$$$7. $$ (TM)
$$$$$$$. .7$$$$$$ $$
$$$$$$$$$$$$7$$$$$$$$$.$$$$$$
$$$$$$$$$$$$$$$$.

configure: Package configured for:
configure: OS type : linux-gnu
configure: Host CPU : x86_64
configure: build-cpu:vendor:os: x86_64 : pc : linux-gnu :
configure: host-cpu:vendor:os: x86_64 : pc : linux-gnu :

</pre>

== Install UW-IMAP library for IMAP integration for Voice Mails ==

We will want to configure Asterisk to store voicemails via IMAP instead of the local file system. This will allow better deployment of HA down the road.

=== Download uw-imap for storage ===

The UW-IMAP code is no longer maintained after the creator's death, so it's a good idea to archive the important parts.

<pre>
[root@cn38-inverness-co ~]# wget https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/u/uw-imap-2007f-16.el7.x86_64.rpm

--2020-12-02 18:34:30-- https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/u/uw-imap-2007f-16.el7.x86_64.rpm
Resolving download-ib01.fedoraproject.org (download-ib01.fedoraproject.org)... 152.19.134.145, 2610:28:3090:3001:dead:beef:cafe:fed6
Connecting to download-ib01.fedoraproject.org (download-ib01.fedoraproject.org)|152.19.134.145|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 68284 (67K) [application/x-rpm]
Saving to: ‘uw-imap-2007f-16.el7.x86_64.rpm’

100%[====================================================================>] 68,284 --.-K/s in 0.09s

2020-12-02 18:34:31 (703 KB/s) - ‘uw-imap-2007f-16.el7.x86_64.rpm’ saved [68284/68284]
</pre>

=== Install EPEL repo ===

We'll use EPEL to install UW-IMAP, so we have to install that first. After installation, we can go back in and disable teh EPEL repo, if we desire.

<pre>

[root@cn38-inverness-co ~]# yum -y install epel-release

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirror.dal10.us.leaseweb.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
Resolving Dependencies
--> Running transaction check
---> Package epel-release.noarch 0:7-11 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
epel-release noarch 7-11 extras 15 k

Transaction Summary
==============================================================================================================
Install 1 Package

Total download size: 15 k
Installed size: 24 k
Downloading packages:
epel-release-7-11.noarch.rpm | 15 kB 00:00:00
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : epel-release-7-11.noarch 1/1
Verifying : epel-release-7-11.noarch 1/1

Installed:
epel-release.noarch 0:7-11

Complete!

</pre>

=== Install uw-imap ===

Finally, the install of UW-IMAP. It will require an additional dependency be installed.

<pre>
[root@cn38-inverness-co ~]# yum install uw-imap

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
epel/x86_64/metalink | 13 kB 00:00:00
* base: mirror.dal10.us.leaseweb.net
* epel: mirror.dal.nexril.net
* extras: mirrors.tummy.com
* updates: mirror.centos.iad1.serverforge.org
epel | 4.7 kB 00:00:00
(1/3): epel/x86_64/group_gz | 95 kB 00:00:00
(2/3): epel/x86_64/updateinfo | 1.0 MB 00:00:00
(3/3): epel/x86_64/primary_db | 6.9 MB 00:00:00
Resolving Dependencies
--> Running transaction check
---> Package uw-imap.x86_64 0:2007f-16.el7 will be installed
--> Processing Dependency: libc-client(x86-64) = 2007f-16.el7 for package: uw-imap-2007f-16.el7.x86_64
--> Processing Dependency: libc-client.so.2007()(64bit) for package: uw-imap-2007f-16.el7.x86_64
--> Running transaction check
---> Package libc-client.x86_64 0:2007f-16.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

==============================================================================================================
Package Arch Version Repository Size
==============================================================================================================
Installing:
uw-imap x86_64 2007f-16.el7 epel 67 k
Installing for dependencies:
libc-client x86_64 2007f-16.el7 epel 562 k

Transaction Summary
==============================================================================================================
Install 1 Package (+1 Dependent package)

Total download size: 628 k
Installed size: 1.6 M
Is this ok [y/d/N]: y
Downloading packages:
warning: /var/cache/yum/x86_64/7/epel/packages/libc-client-2007f-16.el7.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 352c64e5: NOKEY
Public key for libc-client-2007f-16.el7.x86_64.rpm is not installed
(1/2): libc-client-2007f-16.el7.x86_64.rpm | 562 kB 00:00:00
(2/2): uw-imap-2007f-16.el7.x86_64.rpm | 67 kB 00:00:00
--------------------------------------------------------------------------------------------------------------
Total 1.0 MB/s | 628 kB 00:00:00
Retrieving key from file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Importing GPG key 0x352C64E5:
Userid : "Fedora EPEL (7) <epel@fedoraproject.org>"
Fingerprint: 91e9 7d7c 4a5e 96f1 7f3e 888f 6a2f aea2 352c 64e5
Package : epel-release-7-11.noarch (@extras)
From : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
Is this ok [y/N]: y
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : libc-client-2007f-16.el7.x86_64 1/2
Installing : uw-imap-2007f-16.el7.x86_64 2/2
Verifying : libc-client-2007f-16.el7.x86_64 1/2
Verifying : uw-imap-2007f-16.el7.x86_64 2/2

Installed:
uw-imap.x86_64 0:2007f-16.el7

Dependency Installed:
libc-client.x86_64 0:2007f-16.el7

Complete!

</pre>

== make menuselect ==

By default, a lot of options are not included in the Asterisk build, and need to be configured. This is done by running the '''"make menu"''' command in the asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make menuselect

CC="cc" CXX="g++" LD="" AR="" RANLIB="" CFLAGS="" LDFLAGS="" make -C menuselect CONFIGURE_SILENT="--silent" gmenuselect
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Nothing to be done for `gmenuselect'.
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/menuselect'
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0'
menuselect changes saved!
make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0'

</pre>

In '''Add-ons''', select '''chan_ooh323''', '''format_mp3''', '''res_config_mysql''', '''app_mysql''' and '''crd_mysql'''.

[[File:Asterisk1810-Add-ons.png|none|frame|Add-ons]]

In '''Core Sound Packages''', select '''EN-WAV''', '''EN-ULAW''', '''EN-ALAW''', '''EN-GSM''', '''EN-G729''', '''EN-G722''', '''EN-SLN16''', '''EN-SIREN7''', and '''EN-SIREN14'''.

[[File:Asterisk1810-coresound.png|none|frame|Core Sound Packages]]

In '''Music On Hold File Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-musiconhold.png|none|frame|Music On Hold File Packages]]

In '''Extras Sound Packages''', select '''WAV''', '''ULAW''', '''ALAW''', '''GSM'''.

[[File:Asterisk1810-extrasound.png|none|frame|Extras Sound Packages]]

In '''Applications''', select '''app_voicemail''', '''app_voicemail_imap''', '''app_voicemail_odbc''', '''app_macro'''.

[[File:Asterisk1810-applications1.png|none|frame|Applications Voicemail]]
[[File:Asterisk1810-applications2.png|none|frame|Applications Macro]]

== Download MP3 sources ==

Download the required MP3 sources by running the '''contrib/scripts/get_mp3_source.sh''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# contrib/scripts/get_mp3_source.sh

A addons/mp3
A addons/mp3/MPGLIB_TODO
A addons/mp3/mpg123.h
A addons/mp3/layer3.c
A addons/mp3/mpglib.h
A addons/mp3/decode_ntom.c
A addons/mp3/interface.c
A addons/mp3/MPGLIB_README
A addons/mp3/common.c
A addons/mp3/huffman.h
A addons/mp3/tabinit.c
A addons/mp3/Makefile
A addons/mp3/README
A addons/mp3/decode_i386.c
A addons/mp3/dct64_i386.c
Exported revision 202.
</pre>

== Compile Asterisk 18.1.0 ==

We compile the Asterisk code by running the '''make''' command inside the build directory. This should compile at this point, but if there are any errors, additional changes to the system may be required. ''The output below is shortened for space.''

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make

[CC] astcanary.c -> astcanary.o
[LD] astcanary.o -> astcanary
[CC] astdb2sqlite3.c -> astdb2sqlite3.o
[CC] hash/hash.c -> hash/hash.o
[CC] hash/hash_bigkey.c -> hash/hash_bigkey.o
[CC] hash/hash_buf.c -> hash/hash_buf.o
[CC] hash/hash_func.c -> hash/hash_func.o
[CC] hash/hash_log2.c -> hash/hash_log2.o
[CC] hash/hash_page.c -> hash/hash_page.o

=== SNIP ===

[LD] chan_ooh323.o ooh323c/src/ooCmdChannel.o ooh323c/src/ooLogChan.o ooh323c/src/ooUtils.o ooh323c/src/ooGkClient.o ooh323c/src/context.o ooh323c/src/ooDateTime.o ooh323c/src/decode.o ooh323c/src/dlist.o ooh323c/src/encode.o ooh323c/src/errmgmt.o ooh323c/src/memheap.o ooh323c/src/ootrace.o ooh323c/src/oochannels.o ooh323c/src/ooh245.o ooh323c/src/ooports.o ooh323c/src/ooq931.o ooh323c/src/ooCapability.o ooh323c/src/ooSocket.o ooh323c/src/perutil.o ooh323c/src/eventHandler.o ooh323c/src/ooCalls.o ooh323c/src/ooStackCmds.o ooh323c/src/ooh323.o ooh323c/src/ooh323ep.o ooh323c/src/printHandler.o ooh323c/src/rtctype.o ooh323c/src/ooTimer.o ooh323c/src/h323/H235-SECURITY-MESSAGESDec.o ooh323c/src/h323/H235-SECURITY-MESSAGESEnc.o ooh323c/src/h323/H323-MESSAGES.o ooh323c/src/h323/H323-MESSAGESDec.o ooh323c/src/h323/H323-MESSAGESEnc.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROL.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLDec.o ooh323c/src/h323/MULTIMEDIA-SYSTEM-CONTROLEnc.o ooh323cDriver.o -> chan_ooh323.so
[CC] format_mp3.c -> format_mp3.o
[CC] mp3/common.c -> mp3/common.o
[CC] mp3/dct64_i386.c -> mp3/dct64_i386.o
[CC] mp3/decode_ntom.c -> mp3/decode_ntom.o
[CC] mp3/layer3.c -> mp3/layer3.o
[CC] mp3/tabinit.c -> mp3/tabinit.o
[CC] mp3/interface.c -> mp3/interface.o
[LD] format_mp3.o mp3/common.o mp3/dct64_i386.o mp3/decode_ntom.o mp3/layer3.o mp3/tabinit.o mp3/interface.o -> format_mp3.so
[CC] res_config_mysql.c -> res_config_mysql.o
[LD] res_config_mysql.o -> res_config_mysql.so
Building Documentation For: third-party channels pbx apps codecs formats cdr cel bridges funcs tests main res addons
+--------- Asterisk Build Complete ---------+
+ Asterisk has successfully been built, and +
+ can be installed by running: +
+ +
+ make install +
+-------------------------------------------+
</pre>

== Install for Asterisk 18.1.0 ==

We install Asterisk by running the '''make install''' command in the Asterisk build directory.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make install
Installing modules from channels...
Installing modules from pbx...
Installing modules from apps...
Installing modules from codecs...
Installing modules from formats...
Installing modules from cdr...
Installing modules from cel...
Installing modules from bridges...
Installing modules from funcs...
Installing modules from tests...
Installing modules from main...
Installing modules from res...
Installing modules from addons...
/bin/install -c -m 755 contrib/scripts/astversion "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/astgenkey "/usr/sbin/"
/bin/install -c -m 755 contrib/scripts/autosupport "/usr/sbin/"
if [ ! -f /sbin/launchd ]; then \
./build_tools/install_subst contrib/scripts/safe_asterisk "/usr/sbin/safe_asterisk"; \
fi
/bin/install -c -m 644 doc/core-*.xml "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/appdocsxml.dtd "/var/lib/asterisk/documentation"
/bin/install -c -m 644 doc/asterisk.8 "/usr/share/man/man8"
/bin/install -c -m 644 doc/astdb*.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/astgenkey.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/autosupport.8 "/usr/share/man/man8"
/bin/install -c -m 644 contrib/scripts/safe_asterisk.8 "/usr/share/man/man8"
if [ -f contrib/firmware/iax/iaxy.bin ] ; then \
/bin/install -c -m 644 contrib/firmware/iax/iaxy.bin "/var/lib/asterisk/firmware/iax/iaxy.bin"; \
fi
CFLAGS=" -I/usr/include/libxml2 -pipe -Wall -Wstrict-prototypes -Wmissing-prototypes -Wmissing-declarations -g3 " build_tools/mkpkgconfig "/usr/lib/pkgconfig";
find static-http | while read x; do \
if test -d $x; then \
/bin/install -c -m 755 -d "/var/lib/asterisk/$x"; \
else \
/bin/install -c -m 644 $x "/var/lib/asterisk/$x" ; \
fi \
done
/bin/install -c -m 644 doc/core-en_US.xml "/var/lib/asterisk/static-http";
/bin/install -c -m 644 doc/appdocsxml.xslt "/var/lib/asterisk/static-http";
if [ -d doc/tex/asterisk ] ; then \
/bin/install -c -d "/var/lib/asterisk/static-http/docs" ; \
for n in doc/tex/asterisk/* ; do \
/bin/install -c -m 644 $n "/var/lib/asterisk/static-http/docs" ; \
done \
fi
for x in images/*.jpg; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/images" ; \
done
make -C sounds install
make[1]: Entering directory `/usr/local/src/asterisk-18.1.0/sounds'
--2020-12-02 18:52:05-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-wav-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 20176188 (19M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’

100%[====================================================================>] 20,176,188 7.79MB/s in 2.5s

2020-12-02 18:52:08 (7.79 MB/s) - ‘asterisk-core-sounds-en-wav-1.6.1.tar.gz’ saved [20176188/20176188]

--2020-12-02 18:52:09-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-ulaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10241447 (9.8M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’

100%[====================================================================>] 10,241,447 1.71MB/s in 6.4s

2020-12-02 18:52:15 (1.52 MB/s) - ‘asterisk-core-sounds-en-ulaw-1.6.1.tar.gz’ saved [10241447/10241447]

--2020-12-02 18:52:16-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-alaw-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9937284 (9.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’

100%[====================================================================>] 9,937,284 3.40MB/s in 2.8s

2020-12-02 18:52:18 (3.40 MB/s) - ‘asterisk-core-sounds-en-alaw-1.6.1.tar.gz’ saved [9937284/9937284]

--2020-12-02 18:52:19-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g729-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1557751 (1.5M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’

100%[====================================================================>] 1,557,751 2.78MB/s in 0.5s

2020-12-02 18:52:20 (2.78 MB/s) - ‘asterisk-core-sounds-en-g729-1.6.1.tar.gz’ saved [1557751/1557751]

--2020-12-02 18:52:20-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-g722-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 10756090 (10M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’

100%[====================================================================>] 10,756,090 6.58MB/s in 1.6s

2020-12-02 18:52:21 (6.58 MB/s) - ‘asterisk-core-sounds-en-g722-1.6.1.tar.gz’ saved [10756090/10756090]

--2020-12-02 18:52:22-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-sln16-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 41366110 (39M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’

100%[====================================================================>] 41,366,110 11.1MB/s in 3.9s

2020-12-02 18:52:26 (10.1 MB/s) - ‘asterisk-core-sounds-en-sln16-1.6.1.tar.gz’ saved [41366110/41366110]

--2020-12-02 18:52:27-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren7-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 6028362 (5.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’

100%[====================================================================>] 6,028,362 7.39MB/s in 0.8s

2020-12-02 18:52:27 (7.39 MB/s) - ‘asterisk-core-sounds-en-siren7-1.6.1.tar.gz’ saved [6028362/6028362]

--2020-12-02 18:52:28-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-core-sounds-en-siren14-1.6.1.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 9120763 (8.7M) [application/x-gzip]
Saving to: ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’

100%[====================================================================>] 9,120,763 8.37MB/s in 1.0s

2020-12-02 18:52:29 (8.37 MB/s) - ‘asterisk-core-sounds-en-siren14-1.6.1.tar.gz’ saved [9120763/9120763]

--2020-12-02 18:52:29-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-wav-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 35362826 (34M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’

100%[====================================================================>] 35,362,826 8.66MB/s in 4.1s

2020-12-02 18:52:33 (8.29 MB/s) - ‘asterisk-extra-sounds-en-wav-1.5.2.tar.gz’ saved [35362826/35362826]

--2020-12-02 18:52:34-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 18007258 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’

100%[====================================================================>] 18,007,258 9.70MB/s in 1.8s

2020-12-02 18:52:36 (9.70 MB/s) - ‘asterisk-extra-sounds-en-ulaw-1.5.2.tar.gz’ saved [18007258/18007258]

--2020-12-02 18:52:37-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-alaw-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 17464549 (17M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’

100%[====================================================================>] 17,464,549 9.37MB/s in 1.8s

2020-12-02 18:52:39 (9.37 MB/s) - ‘asterisk-extra-sounds-en-alaw-1.5.2.tar.gz’ saved [17464549/17464549]

--2020-12-02 18:52:39-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-extra-sounds-en-gsm-1.5.2.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 4253587 (4.1M) [application/x-gzip]
Saving to: ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’

100%[====================================================================>] 4,253,587 6.67MB/s in 0.6s

2020-12-02 18:52:40 (6.67 MB/s) - ‘asterisk-extra-sounds-en-gsm-1.5.2.tar.gz’ saved [4253587/4253587]

--2020-12-02 18:52:41-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-ulaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7479839 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’

100%[====================================================================>] 7,479,839 7.98MB/s in 0.9s

2020-12-02 18:52:42 (7.98 MB/s) - ‘asterisk-moh-opsound-ulaw-2.03.tar.gz’ saved [7479839/7479839]

--2020-12-02 18:52:42-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-alaw-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7496413 (7.1M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-alaw-2.03.tar.gz’

100%[====================================================================>] 7,496,413 8.03MB/s in 0.9s

2020-12-02 18:52:43 (8.03 MB/s) - ‘asterisk-moh-opsound-alaw-2.03.tar.gz’ saved [7496413/7496413]

--2020-12-02 18:52:43-- http://downloads.asterisk.org/pub/telephony/sounds/releases/asterisk-moh-opsound-gsm-2.03.tar.gz
Resolving downloads.asterisk.org (downloads.asterisk.org)... 76.164.171.238, 2001:470:e0d4::ee
Connecting to downloads.asterisk.org (downloads.asterisk.org)|76.164.171.238|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1777967 (1.7M) [application/x-gzip]
Saving to: ‘asterisk-moh-opsound-gsm-2.03.tar.gz’

100%[====================================================================>] 1,777,967 4.09MB/s in 0.4s

2020-12-02 18:52:44 (4.09 MB/s) - ‘asterisk-moh-opsound-gsm-2.03.tar.gz’ saved [1777967/1777967]

make[1]: Leaving directory `/usr/local/src/asterisk-18.1.0/sounds'
find rest-api -name "*.json" | while read x; do \
/bin/install -c -m 644 $x "/var/lib/asterisk/rest-api" ; \
done
+---- Asterisk Installation Complete -------+
+ +
+ YOU MUST READ THE SECURITY DOCUMENT +
+ +
+ Asterisk has successfully been installed. +
+ If you would like to install the sample +
+ configuration files (overwriting any +
+ existing config files), run: +
+ +
+ For generic reference documentation: +
+ make samples +
+ +
+ For a sample basic PBX: +
+ make basic-pbx +
+ +
+ +
+----------------- or ---------------------+
+ +
+ You can go ahead and install the asterisk +
+ program documentation now or later run: +
+ +
+ make progdocs +
+ +
+ **Note** This requires that you have +
+ doxygen installed on your local system +
+-------------------------------------------+
</pre>

== Install Program Docs ==

Install the program documentation by running the '''make progdocs''' command.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make progdocs

# Enable DOT
# Set Doxygen PROJECT_NUMBER variable
# Validate and auto-update local copy
Warning: Tag `SYMBOL_CACHE_SIZE' at line 291 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `SHOW_DIRECTORIES' at line 491 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `HTML_ALIGN_MEMBERS' at line 859 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `USE_INLINE_TREES' at line 1044 of file doc/asterisk-ng-doxygen has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"

Configuration file `doc/asterisk-ng-doxygen' updated.

# Run Doxygen
Warning: doxygen no longer ships with the FreeSans font.
You may want to clear or change DOT_FONTNAME.
Otherwise you run the risk that the wrong font is being used for dot generated graphs.
Searching for include files...
Searching for files in directory /usr/local/src/asterisk-18.1.0
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/mp3
Searching for files in directory /usr/local/src/asterisk-18.1.0/addons/ooh323c

=== SNIP ===

Patching output file 2546/2550
Patching output file 2547/2550
Patching output file 2548/2550
Patching output file 2549/2550
Patching output file 2550/2550
lookup cache used 65536/65536 hits=1461947 misses=70524
finished...
# Remove configuration backup file
</pre>

== Make the Asterisk 18.1.0 sample configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make samples
Installing adsi config files...
/bin/install -c -d "/etc/asterisk"
Installing configs/samples/asterisk.adsi
Installing configs/samples/telcordia-1.adsi
Installing other config files...
Installing file configs/samples/acl.conf.sample
Installing file configs/samples/adsi.conf.sample
Installing file configs/samples/agents.conf.sample
Installing file configs/samples/alarmreceiver.conf.sample
Installing file configs/samples/alsa.conf.sample
Installing file configs/samples/amd.conf.sample
Installing file configs/samples/app_mysql.conf.sample
Installing file configs/samples/app_skel.conf.sample
Installing file configs/samples/ari.conf.sample
Installing file configs/samples/ast_debug_tools.conf.sample
Installing file configs/samples/asterisk.conf.sample
Installing file configs/samples/calendar.conf.sample
Installing file configs/samples/ccss.conf.sample
Installing file configs/samples/cdr_adaptive_odbc.conf.sample
Installing file configs/samples/cdr_beanstalkd.conf.sample
Installing file configs/samples/cdr.conf.sample
Installing file configs/samples/cdr_custom.conf.sample
Installing file configs/samples/cdr_manager.conf.sample
Installing file configs/samples/cdr_mysql.conf.sample
Installing file configs/samples/cdr_odbc.conf.sample
Installing file configs/samples/cdr_pgsql.conf.sample
Installing file configs/samples/cdr_sqlite3_custom.conf.sample
Installing file configs/samples/cdr_syslog.conf.sample
Installing file configs/samples/cdr_tds.conf.sample
Installing file configs/samples/cel_beanstalkd.conf.sample
Installing file configs/samples/cel.conf.sample
Installing file configs/samples/cel_custom.conf.sample
Installing file configs/samples/cel_odbc.conf.sample
Installing file configs/samples/cel_pgsql.conf.sample
Installing file configs/samples/cel_sqlite3_custom.conf.sample
Installing file configs/samples/cel_tds.conf.sample
Installing file configs/samples/chan_dahdi.conf.sample
Installing file configs/samples/chan_mobile.conf.sample
Installing file configs/samples/cli_aliases.conf.sample
Installing file configs/samples/cli.conf.sample
Installing file configs/samples/cli_permissions.conf.sample
Installing file configs/samples/codecs.conf.sample
Installing file configs/samples/confbridge.conf.sample
Installing file configs/samples/config_test.conf.sample
Installing file configs/samples/console.conf.sample
Installing file configs/samples/dbsep.conf.sample
Installing file configs/samples/dnsmgr.conf.sample
Installing file configs/samples/dsp.conf.sample
Installing file configs/samples/dundi.conf.sample
Installing file configs/samples/enum.conf.sample
Installing file configs/samples/extconfig.conf.sample
Installing file configs/samples/extensions.ael.sample
Installing file configs/samples/extensions.conf.sample
Installing file configs/samples/extensions.lua.sample
Installing file configs/samples/extensions_minivm.conf.sample
Installing file configs/samples/features.conf.sample
Installing file configs/samples/festival.conf.sample
Installing file configs/samples/followme.conf.sample
Installing file configs/samples/func_odbc.conf.sample
Installing file configs/samples/hep.conf.sample
Installing file configs/samples/http.conf.sample
Installing file configs/samples/iax.conf.sample
Installing file configs/samples/iaxprov.conf.sample
Installing file configs/samples/indications.conf.sample
Installing file configs/samples/logger.conf.sample
Installing file configs/samples/manager.conf.sample
Installing file configs/samples/meetme.conf.sample
Installing file configs/samples/mgcp.conf.sample
Installing file configs/samples/minivm.conf.sample
Installing file configs/samples/misdn.conf.sample
Installing file configs/samples/modules.conf.sample
Installing file configs/samples/motif.conf.sample
Installing file configs/samples/musiconhold.conf.sample
Installing file configs/samples/muted.conf.sample
Installing file configs/samples/ooh323.conf.sample
Installing file configs/samples/osp.conf.sample
Installing file configs/samples/oss.conf.sample
Installing file configs/samples/phone.conf.sample
Installing file configs/samples/phoneprov.conf.sample
Installing file configs/samples/pjproject.conf.sample
Installing file configs/samples/pjsip.conf.sample
Installing file configs/samples/pjsip_notify.conf.sample
Installing file configs/samples/pjsip_wizard.conf.sample
Installing file configs/samples/prometheus.conf.sample
Installing file configs/samples/queuerules.conf.sample
Installing file configs/samples/queues.conf.sample
Installing file configs/samples/res_config_mysql.conf.sample
Installing file configs/samples/res_config_sqlite3.conf.sample
Installing file configs/samples/res_config_sqlite.conf.sample
Installing file configs/samples/res_corosync.conf.sample
Installing file configs/samples/res_curl.conf.sample
Installing file configs/samples/res_fax.conf.sample
Installing file configs/samples/res_ldap.conf.sample
Installing file configs/samples/res_odbc.conf.sample
Installing file configs/samples/resolver_unbound.conf.sample
Installing file configs/samples/res_parking.conf.sample
Installing file configs/samples/res_pgsql.conf.sample
Installing file configs/samples/res_pktccops.conf.sample
Installing file configs/samples/res_snmp.conf.sample
Installing file configs/samples/res_stun_monitor.conf.sample
Installing file configs/samples/rtp.conf.sample
Installing file configs/samples/say.conf.sample
Installing file configs/samples/sip.conf.sample
Installing file configs/samples/sip_notify.conf.sample
Installing file configs/samples/skinny.conf.sample
Installing file configs/samples/sla.conf.sample
Installing file configs/samples/smdi.conf.sample
Installing file configs/samples/sorcery.conf.sample
Installing file configs/samples/ss7.timers.sample
Installing file configs/samples/stasis.conf.sample
Installing file configs/samples/statsd.conf.sample
Installing file configs/samples/stir_shaken.conf.sample
Installing file configs/samples/test_sorcery.conf.sample
Installing file configs/samples/udptl.conf.sample
Installing file configs/samples/unistim.conf.sample
Installing file configs/samples/users.conf.sample
Installing file configs/samples/voicemail.conf.sample
Installing file configs/samples/vpb.conf.sample
Installing file configs/samples/xmpp.conf.sample
Updating asterisk.conf
/bin/install -c -d "/var/spool/asterisk/voicemail/default/1234/INBOX"
build_tools/make_sample_voicemail "//var/lib/asterisk" "//var/spool/asterisk"
Installing file phoneprov/000000000000.cfg
Installing file phoneprov/000000000000-directory.xml
Installing file phoneprov/000000000000-phone.cfg
Installing file phoneprov/polycom_line.xml
Installing file phoneprov/polycom.xml
Installing file phoneprov/snom-mac.xml
</pre>

== Make the Asterisk 18.1.0 configuration ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# make config
</pre>

== Set ldconfig ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# ldconfig
</pre>

== Setup user, group and permissions ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# groupadd asterisk
[root@cn38-inverness-co asterisk-18.1.0]# useradd -r -d /var/lib/asterisk -g asterisk asterisk
[root@cn38-inverness-co asterisk-18.1.0]# usermod -aG audio,dialout asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /etc/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /var/{lib,log,spool}/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# chown -R asterisk.asterisk /usr/lib/asterisk
</pre>

== Set runtime parameters ==

Need to change things in there.

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/sysconfig/asterisk
[root@cn38-inverness-co asterisk-18.1.0]# sudo vim /etc/asterisk/asterisk.conf
</pre>

== Enable and Start Asterisk 18.1.0 ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl enable asterisk

asterisk.service is not a native service, redirecting to /sbin/chkconfig.
Executing /sbin/chkconfig asterisk on

[root@cn38-inverness-co asterisk-18.1.0]# sudo systemctl start asterisk

</pre>

== Connect to Asterisk and verify version ==

<pre>
[root@cn38-inverness-co asterisk-18.1.0]# asterisk -rvv

parse error: No category context for line 1 of /etc/asterisk/asterisk.conf
Unable to open specified master config file '/etc/asterisk/asterisk.conf', using built-in defaults
Asterisk 18.1.0, Copyright (C) 1999 - 2018, Digium, Inc. and others.
Created by Mark Spencer <markster@digium.com>
Asterisk comes with ABSOLUTELY NO WARRANTY; type 'core show warranty' for details.
This is free software, with components licensed under the GNU General Public
License version 2 and other licenses; you are welcome to redistribute it under
certain conditions. Type 'core show license' for details.
=========================================================================
Connected to Asterisk 18.1.0 currently running on cn38-inverness-co (pid = 18370)
cn38-inverness-co*CLI>
Disconnected from Asterisk server
Asterisk cleanly ending (0).
Executing last minute cleanups
</pre>

= Configure Asterisk =

== Version 1.8 to 18.1.0 Errors ==

chan_agent => chan_agent_pool

chan_local => Asterisk core, no loadable module

bridge_multiplexed => ?

app_meetme => Part of DAHDI. Unclear if we use audio bridges.

Failed to resolve dependencies for func_curl

Failed to resolve dependencies for res_config_curl

Failed to resolve dependencies for app_page