YouTrack v6.5 on CentOS 7.1 as a ZIP install
Installation notes for install YouTrack on a VM as a ZIP installation.
The VM is running CentOS v7.1, with OpenJDK. An Nginx proxy is used in front of the service to provide https access.
OpenJDK
Install the latest OpenJDK:
# yum install java-1.8.0-openjdk-headless
YouTrack
Add an account for the youtrack service:
# adduser -c "YouTrack Issue Tracker" -m -d /srv/youtrack -r youtrack
As the 'youtrack' user (from the 'youtrack' home directory) download the distribution jar and create a symbolic link with a fixed name. When an upgrade is available, the link can be updated to perform an inplace upgrade.
$ unzip youtrack-6.5.16807.zip -d youtrack-6.5.16807 $ ls -s youtrack-6.5.16807 youtrack $ mkdir data backup log tmp
systemd
Create a systemd service file '/lib/systemd/system/youtrack.service' to run the service as the youtrack user:
[Unit] Description=JetBrains Youtrack Requires=network.target After=syslog.target network.target [Service] Type=simple EnvironmentFile=/etc/default/youtrack WorkingDirectory=/srv/youtrack Type=forking ExecStart=/srv/youtrack/youtrack/bin/youtrack.sh start ExecStop=/srv/youtrack/youtrack/bin/youtrack.sh stop User=youtrack [Install] WantedBy=multi-user.target
Add the following to the file '/etc/default/youtrack' to configure the service:
# # The listen url of the form [host:]<port>[/contextPath] # LISTEN_URL=8080 # # Additional JVM options # VM_OPTS0=-Xmx1g VM_OPTS1=-XX:MaxMetaspaceSize=250M VM_OPTS2=-Djava.security.egd=/dev/zrandom VM_OPTS3=-Djetbrains.youtrack.disableBrowser=true VM_OPTS4=
Enable and start the service:
# systemctl enable youtrack # systemctl start youtrack
Firewall
Over and above standard firewall access (ssh, dns, http, local smtp); allow ingress for http for the main web interface (port 8080):
-A tcpIn -p tcp -m tcp --source 10.20.7.0/24 --dport 8080 -m conntrack --ctstate NEW -j ACCEPT
Note: If you are using the standard firewall then
# firewall-cmd --zone=public --permanent --add-port=8080/tcp # firewall-cmd --reload
Logs
Setup a link to the logs so they are easy to access:
# ln -s /srv/youtrack/.youtrack/logs /var/log/youtrack
Configuration
