Tuleap 11.x ########### Tuleap 11.18 ============ Nothing to mention. Tuleap 11.17 ============ Globals settings are no longer loaded into the global scope ----------------------------------------------------------- Settings defined in ``/etc/tuleap/conf/local.inc`` are no longer accessible via ``$GLOBALS``. If you have customized some ``txt`` or ``php`` files in ``/etc/tuleap/site-content/``, you need to replace every occurrence of ``$GLOBALS['']`` by ``\ForgeConfig::get('')``. Occurrences of ``$GLOBALS['Language']`` must not be replaced. Tuleap 11.16 ============ Better integration between the Agile Dashboard and the Test Management plugins ------------------------------------------------------------------------------ This release introduces a new plugin that brings a deeper and better integration between the :ref:`Agile Dashboard ` and the :ref:`Test Management ` plugins. To get it, install the `tuleap-plugin-testplan` package and activate it in the site administration. For more information about plugins installation, see :ref:`install-plugins`. The previous integration has been removed, so if you were using it you will need to install the new Test Plan. This new plugin is part of :ref:`Tuleap Entreprise `. Tuleap 11.15 ============ Nothing to mention. Tuleap 11.14 ============ Update to PHP Redis 5 --------------------- Until now was depending on PHP Redis 4. To do the upgrade you will first need to remove it. When you apply the :ref:`update instructions `, the ``yum update`` part must be replaced by: .. sourcecode:: shell #> yum shell -y <`. New plugin available -------------------- A new plugin :ref:`OAuth2 and OpenIDConnect Provider ` (Tuleap Enterprise only) is available. The correponding RPM package name is ``tuleap-plugin-oauth2-server``. Test Management repository -------------------------- If you are running Tuleap Enterprise Edition, you should remove the ``[Tuleap-testmanagement]`` section from ``/etc/yum.repos.d/Tuleap.repo``. It's no longer needed. Tuleap 11.13 ============ Nothing to mention. Tuleap 11.12 ============ Nothing to mention. Tuleap 11.11 ============ Missing timers to process some system event queues on CentOS/RHEL7 ------------------------------------------------------------------ Some system event queues were not processed due to missing timers, administrators must enable them manually. .. code-block:: bash $ sudo systemctl enable tuleap-process-system-events-statistics.timer $ sudo systemctl start tuleap-process-system-events-statistics.timer $ sudo systemctl enable tuleap-process-system-events-tv3-tv5-migration.timer $ sudo systemctl start tuleap-process-system-events-tv3-tv5-migration.timer If you have the Git plugin installed, you must also enable this one: .. code-block:: bash $ sudo systemctl enable tuleap-process-system-events-grokmirror.timer $ sudo systemctl start tuleap-process-system-events-grokmirror.timer Tuleap 11.10 ============ End of support of Digest authentication against Gerrit servers -------------------------------------------------------------- Tuleap is no more able to use Digest authentication against a Gerrit server. If you had configured a Gerrit server to use Digest authentication in Tuleap, it has been automatically migrated to use Basic authentication. Note that if you are affected by this change in any way you should consider upgrading your Gerrit server to a supported version (Gerrit 2.16 or ulterior), support of Digest authentication has been removed in Gerrit 2.14. Tuleap 11.9 =========== Changes on REST endpoint to create projects ------------------------------------------- REST route POST /projects has been reworked : - it does no longer need the delegation permission of REST administrator to be used (but it respects project configuration rule and check if user can create new projects). - you can specify trove categories and project field at creation, if they are required and not provided in payload, the REST call will fail. Tuleap 11.8 =========== Nothing to mention. Tuleap 11.7 =========== Major update on Docman REST routes ---------------------------------- The route GET docman_items/:id/docman_items was returning too much data: - for link the link url were returned - for embedded file, the embedded file content were returned Having such info directly accessible without querying docman_items/:id prevented us to take into account user accesses to a document. That's why we needed to update our API and remove these keys from the route results. If you need to access them, please call docman_items/id. Distributed SVN --------------- You should manually mark tuleap-svn-updater as active on RHEL7 SVN server: .. code-block:: bash $ sudo systemctl enable tuleap-svn-updater.service Note about custom plugins ------------------------- On our duty to clean the codebase, we renamed the base file of our plugins. If you encounter errors during cache regeneration, you should issue the following command: .. sourcecode:: bash rm /var/tmp/tuleap_cache/tuleap_hooks_cache If you have custom internal plugins, then you must rename the base file of the plugin and remove the ``.class`` from the extension. For example if you have a plugin ``acme``, then you must rename ``plugins/acme/include/acmePlugin.class.php`` to ``plugins/acme/include/acmePlugin.php``. Tuleap 11.6 =========== RabbitMQ dependency removed --------------------------- For platforms leveraging Distributed SVN, this should be completely transparent as the queue management was transferred to Redis that you should already be running. To ensure everything is working smoothly after upgrade, create a new svn repository and ensure the event is properly propagated (ie repository is created and accessible on the SVN server). Removal of copyright and powered_by .tab entries ------------------------------------------------ The following ``.tab`` entries has been removed: * ``global copyright`` (Default to Copyright Enalean) * ``global powered_by`` (Default to Tuleap) You should check that everything is ok in the footer "about" block. If you see "*** Unknown message …***", then you must edit ``/etc/tuleap/site-content/en_US/layout/footer_about.php`` file and adjust it to your liking. Tuleap 11.5 =========== Project level information about the document manager plugin given by the REST route `GET /project/:id` has moved ---------------------------------------------------------------------------------------------------------------- API users that were exploiting the REST endpoint `GET /project/:id` to retrieve project level information needs to migrate to the REST endpoint `GET /project/:id/docman_service`. Tuleap 11.4 =========== End of support of PHP 7.2 ------------------------- Tuleap now comes with PHP 7.3. All new installations defaults to this setup. To switch on it, you first need to deploy the PHP FPM configuration for PHP 7.3. .. sourcecode:: bash /usr/share/tuleap/tools/utils/php73/run.php --module=fpm Then stop the PHP FPM service running with PHP 7.2 and start a new one running with PHP 7.3. On RHEL/CentOS 7: .. sourcecode:: bash systemctl daemon-reload systemctl restart tuleap-php-fpm On RHEL/CentOS 6: .. sourcecode:: bash service php72-php-fpm stop chkconfig php72-php-fpm off service php73-php-fpm start chkconfig php73-php-fpm on # Useful if you want the service to be started on boot If you have made some tweaks to the configuration file ``/etc/opt/remi/php72/php-fpm.d/tuleap.conf`` you will also needs to adapt them for the new configuration at ``/etc/opt/remi/php73/php-fpm.d/tuleap.conf``. New PHP FPM pool to process long running requests ------------------------------------------------- Tuleap now uses a dedicated PHP FPM pool to process long running requests such as file uploads. A few manual actions is needed: In the nginx configuration file ``/etc/nginx/conf.d/tuleap.conf`` replace the ``upstream`` block by: .. sourcecode:: nginx upstream tuleap-apache { server 127.0.0.1:8080; } upstream tuleap-php-fpm { server 127.0.0.1:9000; } upstream tuleap-php-fpm-long-running-request { server 127.0.0.1:9002; } Do not forget to also redeploy the configuration managed by Tuleap for nginx and restart the service (as for a standard Tuleap update). On RHEL/CentOS 7: .. sourcecode:: bash /usr/share/tuleap/tools/utils/php73/run.php --module=nginx systemctl restart nginx On RHEL/CentOS 6: .. sourcecode:: bash /usr/share/tuleap/tools/utils/php73/run.php --module=nginx service nginx restart Removal of the function ``\get_server_url()`` --------------------------------------------- The function ``\get_server_url()`` has been removed and must be replaced by ``\HTTPRequest::instance()->getServerUrl()``. This change impacts you if you have customized one of the following site-content files: - ``site-content/en_US/mail/html_template.php`` - ``site-content/en_US/project/tos.txt`` - ``site-content/fr_FR/project/tos.txt`` - ``site-content/en_US/tos/privacy.txt`` - ``site-content/fr_FR/tos/privacy.txt`` Tuleap 11.3 =========== Nothing to mention. Tuleap 11.2 =========== Max file size change when uploading an item to the document manager through Webdav ---------------------------------------------------------------------------------- The max file size when uploading an item to the document manager is now global to the document manager plugin for all type of accesses. This means that the max file size limit that is defined in the configuration file ``/etc/tuleap/plugins/webdav/etc/webdav.inc`` is not used anymore for the document manager. Instead, you can change the max allowed size of a file in the document manager plugin from the site administration. Distributed SVN Setups ---------------------- After move of svn plugin to "front controller" pattern, nginx configuration must be adapted so svn server can continue to serve the web browsing of svn repo (it's not necessary if svn server is setup only to serve svn tools related traffic). On svn server, you should remove the previous ``location ^~ /plugins/svn { ... }`` block and add the following snippet: .. sourcecode:: nginx root /usr/share/tuleap/src/www; index index.php; location /index.php { include fastcgi_params; fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param DOCUMENT_ROOT $realpath_root; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; } location / { try_files $uri $uri/ /index.php?$args; } location ^~ /plugins/svn/ { alias /usr/share/tuleap/plugins/svn/www/; if (!-f $request_filename) { rewrite ^ /index.php last; } } Tuleap 11.1 =========== Missing scheduled jobs on CentOS/RHEL7 -------------------------------------- Some jobs were missing on CentOS/RHEL7 instances and as result some actions might not work. You will need to enable and start those jobs: .. sourcecode:: shell #> systemctl enable tuleap-launch-daily-event.timer #> systemctl enable tuleap-launch-plugin-job.timer #> systemctl start tuleap-launch-daily-event.timer #> systemctl start tuleap-launch-plugin-job.timer Tuleap 11.0 =========== Changes in the document manager REST routes ------------------------------------------- If you have started using the ``POST docman_items`` route, you should adapt your code. In order to have easier to use routes, it has been split in smaller routes: - ``POST /docman_folders/{id}/files``: Create a new file - ``POST /docman_folders/{id}/empties``: Create a new empty document - ``POST /docman_folders/{id}/wikis``: Create a new wiki document - ``POST /docman_folders/{id}/links``: Create a new link document - ``POST /docman_folders/{id}/folders``: Create a new folder Full Text Search plugin removal ------------------------------- The plugin was deprecated for a while and has been removed. The plugin will not be available on your instance after your upgrade.