{"id":437,"date":"2021-01-27T20:49:12","date_gmt":"2021-01-27T20:49:12","guid":{"rendered":"https:\/\/new1.blog.oqtacore.com\/?p=437"},"modified":"2022-11-23T12:11:21","modified_gmt":"2022-11-23T12:11:21","slug":"otrs-setup-walkthrough","status":"publish","type":"post","link":"https:\/\/oqtacore.com\/blog\/otrs-setup-walkthrough\/","title":{"rendered":"OTRS setup for managing app deployment"},"content":{"rendered":"

OTRS is a software that we use to manage customer experience during deployment rollouts. Users can file tickets with any questions, wishes and bug reports through OTRS, where all requests are organized and managed by our team.<\/p>\n

This is a great open-source tool and we want to share how to set it up.<\/p>\n

<\/span>OTRS setup schema<\/span><\/h2>\n

Implementation of an application processing system.<\/p>\n

Our company uses 3 large software products, which are constantly added, updated and developed.\u00a0We use them to conduct large business throughout the country, which employs more than 3000 people.\u00a0Naturally, it is not complete without software failures, human factors and other troubles.\u00a0And at some point, it was decided to implement a system that could be an entry point for users who encountered difficulties using the software.\u00a0An employee should always know that there is a tool thanks to which he will not be left alone with his problem.\u00a0The system requirements were as follows:<\/p>\n

– Integration with a domain controller under\u00a0Windows\u00a0Server\u00a0OS\u00a0(\u00a0Active\u00a0Directory\u00a0)<\/p>\n

– Availability of authentication and authorization<\/p>\n

–\u00a0Ability to receive notifications from the system<\/p>\n

– Generation of reports<\/p>\n

– Free distribution and open source<\/p>\n

After a long search and testing of dozens of such systems, the OTRS ( Open-source Ticket Request System ) system was perfect for us.<\/p>\n

\"OTRS<\/p>\n

The whole interaction scheme is as follows. The user encounters any technical problem, logs into the OTRS system by entering a username and password. Selects from the list the software product with which he has difficulty. Thus, a request is created. The application is registered in the system and automatically goes to a group of engineers (agents) who are assigned to support the software with which the problem has arisen. The engineer is notified by e-mail and Telegram. After that, he contacts the user in any convenient way, if necessary, and resolves his issue. After the issue is resolved, the agent closes the application. The user automatically receives a notification about this by e-mail .<\/p>\n

<\/span>Installing\u00a0OTRS<\/span><\/h2>\n

Installation was carried out on\u00a0OS\u00a0Ubuntu\u00a0Linux\u00a018.04.\u00a0Before starting work, be sure to install all the latest operating system updates:<\/p>\n

apt-get update && sudo apt-get upgrade -y<\/pre>\n
We install the components required by the OTRS system:<\/p>\n
sudo apt-get install -y libapache2-mod-perl2 libdbd-mysql-perl libtimedate-perl libnet-dns-perl libnet-ldap-perl libio-socket-ssl-perl libpdf-api2-perl libsoap-lite-perl libtext-csv-xs-perl libjson-xs-perl libapache-dbi-perl libxml-libxml-perl libxml-libxslt-perl libyaml-perl libarchive-zip-perl libcrypt-eksblowfish-perl libencode-hanextra-perl libmail-imapclient-perl libtemplate-perl libdatetime-perl libdbd-odbc-perl libdbd-pg-perl libauthen-ntlm-perl -y<\/pre>\n
Then we will need the HTTP – server and database:<\/p>\n
sudo apt-get install mysql-server\r\n\r\nsudo apt-get install apache2<\/pre>\n
Download the OTRS distribution and save it in the \/opt folder<\/p>\n
wget ftp:\/\/ftp.otrs.org\/pub\/otrs\/otrs-6.0.9.tar.gz<\/pre>\n
Unpack the archive and transfer it to the \/opt \/otrs folder<\/p>\n
tar -zxvf otrs-6.0.9.tar.gz otrs-6.0.9\/<\/pre>\n
sudo mv otrs-6.0.9 \/opt\/otrs<\/pre>\n
We create a new user:<\/p>\n
sudo useradd otrs -d \/opt\/otrs\/-G www-data -c \"OTRS User\"<\/pre>\n
 <\/p>\n
Rename the OTRS configuration file:<\/p>\n
cp\/opt\/otrs\/Kernel\/Config.pm.dist \/opt\/otrs\/Kernel\/Config.pm<\/pre>\n
Set access rights to the OTRS folder:<\/p>\n
sudo\/opt\/otrs\/bin\/otrs.SetPermissions.pl --web-group=www-data<\/pre>\n
Let’s check that all components are installed correctly:<\/p>\n
perl\/opt\/otrs\/bin\/otrs.CheckModules.pl<\/pre>\n
This check will clearly show what we are missing for work and tell you how to fix it.\u00a0The commands for installing the missing modules will be displayed.<\/p>\n
Now let’s run a test and make sure Perl is configured correctly. In response to each command, you need to receive a message stating that everything is fine with the syntax:<\/p>\n
sudo perl -cw \/opt\/otrs\/bin\/cgi-bin\/index.pl\r\n\r\nsudo perl -cw \/opt\/otrs\/bin\/cgi-bin\/customer.pl\r\n\r\nsudo perl -cw \/opt\/otrs\/bin\/otrs.PostMaster.pl\r\n\r\nsudo perl -cw \/opt\/otrs\/bin\/otrs.Console.pl<\/pre>\n
The next step is to go to the file\u00a0\/\u00a0etc\u00a0\/\u00a0mysql\u00a0\/\u00a0my\u00a0.\u00a0cnf\u00a0and set the following parameters\u00a0:<\/p>\n
[mysqld]\r\n\r\nmax_allowed_packet = 64M\r\n\r\nquery_cache_size = 32M\r\n\r\ninnodb_log_file_size = 512M<\/pre>\n
Restarting MySQL and create new the log file :<\/p>\n
service mysql stop\r\n\r\nrm \/var\/lib\/mysql\/ib_logfile0\r\n\r\nrm \/var\/lib\/mysql\/ib_logfile1\r\n\r\nservice mysql start<\/pre>\n
We create a new database in advance, which we will need during the installation and operation of the system.<\/p>\n
sudo mysql -u root -p<\/pre>\n
MySQL will ask for a password for the root user . By default , it is the same as the login: root.<\/p>\n
CREATE DATABASE otrs CHARACTER SET utf8;\r\n\r\nCREATE USER 'otrs'@'localhost' IDENTIFIED BY 'password';\r\n\r\nGRANT ALL PRIVILEGES ON otrs.* TO 'otrs'@'localhost';\r\n\r\nFLUSH PRIVILEGES;\r\n\r\nEXIT<\/pre>\n
Add and enable a virtual web server and CGI support:<\/p>\n
sudo ln -s \/opt\/otrs\/scripts\/apache2-httpd.include.conf \/etc\/apache2\/sites-available\/otrs.conf\r\n\r\nsudo a2ensite otrs.conf\r\n\r\nsudo a2enmod cgi<\/pre>\n
For the changes to take effect, restart the\u00a0apache\u00a0service\u00a0:<\/p>\n
service apache2 restart<\/pre>\n
After all the operations done, the web installer should start\u00a0.\u00a0To do this, in the\u00a0browser, type\u00a0http: \/\/localhost\/otrs\/installer.pl<\/a><\/p>\n
If a page with licenses opened in response to you, then everything was done correctly and you can move on. Step 2: establish a connection to the database. Choosing the type MySQL.<\/p>\n
\"MySQL<\/p>\n
 <\/p>\n
Then we enter the username and password that were set when creating the database\u00a0.\u00a0The IP\u00a0–\u00a0address of the host specify 127.0.0.1.<\/p>\n
\"creating<\/p>\n
 <\/p>\n
After successful connection, you can continue to configure the system and go to\u00a0Step\u00a03.<\/p>\n
\"creating<\/p>\n
We indicate the administrator’s email and the name of the organization.\u00a0The rest of the parameters are determined automatically.<\/p>\n
\"creating<\/p>\n
If you cannot configure mail at the installation stage, you can do this later.\u00a0You can skip this step.<\/p>\n
\"creating<\/p>\n
 <\/p>\n
Step\u00a04\u00a0will provide us with data for system administrator access.\u00a0Be sure to save this data in some text file, otherwise you will not be able to log in to the system.<\/p>\n
\"creating<\/p>\n
 <\/p>\n
After successfully installing the system, be sure to configure the task scheduler with the following commands:<\/p>\n
User access:<\/p>\n
http:\/\/OTRS_Server_IP\/otrs\/customer.pl<\/p>\n
Agent access:<\/p>\n
http:\/\/OTRS_Server_IP\/otrs\/index.pl<\/p>\n
To ensure the correct operation of the OTRS system, be sure to launch the task scheduler and configure it with the following commands:<\/p>\n
cp \/opt\/otrs\/var\/cron\/otrs_daemon.dist \/opt\/otrs\/var\/cron\/otrs_daemon\r\n\r\ncp \/opt\/otrs\/var\/cron\/aaa_base.dist \/opt\/otrs\/var\/cron\/aaa_base\r\n\r\nsu -c \"\/opt\/otrs\/bin\/otrs.Daemon.pl start\" -s \/bin\/bash otrs\r\n\r\nsu -c \"\/opt\/otrs\/bin\/Cron.sh start\" -s \/bin\/bash otrs<\/pre>\n
<\/span>Integration with the domain<\/span><\/h2>\n
The most basic system configuration file is \/opt \/otrs \/Kernel \/Config.pm.<\/p>\n
The first step is to set up\u00a0logging\u00a0, which will help to sort out errors when the system is incorrectly configured.<\/p>\n
Then write all the necessary settings for logging agents through\u00a0LDAP\u00a0:<\/p>\n
DC_the NAME – domain name of the controller ( or the IP-address );<\/p>\n
DOMAIN_NAME – your domain name;<\/p>\n
Acs-OTRSagents – the name of the domain access group whose members can log in as agents;<\/p>\n
We register the name and password of the account that will read the domain:<\/p>\n
In the same way, we\u00a0configure the login for users.\u00a0For example, we attach a link to a working configuration file:\u00a0https:\/\/github.com\/ishmuratov\/ZabbixBot\/blob\/main\/ConfigTest.pm<\/p>\n
<\/span>User interface<\/span><\/h2>\n
The appearance\u00a0of the\u00a0request processing\u00a0system is\u00a0very flexible.\u00a0The entire user interface can be changed with a basic knowledge of\u00a0HTML<\/p>\n
opt\/otrs\/Kernel\/Output\/HTML\/Templates\/Standart\/CustomerLogin.tt – responsible for the appearance of the login window for the system user;<\/p>\n
\/opt\/otrs\/Kernel\/Output\/HTML\/Templates\/Standart\/Login.tt – responsible for the appearance of the login window for agents \/ admins.<\/p>\n
By changing the content of these files, you can completely redesign the login and password entry form.\u00a0<\/span>Move buttons, add images and company logo, write a quick guide for beginners.\u00a0Everything is limited only by your imagination.<\/p>\n
<\/span>OTRS – creating an order<\/span><\/h2>\n
System\u00a0OTRS\u00a0is\u00a0of web\u00a0–\u00a0application that works through any modern browser.\u00a0In order to enter the system for creating a\u00a0ticket<\/a>\u00a0, you need to open the page\u00a0http: \/\/OTRS_Server_IP\/otrs\/customer.pl<\/a> . As a rule, there are always many more regular users than agents. Therefore, it is useful to set up of web – server Apache in such a way that, whenever it is accessed, automatically opens the page to customer .pl, not index.pl. By this action, we will eliminate the situation when the user tries to enter where he does not need.<\/p>\n
If your organization does not have a domain, then at the first login, the user must register.\u00a0When registering, you must indicate the position, name, surname and\u00a0Email\u00a0.\u00a0An e-mail with a login password will be sent to the specified mail.<\/p>\n
After a successful login, a list of all the orders you have created will be displayed.\u00a0Naturally, the first time you log in, the list will be empty.\u00a0By clicking on the menu item\u00a0Tickets\u00a0–\u00a0New\u00a0Ticket\u00a0,\u00a0the application creation form will open.<\/p>\n
\"OTRS<\/p>\n
The form is very similar to a regular email.\u00a0It is necessary to fill in the recipient, the subject of the application and the text of the application.\u00a0The list of recipients is drop-down and is pre-configured by the administrator.\u00a0As a rule, the recipients contain a list of groups of technical specialists, or the name of software systems.\u00a0If suddenly the user may have doubts about whom to send the application to, then it is necessary to provide for the possibility of sending an application to some universal group, whose employees will be able to transfer the application to where they should or will solve the problem on their own.<\/p>\n
When creating an application, it is possible to attach a file.\u00a0For example, you can add a screenshot of the error that occurs, or a video of the actions that lead to the error.<\/p>\n
The\u00a0\u201c\u00a0Submit\u00a0\u201d\u00a0button\u00a0completes the process of creating an application and sends it to the agents whose group was specified in the \u201c\u00a0To\u00a0:\u00a0\u201d\u00a0field\u00a0.\u00a0In this case, a unique number is automatically assigned to the application, which is communicated by e-mail.\u00a0Whenever a status change or comment is added, a notification will come.\u00a0Thus, the user will always be aware of everything that happens with his application.<\/p>\n
<\/span>OTRS – tickets processing<\/span><\/h2>\n
When an agent receives a notification about a ticket that came to his group, he sees the text of the problem and the sender.\u00a0Accordingly, if there is a need to promptly contact the author of the application, then you do not need to enter\u00a0OTRS\u00a0.\u00a0The agent logs in only to write a comment and close a ticket.\u00a0To enter, you need to open the page\u00a0http: \/\/OTRS_Server_IP\/otrs\/index.pl<\/a>\u00a0and enter your username and password.<\/p>\n
\"OTRS<\/p>\n
Logging in as an agent opens a list of open applications.\u00a0You can easily add additional columns to the list to display: name of the author, responsible executive, due date, etc.\u00a0By clicking on any of the applications, we will receive the full text of the problem and attached files.\u00a0If you need to clarify any information, you can request it directly in the system by leaving a comment.\u00a0The author of the application will receive a notification about this, which will allow him to quickly respond to the comment.\u00a0All correspondence is saved in the database, so at any time you can see how the process of solving the problem went.<\/p>\n
\"OTRS<\/p>\n
After the problem is completely eliminated, the application must be closed by clicking on the button of the same name.\u00a0When closed, a form opens in which you can describe how to solve the problem.\u00a0Thanks to this, when another specialist is faced with a similar problem, he will be able to spy on a way to solve it.<\/p>\n
It should be noted that\u00a0OTRS\u00a0has a flexible\u00a0system of differentiation of rights for agents.\u00a0When the agent first logs in, he will not be able to see any tickets until the administrator allows it.\u00a0It is very convenient when one group of agents does not see the tickets of another group of agents.\u00a0The confidentiality of information is preserved, and agents see more orderly what they need to do.<\/p>\n
The\u00a0OTRS\u00a0community is\u00a0very extensive, the whole system is very well documented.\u00a0Therefore, all the questions that arise can be answered without much difficulty.\u00a0Among other things, there is the possibility of purchasing a paid subscription for technical support and support.\u00a0After setting up notifications by e-mail, you can implement the forwarding of applications to\u00a0Telegram\u00a0–\u00a0chat for a quicker response.\u00a0The implementation of such an idea is described in detail in the article “Effective resource monitoring”\u00a0https:\/\/new1.blog.oqtacore.com\/effective-monitoring-for-a-large-enterprise-5000-users\/<\/p>\n
As a result of the implementation of the application processing system, we were able to significantly increase the efficiency of work within the company due to the prompt solution of technical problems of users.\u00a0Analysis of the incoming applications allowed us to identify the bottlenecks of the entire software and eliminate them as much as possible.\u00a0All typical errors due to the fault of users were analyzed and, after the training activities, were minimized.<\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
OTRS is a software that we use to manage customer experience during deployment rollouts. Users can file tickets with any questions, wishes and bug reports through OTRS, where all requests are organized and managed by our team. This is a great open-source tool and we want to share how to set it up. OTRS setup […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_mo_disable_npp":"","yasr_overall_rating":0,"yasr_post_is_review":"","yasr_auto_insert_disabled":"","yasr_review_type":"","footnotes":""},"categories":[1],"tags":[26],"class_list":["post-437","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-tech-stuff"],"acf":{"image":453},"yasr_visitor_votes":{"number_of_votes":0,"sum_votes":0,"stars_attributes":{"read_only":false,"span_bottom":false}},"_links":{"self":[{"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/posts\/437","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/comments?post=437"}],"version-history":[{"count":12,"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/posts\/437\/revisions"}],"predecessor-version":[{"id":954,"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/posts\/437\/revisions\/954"}],"wp:attachment":[{"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/media?parent=437"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/categories?post=437"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/oqtacore.com\/blog\/wp-json\/wp\/v2\/tags?post=437"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}