diff --git a/docs/images/admin-manage-search.png b/docs/images/admin-manage-search.png new file mode 100644 index 0000000000..df1f3f5fe3 Binary files /dev/null and b/docs/images/admin-manage-search.png differ diff --git a/docs/images/admin-monitoring.png b/docs/images/admin-monitoring.png new file mode 100644 index 0000000000..7e37de8000 Binary files /dev/null and b/docs/images/admin-monitoring.png differ diff --git a/docs/images/admin-process-manager.png b/docs/images/admin-process-manager.png new file mode 100644 index 0000000000..b8c1b20e06 Binary files /dev/null and b/docs/images/admin-process-manager.png differ diff --git a/docs/images/admin-settings-client.png b/docs/images/admin-settings-client.png new file mode 100644 index 0000000000..08fdf5467b Binary files /dev/null and b/docs/images/admin-settings-client.png differ diff --git a/docs/images/admin-settings-email-log.png b/docs/images/admin-settings-email-log.png new file mode 100644 index 0000000000..d523719a86 Binary files /dev/null and b/docs/images/admin-settings-email-log.png differ diff --git a/docs/images/admin-settings-general.png b/docs/images/admin-settings-general.png new file mode 100644 index 0000000000..1ed6c3cb2e Binary files /dev/null and b/docs/images/admin-settings-general.png differ diff --git a/docs/images/admin-settings-piwik.png b/docs/images/admin-settings-piwik.png new file mode 100644 index 0000000000..c093a9d4de Binary files /dev/null and b/docs/images/admin-settings-piwik.png differ diff --git a/docs/images/admin-statistics.png b/docs/images/admin-statistics.png new file mode 100644 index 0000000000..b78912748d Binary files /dev/null and b/docs/images/admin-statistics.png differ diff --git a/docs/release-notes.md b/docs/release-notes.md index c09c78217a..010595f418 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -2,7 +2,7 @@
Infrastructure Changes
-* Zanata now uses Infinispan as its cache provider, and the cache needs to be configured in Jboss' `standalone.xml` file. Please see the [Infinispan](configuration/infinispan) section for more information. +* Zanata now uses Infinispan as its cache provider, and the cache needs to be configured in Jboss' `standalone.xml` file. Please see the [Infinispan](user-guide/system-admin/configuration/infinispan) section for more information. * This release adds a one-time migration of some data, which can cause a timeout during server startup. This applies to all plain text and libreoffice formats, so is only a concern for servers that are upgrading from an earlier version and diff --git a/docs/user-guide/admin/admin-overview.md b/docs/user-guide/admin/admin-overview.md index 347fc080c9..d1e1536b99 100644 --- a/docs/user-guide/admin/admin-overview.md +++ b/docs/user-guide/admin/admin-overview.md @@ -13,43 +13,51 @@ To access to admin menu, login to Zanata with admin role user, select `Administr
-## Server configuration +### Server configuration Configuration and settings for Zanata server. -## Manage users +See [server configuration](user-guide/admin/server-config) for more information. + +### Manage users - Edit user information such as password, roles. - Delete users in Zanata. -## Manage Roles +### Manage Roles - Create new roles to Zanata. - Edit/Remove roles in Zanata. -## Manage Search +### Manage Search + +Reindexing Zanata database used for searching. -- Reindexing Zanata database used for searching. +See [Manage search](user-guide/admin/manage-search) for more information. -## Role assignment rules +### Role assignment rules See [Role assignment rules](user-guide/admin/role-assignment-rules) for more information. -## Translation memory +### Translation memory - Import/Export external TMX file for translation memory in editor. -## Process manager +### Process manager -- See all background asynchronous tasks running in Zanata. +All background asynchronous tasks running in Zanata. -## Overall statistic +See [Process manager](user-guide/admin/process-manager) for more information. + +### Overall statistic Overall general statistics of Zanata. -- Number of users, projects, documents and translations. +See [Statistic](user-guide/admin/statistic) for more information. + +### Server monitoring -## Server monitoring +Server performance and statistics. -- Server performance and statistics. \ No newline at end of file +See [Monitoring](user-guide/admin/monitoring) for more information. \ No newline at end of file diff --git a/docs/user-guide/admin/manage-search.md b/docs/user-guide/admin/manage-search.md new file mode 100644 index 0000000000..52f9a70deb --- /dev/null +++ b/docs/user-guide/admin/manage-search.md @@ -0,0 +1,23 @@ +
+Process manager +
+
+ +Zanata uses lucene index for fast searching and perform various tasks such as translation memory search. + +### Purge index + +Mark all existing index entries for the table obsolete. Obsolete entries still occupy disk space but are not returned in any searches. + +### Reindex + +Index all rows in the given table. Rows will be indexed automatically when data is persisted, so this operation is only necessary when the index is out-of-date (e.g. when the database has been restored from backup, after a failed reindex, if index files have been removed). + +All rows of the given table will be reindexed regardless whether they already have an entry in the index. Rows that have already been indexed will have their entries updated, which will usually have no effect on the entry. + +**Warning:** This operation can take hours for large tables, and will increase memory use significantly above baseline. It is strongly recommended to run this operation during off-peak times when average server memory use is at a minimum. + +### Optimize + +This arrange index entries to maximize search speed and also removes any obsolete entries from the index. +This operation will not influence indexing time. \ No newline at end of file diff --git a/docs/user-guide/admin/monitoring.md b/docs/user-guide/admin/monitoring.md new file mode 100644 index 0000000000..4a7868d6eb --- /dev/null +++ b/docs/user-guide/admin/monitoring.md @@ -0,0 +1,7 @@ +
+Monitoring +
+
+ +* Zanata uses [Java Melody](https://code.google.com/p/javamelody/) for performance and statistic monitoring. + diff --git a/docs/user-guide/admin/process-manager.md b/docs/user-guide/admin/process-manager.md new file mode 100644 index 0000000000..f915482a36 --- /dev/null +++ b/docs/user-guide/admin/process-manager.md @@ -0,0 +1,8 @@ +All asynchronous tasks that are running in the background are shown in this page. + +
+Process manager +
+
+ +* Admin also have the authority to terminate any running process shown in this page. diff --git a/docs/user-guide/admin/server-config.md b/docs/user-guide/admin/server-config.md new file mode 100644 index 0000000000..14f5d08981 --- /dev/null +++ b/docs/user-guide/admin/server-config.md @@ -0,0 +1,64 @@ +## General + +General configuration for Zanata server. + +
+Admin settings general +
+
+ +1. Server URL - The base URL for Zanata server including the application context path. +2. Register URL - The user registration URL for the server. +3. Email Domain name - Domain name used for email address. +4. Contact Admin address - Email address for Zanata admin. +5. From Email Address - Email address of 'From' field in all email sent from Zanata. +6. Terms of Use URL - URL for terms of use statement. +7. Help URL - URL for help page. + + + +------ + +## Email log + +This enables or disables the sending of Zanata diagnostics log information via email. + +
+Admin settings email log +
+
+ +1. To enable, click on `Enabled` checkbox. +1. Select log level to send email. `Error` will only send error messages, while `Warning` will send both warning and error messages. +1. Fill in email address (comma separate for multiple email address) in provided text field. +1. Click `Save` at the bottom of the page for save changes. + + +------ + +## Piwik + +[Piwik](http://piwik.org/) is a web analytics tools application. It tracks online visits to one or more websites and displays reports on these visits for analysis. + +
+Admin settings piwik +
+
+ +1. Fill in your hosted piwik url and id to enable Piwik. + + +------ + +## Client + +Admin can control the limit of client communication towards server via Client or REST API. + +
+Admin settings client +
+
+ +1. Max concurrent requests per API key - Once over the limit server will return status code 403. 0 means no limit. Default(blank) is 6. +1. Max active requests per API key - Request may block. 0 means no limit. Default(blank) is 2. If this is greater than max concurrent request limit, it will have no effect. +1. Max files per upload - Maximum number of files a user can queue for upload in the web upload dialog. \ No newline at end of file diff --git a/docs/user-guide/admin/statistic.md b/docs/user-guide/admin/statistic.md new file mode 100644 index 0000000000..604d5064a0 --- /dev/null +++ b/docs/user-guide/admin/statistic.md @@ -0,0 +1,11 @@ +
+Statistic +
+
+ +This page shows the number of + +- translators and reviewers in Zanata +- projects and versions hosted in Zanata +- documents uploaded to Zanata +- translations in Zanata \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index a5dbdf363f..aa1ef68fa3 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -10,6 +10,7 @@ use_directory_urls: false pages: - ['index.md', 'Home'] +- ['release-notes.md', 'Release notes', 'Release notes'] # Getting started - ['user-guide/translator-guide.md', 'Getting Started', 'Translator Guide'] - ['user-guide/project-maintainer-guide.md', 'Getting Started', 'Project Maintainer Guide'] @@ -77,7 +78,13 @@ pages: ## Admin - ['user-guide/admin/admin-overview.md', 'Admin', 'Overview'] - ['user-guide/admin/contact-admin.md', 'Admin', 'Contact Admin'] +- ['user-guide/admin/server-config.md', 'Admin', 'Server configuration'] +- ['user-guide/admin/manage-search.md', 'Admin', 'Manage search'] +- ['user-guide/admin/process-manager.md', 'Admin', 'Process manager'] - ['user-guide/admin/role-assignment-rules.md', 'Admin', 'Role assignment rules'] +- ['user-guide/admin/statistic.md', 'Admin', 'Statistic'] +- ['user-guide/admin/monitoring.md', 'Admin', 'Monitoring'] +## TODO: tmx, Manage users, Manage roles # System admin - ['user-guide/system-admin/configuration/installation.md', 'System Admin', 'Installation'] - ['user-guide/system-admin/configuration/authentication.md', 'System Admin', 'Authentication'] @@ -87,6 +94,7 @@ pages: - ['user-guide/system-admin/configuration/infinispan.md', 'System Admin', 'Caches'] - ['user-guide/system-admin/configuration/jms-messaging.md', 'System Admin', 'JMS Messaging'] +# UI bug, last entry does not show in the list, using it to push JMS Messaging up - ['release-notes.md'] copyright: Copyright © 2015, Red Hat.