====== Configuration and administration ======
{{indexmenu_n>3}}

===== File .env =====

<note tip>Watch a tutorial (english subs): {{youtube>KHqYpV3HXqU?}}</note>

Subsystem configuration is done by editing the .env file \\ <code bash>/var/www/html/dpiui2/backed/.env</code>

The file has the following content:
\\ <code bash>
#System settings. It should remain unchanged.
APP_ENV=local
APP_DEBUG=true
APP_KEY=
APP_TIMEZONE=UTC

#Application URL. It is needed to form the correct link when sending QoE reports to e-mail
APP_URL=https://localhost/

#System settings regarding connection to the MySql DB, it should remain unchanged
DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=dpiui2
DB_USERNAME=root
DB_PASSWORD=vasexperts

#Settings regarding connection to the SMTP server. They are needed to send email notifications.
CFG_SMTP_UNAME=dpiuitest@gmail.com
CFG_SMTP_PW=dpiuitestdpiuitest
CFG_SMTP_HOST=smtp.gmail.com
CFG_SMTP_PORT=587
#tls or ssl
CFG_SMTP_SECURE=tls

#Technical support address
CFG_SEND_ERROR_EMAIL=sd@vas.expert
#Address for sending of email copies
CFG_SEND_COPY_EMAIL=

#System settings, prohibited from changing
CACHE_DRIVER=file
QUEUE_DRIVER=database
SESSION_DRIVER=cookie

#Settings regarding connection to QoE Stor
QOESTOR_DB_HOST=localhost
QOESTOR_DB_PORT=8123
QOESTOR_DB_USER=default
QOESTOR_DB_PASS=''
QOESTOR_DB_NAME=qoestor
QOESTOR_CACHE_LIFE_TIME_SEC=3600
QOESTOR_MAIN_LOG_PARTITIONS_LIFE_TIME_HOUR=24
QOESTOR_AGG_LOG_PARTITIONS_LIFE_TIME_DAYS=15

#Subscriber synchronization period in minutes (for the Subscribers and Services and Advertising sections)
SM_SUBSCRIBERS_UPDATE_PERIOD_MINUTES=30

#Data сleanup period for charts in the Performance Section
CHART_DATA_DELETE_DAYS_INTERVAL=60

#CG-NAT profile and statistics synchronization period
CG_NAT_SYNC_MINUTES_INTERVAL=5

#Хост Vas Cloud
VAS_CLOUD_HOST=5.200.37.122

</code>

<note important>
If changes to .env have been made, you should run the following command: ''dpiui2 queue:restart''\\ 
//If the command is not found restart the ssh session in the terminal.//
</note>


===== Equipment connection =====

==== Sudo user ====
The equipment is connected and controlled using the SSH protocol. Connection must be done under a user with sudo privileges, or under the root user **(not recommended)**.

<note tip>Watch a tutorial on connecting to DPI (english subs): {{youtube>81WMPGw6tak?}}</note>

A new user should be created with sudo access granted on the connected equipment.

Let's consider ''dpisu'' user creating as an example:

  - Create the ''dpisu user'' <code bash>adduser dpisu
passwd dpisu</code>
  - Add to the ''/etc/sudoers.d/dpisu'' file the following stuff <code bash>Defaults:dpisu !requiretty
Defaults secure_path = /usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin
dpisu    ALL=(ALL)       NOPASSWD: ALL</code> //By doing this, you disable the dpisu user requirement for a password and the requiretty requirement when switching to sudo mode.//
  - Disable the requiretty requirement in the file ''/etc/sudoers'' <code bash> sed -i "s/^.*requiretty/#Defaults requiretty/" /etc/sudoers</code>