Creating Additional Instances

Three instances are provided with the basic installation of SFX 4. If you have purchased licenses for additional instances, you can create these instances at the time of the initial installation, or you can choose to create them later. For more information about additional licenses and instances, contact your Ex Libris representative.

The following instructions describe the process of creating additional instances after the basic installation is complete. Note that you must have additional license keys provided to you by Ex Libris in order to create additional instances.

To create additional local instances:
  1. Log on to the server as the root user.
  2. Load the environment variables of the sfxglb41 user:

tcsh

source ~sfxglb41/.cshrc

  1. Move to the directory of the create_instance script:

da

cd imanager/

  1. Run the create_instance script using the following information:
  • The instance template to be used to create the instance (sfxglb41 is recommended)
  • The license key provided to you by Ex Libris
  • The MySQL root password for the server: dbrootpassword
  • The MySQL password to be assigned to the new instance: dbinspassword

For example, type the following command (on one line):

create_instance.sh --template=sfxglb41

--license=332372f333e29393e273c7c69626279637c74363c7c7

e6f6f556870727563737c7534333535303236303

--dbrootpassword=xxxxxxxx --dbinspassword=newinstancename

After creating a new instance, restart MySQL if the instance is used as a shared instance in Consortia model 2.

For more information on Consortia model 2, refer to the document Using SFX in a Consortium Environment. For more information on stopping and restarting MySQL, see Start/Stop Services .

After creating a new instance, make sure that all database triggers are in place for the new instance:

  1. Log on to the server as the sfxglb41 user.
  2. Type da.
  3. Type ./server_admin_util.
  4. Select 13 TRACKING table set-up and maintenance and then 1 Check status of TRACKING table and triggers.
  5. Restart the Proxy Apache and start the instance Apache using the Server Admin Utility. For more information, see Start/Stop Services .

If the triggers exist, then this instance has been set up to use the tracking table. Select 2 Create table and triggers to recreate the triggers for the new instance.

For more information on setting up the TRACKING table, see TRACKING Table Set-Up and Maintenance.

To display a help screen for the create_instance script, type:

create_instance.pl --help

The following is displayed:

create_instance.pl --help

Creates a new instance, includes a database and files.

Version:$Id: create_instance.pl,v 1.16 2004/11/09 16:50:26 jc_3 Exp$

usage: ./create_instance.pl --license= --dbrootpassword= [options]

--license=KEY License key for the new instance

--template=NAME Name of the instance to be used as a

template

--dbrootpassword=PASSWORD MySql root password

--dbinspassword=PASSWORD Password for the new instance

--verbose Print messages, default yes

--help This help