OTRS

From Wikitech
(Difference between revisions)
Jump to: navigation, search
(To upgrade)
Line 14: Line 14:
 
== To upgrade ==
 
== To upgrade ==
  
 +
# Stop postfix. You don't want to have mail coming in while OTRS is broken.
 
# Fetch new OTRS code
 
# Fetch new OTRS code
 
# Decompress into /opt/otrs-X.Y.Z
 
# Decompress into /opt/otrs-X.Y.Z
 
# Copy in Kernel/Config files...
 
# Copy in Kernel/Config files...
 +
# cp -a ../otrs/.procmailrc ../maintenance
 
# Set it to use the shared var dir:
 
# Set it to use the shared var dir:
 
#* mv var var-dist && ln -s ../otrs-var var
 
#* mv var var-dist && ln -s ../otrs-var var
Line 22: Line 24:
 
#* cd Kernel/Output/HTML && ln -s Standard OTRS
 
#* cd Kernel/Output/HTML && ln -s Standard OTRS
 
# Set permissions on the dir, eg:
 
# Set permissions on the dir, eg:
#* bin/SetPermissions.sh /opt/otrs-2.1.8 otrs apache otrs apache
+
#* bin/SetPermissions.sh /opt/otrs-X.Y.Z otrs apache otrs apache
 
# Apply patches
 
# Apply patches
 
#* '''What patches? Please add record of them!'''
 
#* '''What patches? Please add record of them!'''
 +
# change the /opt/otrs symlink to the new version
 +
# start postfix
 +
# send a mail to e.g. info-en and check that it shows up in OTRS
  
 
== Troubleshooting ==
 
== Troubleshooting ==

Revision as of 09:02, 8 April 2008

OTRS is installed on bart.wikimedia.org.

  • Source is in /opt/otrs
  • Config file is /opt/otrs/Kernel/Config.pm
  • URL is https://secure.wikimedia.org/otrs/index.pl
  • The root user/pass is in /home/wikipedia/doc/otrs
  • Primary db is on srv179, replica on ????. OTRS uses only the primary DB, they apparently don't support slaves.
  • The codebase is patched, e.g. for supporting one-click-spam
    • since we have no current record of such patches, such patches are being removed. if you find them and can narrow them down, please point them out

You no longer need to invoke a specific script or update config files to add email addresses to OTRS; mchenry will automatically see that the queue exists or has disappeared.

It is possible (due to negative caching at the secondary mail exchangers) that new addresses will take up to two hours to begin working.

To upgrade

  1. Stop postfix. You don't want to have mail coming in while OTRS is broken.
  2. Fetch new OTRS code
  3. Decompress into /opt/otrs-X.Y.Z
  4. Copy in Kernel/Config files...
  5. cp -a ../otrs/.procmailrc ../maintenance
  6. Set it to use the shared var dir:
    • mv var var-dist && ln -s ../otrs-var var
  7. Symlink the templates...
    • cd Kernel/Output/HTML && ln -s Standard OTRS
  8. Set permissions on the dir, eg:
    • bin/SetPermissions.sh /opt/otrs-X.Y.Z otrs apache otrs apache
  9. Apply patches
    • What patches? Please add record of them!
  10. change the /opt/otrs symlink to the new version
  11. start postfix
  12. send a mail to e.g. info-en and check that it shows up in OTRS

Troubleshooting

  • After 2.1.8 upgrade, ticket zooming failed trying to load Kernel::System::LinkObject::FAQ. Had to go to the Admin Package Manager screen and reinstall the FAQ module.
Personal tools
Namespaces

Variants
Actions
Navigation
Ops documentation
Wiki
Toolbox