Welcome
Congratulations, you now have a working installation of
iiTWiki.
Please complete the installation and configuration by performing the steps outlined below.
Replace this topic with the front page for this website when done. Have a look at
TWikiPreferences to see how to create a front page resembling the front page of ETH websites.
Customize /etc/httpd/conf/httpd.conf
Edit the file
/etc/httpd/conf/httpd.conf as
root on the web server:
- Set
ServerAdmin to the mail address of the person responsible for this website, e.g. webadmin@muster.ethz.ch
Install Certificate
Order and install a TLS/SSL certificate on the web server and update the file
/etc/httpd/conf.d/iitwiki.conf:
- Set
SSLCertificateFile to the full path of the certificate
- Set
SSLCertificateKeyFile to the full path of the private key
- Set
SSLCertificateChainFile to the full path of the certificate
Please make sure that the certificate file includes all intermediate CA certificates.
Customize /var/www/twiki/etc/LocalSite.cfg
Edit the file
/var/www/twiki/etc/LocalSite.cfg as
root on the web server:
- Set
$TWiki::cfg{WebMasterEmail} to the mail address of the person responsible for this website, e.g. webadmin@muster.ethz.ch
- Set
$TWiki::cfg{AdminUserLogin} to an ETH user namez other than yours. You may need to perform the following installation steps together with somebody else who has an ETH user account if you do not have two user names.
- Set
$TWiki::cfg{DefaultUrlHost} to the URL of this site without trailing slash, e.g. http://muster.inf.ethz.ch
- Set
$TWiki::cfg{PermittedRedirectHostUrls} to the list of all valid site URLs, including all combinations of http / https and all host names, e.g. http://muster.inf.ethz.ch, https://muster.inf.ethz.ch, http://muster.ethz.ch, https://muster.ethz.ch
After doing so restart and permanently enable the
httpd service by executing the following commands as
root on the web server:
systemctl enable httpd
systemctl restart httpd
The changed configuration requires you to reload this topic in the browser. Then log in with the login set above.
Register Initial User
Register yourself as administrator:
When done log out.
Disable Admin User
Edit the file
/var/www/twiki/etc/LocalSite.cfg as
root on the web server and revert the settings for
$TWiki::cfg{AdminUserLogin} to
admin. After doing so restart the
httpd service by executing
service httpd restart as
root.
Log in again but this time as the user you registered above.
Preferences
Carefully look through
WebPreferences and change the preferences as explained there.
Trash Web Preferences
Also edit
Trash.WebPreferences to configure the
Trash web used for deleted topics and attachments. Most of the settings can be copied over from
WebPreferences.
Customize Topics
Make sure that all topics that are linked through the
main and
header navigation and
footer links are there and contain meaningful information. The following topics are already present and should be edited, renamed or removed:
Do not forget to create and edit the topics and subtopics for the other links in the main navigation too.
Configure RSS Feeds
By default the RSS feed
RssNews is enabled in
WebPreferences which serves the first sub-section of the
News topic as feed item.
Switching to Basic Authentication
The default configuration of this TWiki installation is to use LDAPS based password authentication for obtaining a limited-lifetime session cookie. The advantage of this setup is that a logout is possible.
To reconfigure this installation to use basic authentication perform the following steps:
- In
/var/www/twiki/etc/config.d/ETHUser.conf comment out the line that sets $TWiki::cfg{PasswordManager}.
- In
/etc/httpd/conf.d/iitwiki.conf make the following changes:
- Uncomment either the section for LDAP or AD authentication.
- Uncomment all
Require valid-user
- Edit TWikiPreferences and set
ETHSKINDISABLELOGOUT to 1.
- Restart the
httpd service by executing service httpd restart as root.
