add systemd guide
This commit is contained in:
		
							
								
								
									
										70
									
								
								Netdisco/lib/App/Netdisco/Manual/Systemd.pod
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										70
									
								
								Netdisco/lib/App/Netdisco/Manual/Systemd.pod
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,70 @@
 | 
			
		||||
=head1 NAME
 | 
			
		||||
 | 
			
		||||
App::Netdisco::Manual::Systemd - Systemd install tips
 | 
			
		||||
 | 
			
		||||
=head1 Introduction
 | 
			
		||||
 | 
			
		||||
This page documents Netdisco running under systemd. Thanks to Aurelien Guerson
 | 
			
		||||
and Stuart Kendrick for offering this solution. Please check these
 | 
			
		||||
instructions apply to your local installation and use at your own risk.
 | 
			
		||||
 | 
			
		||||
=head1 Files
 | 
			
		||||
 | 
			
		||||
=head2 C<< /etc/systemd/system/netdisco-daemon.service >>
 | 
			
		||||
 | 
			
		||||
This should be set mode 644 and owned by user and group C<root>.
 | 
			
		||||
 | 
			
		||||
  [Unit]
 | 
			
		||||
  Description=Netdisco Daemon Service
 | 
			
		||||
  AssertFileIsExecutable=/home/netdisco/bin/netdisco-daemon
 | 
			
		||||
  After=syslog.target network-online.target
 | 
			
		||||
  
 | 
			
		||||
  [Service]
 | 
			
		||||
  Type=forking
 | 
			
		||||
  User=netdisco
 | 
			
		||||
  Group=netdisco
 | 
			
		||||
  ExecStart=/home/netdisco/bin/netdisco-daemon start
 | 
			
		||||
  ExecStop=/home/netdisco/bin/netdisco-daemon stop
 | 
			
		||||
  Restart=on-failure
 | 
			
		||||
  RestartSec=60
 | 
			
		||||
  
 | 
			
		||||
  [Install]
 | 
			
		||||
  WantedBy=multi-user.target
 | 
			
		||||
 | 
			
		||||
=head2 C<< /etc/systemd/system/netdisco-web.service >>
 | 
			
		||||
 | 
			
		||||
This should be set mode 644 and owned by user and group C<root>.
 | 
			
		||||
 | 
			
		||||
  [Unit]
 | 
			
		||||
  Description=Netdisco Web Service
 | 
			
		||||
  AssertFileIsExecutable=/home/netdisco/bin/netdisco-web
 | 
			
		||||
  After=syslog.target network-online.target netdisco-daemon.service
 | 
			
		||||
  
 | 
			
		||||
  [Service]
 | 
			
		||||
  Type=forking
 | 
			
		||||
  User=netdisco
 | 
			
		||||
  Group=netdisco
 | 
			
		||||
  ExecStart=/home/netdisco/bin/netdisco-web start
 | 
			
		||||
  ExecStop=/home/netdisco/bin/netdisco-web stop
 | 
			
		||||
  Restart=on-failure
 | 
			
		||||
  RestartSec=60
 | 
			
		||||
  
 | 
			
		||||
  [Install]
 | 
			
		||||
  WantedBy=multi-user.target
 | 
			
		||||
 | 
			
		||||
=head1 Commands
 | 
			
		||||
 | 
			
		||||
To enable Netdisco in systemd:
 | 
			
		||||
 | 
			
		||||
 systemctl enable netdisco-daemon.service
 | 
			
		||||
 systemctl enable netdisco-web.service
 | 
			
		||||
 | 
			
		||||
To start Netdisco:
 | 
			
		||||
 | 
			
		||||
 systemctl start netdisco-daemon.service
 | 
			
		||||
 systemctl start netdisco-web.service
 | 
			
		||||
 | 
			
		||||
May also need to run C<systemctl daemon-reload> depending on the order you do
 | 
			
		||||
these steps.
 | 
			
		||||
 | 
			
		||||
=cut
 | 
			
		||||
@@ -151,4 +151,9 @@ Add this to your 37xx config:
 | 
			
		||||
 | 
			
		||||
 no snmp-server sysobjectid type stack-oid
 | 
			
		||||
 | 
			
		||||
=head1 Running under C<systemd>
 | 
			
		||||
 | 
			
		||||
On C<systemd>-based systems please see L<our Systemd
 | 
			
		||||
guide|App::Netdisco::Manual::Systemd>.
 | 
			
		||||
 | 
			
		||||
=cut
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user