##// END OF EJS Templates
docs: added SAML documentation....
docs: added SAML documentation. - Remove few obsolete replaces - update authentication docs - cleanups and fixes

File last commit:

r3290:ac4e4e5a default
r3290:ac4e4e5a default
Show More
241 lines | 7.4 KiB | text/x-rst | RstLexer

One-time Admin Tasks

Adding Web Analytics

If you wish to add a Google Analytics, or any other kind of tracker to your |RCE| instance you can add the necessary codes to the header or footer section of each instance using the following steps:

  1. From the |RCE| interface, select :menuselection:`Admin --> Settings --> Global`
  2. To add a tracking code to you instance, enter it in the header or footer section and select Save

Use the example templates in the drop-down menu to set up your configuration.

Licence Key Management

To manage your license key, go to :menuselection:`Admin --> Settings --> License`. On this page you can see the license key details. If you need a new license, or have questions about your current one, contact support@rhodecode.com

Server-wide Announcements

If you need to make a server-wide announcement to all users, you can add a message to be displayed using the following steps:

  1. From the |RCE| interface, select :menuselection:`Admin --> Settings --> Global`
  2. To add a message that will be displayed to all users, select :guilabel:`Server Announcement` from the drop-down menu and change the var message = "TYPE YOUR MESSAGE HERE"; example line.
  3. Select :guilabel:`Save`, and you will see the message once your page refreshes.
Server Wide Announcement

Suppress license warnings or errors

In case you're running on maximum allowed users, RhodeCode will display a warning message on pages that you're close to the license limits. It's often not desired to show that all the time. Here's how you can suppress the license messages.

  1. From the |RCE| interface, select :menuselection:`Admin --> Settings --> Global`
  2. Select :guilabel:`Flash message filtering` from the drop-down menu.
  3. Select :guilabel:`Save`, and you will no longer see the license message once your page refreshes.

Markdown or RST Rendering

|RCE| can use Markdown or reStructured Text in commit message, code review messages, and inline comments. To set the default to either, select your preference from the drop-down menu on the :menuselection:`Admin --> Settings --> Visual` page and select :guilabel:`Save settings`.

Enabling Repository Statistics

To enable |repo| statistics, use the following steps:

  1. From the |RCE| interface, open :menuselection:`Admin --> Repositories` and select :guilabel:`Edit` beside the |repo| for which you wish to enable statistics.
  2. Check the :guilabel:`Enable statistics` box, and select :guilabel:`Save`

Enabling Server-side Merging

To enable server-side merging, use the following steps:

  1. From the |RCE| interface, open :menuselection:`Admin --> Settings --> VCS`
  2. Check the :guilabel:`Server-side merge` box, and select :guilabel:`Save Settings`

If you encounter slow performance with server-side merging enabled, check the speed at which your server is performing actions. When server-side merging is enabled, the following actions occurs on the server.

  • A |pr| is created in the database.
  • A shadow |repo| is created as a working environment for the |pr|.
  • On display, |RCE| checks if the |pr| can be merged.

To check how fast the shadow |repo| creation is occurring on your server, use the following steps:

  1. Log into your server and create a directory in your |repos| folder.
  2. Clone a |repo| that is showing slow performance and time the action.
# One option is to use the time command
$ time hg clone SOURCE_REPO TARGET

Remap and Rescan Repositories

You may want to Remap and rescan the |repos| that |RCE| is managing to ensure the system is always up-to-date. This is useful after importing, deleting, or carrying out general cleaning up operations. To do this use the following steps:

  1. From the |RCE|, open :menuselection:`Admin --> Settings --> Remap and rescan`
  2. Click :guilabel:`Rescan Repositories`

Check the additional options if needed:

Adding Custom Hooks

To add custom hooks to your instance, use the following steps:

  1. Open :menuselection:`Admin --> Settings --> Hooks`
  2. Add your custom hook details, you can use a file path to specify custom hook scripts, for example: pretxnchangegroup.example with value python:/path/to/custom_hook.py:my_func_name
  3. Select :guilabel:`Save`

Also, see the RhodeCode Extensions section of the :ref:`rc-tools` guide. RhodeCode Extensions can be used to add additional hooks to your instance and comes with a number of pre-built plugins if you chose to install them.

Clearing |repo| cache

If you need to clear the cache for a particular |repo|, use the following steps:

  1. Open :menuselection:`Admin --> Repositories` and select :guilabel:`Edit` beside the |repo| whose cache you wish to clear.
  2. On the |repo| settings page, go to the :guilabel:`Caches` tab and select :guilabel:`Invalidate repository cache`.

Changing Default Language

To change the default language of a |RCE| instance, change the language code in the :file:`/home/{user}/.rccontrol/{instance-id}/rhodecode.ini` file. To do this, use the following steps.

  1. Open the :file:`rhodecode.ini` file and set the required language code.
## Optional Languages
## en(default), de, fr, it, ja, pl, pt, ru, zh
lang = de
  1. Restart the |RCE| instance and check that the language has been updated.
$ rccontrol restart enterprise-2
Instance "enterprise-2" successfully stopped.
Instance "enterprise-2" successfully started.

Setting Repositories to Publish

To automatically promote your local |repos| to public after pushing to |RCE|, enable the :guilabel:`Set repositories as publishing` option on the :menuselection:`Admin --> Settings --> VCS` page.


This option is enabled by default on most |RCE| versions, but if upgrading from a 1.7.x version it could be disabled on upgrade due to inheriting older default settings.

Pinging the |RCE| Server

You can check the IP Address of your |RCE| instance using the following URL: {instance-URL}/_admin/ping.

$ curl https://your.rhodecode.url/_admin/ping
pong[rce-7880] =>