Rapid Service Indicator

This option in the Server Admin Utility allows you to build the RSI index for both serials and monographs. For more information, refer to the SFX APIs section of the SFX Advanced User’s Guide.

To configure the RSI:
  1. Change config/sfxctrl.config to use the RSI index:
    1. Access the server as an instance user (for example, sfxlcl41).
    2. Type cn to move to the configuration directory.
    3. Type vi sfxctrl.config and make sure that the extra section has the following line:

use_RSI "Y"

  1. Build the RSI table:
    1. Access the server as an instance user (for example, sfxlcl41).
    2. Type da to move to the admin directory.
    3. Start the Server Admin Utility by typing ./server_admin_util.
    4. Select option 11 Build RSI index. The Build RSI index menu is displayed:

RSI Tools

1 (Re)build the RSI index

2 Show scheduled RSI index builds

3 Schedule an RSI index build

Please select [1-3,q,m]:

  1. Select option 1 (Re)build the RSI index. The following screen is displayed:

Running the index builder may take a long time, possibly hours depending on the amount of active portfolios.

Are you sure you want to continue? [y/n] y

Select type of RSI index to build. Select (s) for serials, (m) for monographs or (b) for both [s/m/b]: [b]
  1. Type the type of RSI index you want to build. If you select m or b the following is displayed:

RSI index build for monographs can be either 'complete' or 'incremental' (recommended because of performance).

Type (i) for incremental build, or (c) for complete build [i/c]: [i]

  1. Type i to perform an incremental build and c to perform a complete build. If you type i, the following is displayed:

It is recommended to do a complete build at night or during server 'slow' time because of significant load on the server.

In case incremental build cannot be performed, do you want to run complete build instead? [y/N]

  1. Type y or n to start the build.

For more information on configuring the RSI, refer to the Configuring the Rapid Service Indicator section of the SFX Advanced User’s Guide.

You can also set up a cron job so that RSI runs at a scheduled time.

To set up a cron job for RSI:
  1. Access the server as an instance user (for example, sfxlcl41).
  2. Type da to move to the admin directory.
  3. Start the Server Admin Utility by typing ./server_admin_util.
  4. Select option 11 Build RSI index. The Build RSI index menu is displayed:

RSI Tools

1 (Re)build the RSI index

2 Show scheduled RSI index builds

3 Schedule an RSI index build

Please select [1-3,q,m]:

  1. Select option 3 Schedule an RSI index build.
This task cannot be scheduled when Centralized Management of Maintenance Tasks is activated. If you attempt to do so, the following is displayed: Maintenance tasks can be scheduled only by the system administrator of this SFX installation. This option is not available for local SFX instances.

The following screen is displayed. (Bold text is typed by the user):

Select type of RSI index to build. Select (s) for serials, (m) for monographs or (b) for both [s/m/b] -> default is both: [b]

  1. Type the type of RSI index you want to build. If you select m or b the following is displayed:

RSI index build for monographs can be either 'complete' or 'incremental' (recommended because of performance).

Type (i) for incremental build, or (c) for complete build [i/c]: [i]

  1. Type i to perform an incremental build and c to perform a complete build. If you type i, the following is displayed:

In case incremental build cannot be performed, do you want to run complete build instead?

It is recommended to do a complete build at night or during server 'slow' time because of significant load on the server. [y/N]

  1. Type y or n. The following is displayed. (Bold text is typed by the user):

Please enter scheduling parameters

Time must be in the form HH:MM where

HH can be: 00-23 for midnight-11PM or * for every hour

MM can be: 00-59 or * for every minute

Enter the time to run [00:00]:00:00

Would you like to schedule for a certain weekday? [Y/n] N

Please enter month (1-12 for January-December respectively or '*' for every month) [*]: *

Please enter day of the month (1-31 or '*' for every day) [1]: 1

Successfully added the refresh task to your crontab.

To remove a cron job that has been set up for RSI:
  1. Access the server as an instance user (for example, sfxlcl41).
  2. Type da to move to the admin directory.
  3. Start the Server Admin Utility by typing ./server_admin_util.
  4. Select11 Build RSI index. The Build RSI index menu is displayed:

RSI Tools

1 (Re)build the RSI index

2 Show scheduled RSI index builds

3 Schedule an RSI index build

Please select [1-3,q,m]:

  1. Select 2 Show scheduled RSI index builds to view scheduled RSI index builds. The following screen is displayed:

RSI indexing schedule is as follows:

[1] RSI Journals + Books - incremental only - 00:00 of every Sunday of every month

[2] RSI Journals + Books - incremental only - 13:00 of every day of every month

Would you like to remove any of these? [y/N]

  1. Type y to remove an index build.
If your instance has been set up to use services from another instance via Consortia API, add a section for RSI in the config/consortium.config file of your instance.

More information can be found in the Setting Up Model 2: Using a Shared SFX Instance sectionof theUsing SFX in a Consortium Environment document.

For more information, refer to the SFX APIs section of the SFX Advanced User Guide.