Razor administration via scripts

If you are a prior Razor UNIX administrator and are comfortable with the scripts, you can stick with that administration method. You still should read through this section as it contains differences unique to WindowsNT under the POSIX subsystem.

Installing license keys

In order for Razor to run, you must now obtain and install some license keys. Demo keys may be obtained automatically via Tower's Web site at http://www.tower.com/keys.html. Demo keys will permit you approximately three weeks to evaluate Razor. If you have problems or do not have access to the Internet, contact Tower Concepts either via e-mail at "licenses@tower.com" or by phone at (315) 363-8000.

Permanent keys are obtained directly from Tower Concepts. To get the keys, you will need to provide the Razor identification for the machine that will be hosting the Razor license manager. Follow the steps below to provide Tower Concepts with the appropriate information required for licensing your machine.¹

• Start a "Razor csh" from the Razor program group. All subsequent instructions requiring command line interaction should be done from this window.
• Run the following command to get host information required for your license keys.

  % $RAZOR_HOME/bin/razor id
  
  

• Send the result of this command to `licenses@tower.com' requesting license keys. If you are demoing Razor, you can generate your own temporary license keys via Tower's Web site at http://www.tower.com/keys.html.
• Once you receive the license keys from Tower Concepts, run the following command. Take care to enter the keys correctly and with the correct case.

  % $RAZOR_HOME/bin/razor license
  

Starting the programs

Starting the license manager

• Run "Shortcut to Services" from the Razor program group.
• Select "Razor License Manager".
• Start the "Razor License Manager" service by clicking on "Start".

NOTE: To automatically start the Razor license manager at boot time, change the startup option from "manual" to "automatic"

Starting Syslogd

• Run "Shortcut to Services" from the Razor program group.
• Select "Razor Syslog Manager".
• Start the "Razor Syslog Manager" service by clicking on "Start".

Database creation

Running rz_new_database

To create a database, invoke the script rz_new_database from within a "Razor csh" as follows, responding to the prompts accordingly...

% $RAZOR_HOME/scripts/rz_new_database

Within the limits of system resources any number of databases may be created on the Razor host.

Sample database creation

In the example below, a database called "Starguide" will be created in //D/TowerConcepts/razor_db.

1. Start a "Razor csh" from the Razor program group. All subsequent instructions requiring command line interaction should be done from this window.

2. Follow the rz_new_database script as follows:

% cd $RAZOR_HOME
% cd ..
% mkdir razor_db
% mkdir razor_db/Starguide
% rz_new_database
Checking your configuration...


The Razor database contains all of the files related to the Razor 
programs. It is accessed by all users of these programs.

Where should I install your Razor database? razor_db/Starguide2

Creating the default issues group (++ISSUES++)...


Will you be using this database for file version control
and/or build management? [y] 

Razor groups are created to contain related information for teams 
(groups) of users.  To start with, you must define at least one 
Razor group.  Additional groups may be added later by executing 
the script `rz_add_group'.

What is the name of your first group: Devel3

The group `Devel' has been successfully added to the Razor 
database.


The PROJECT group has been added to the Razor database.4


The database server for this database will now be installed as an 
NT service.  This requires your password.

Please take care that you enter your password correctly and 
remember that case matters.

Password for user [Administrator] : xyz


Service Logon privileges have been granted to user 
Razor\Administrator. To revoke these privileges, use "service 
revoke `Razor\Administrator'".
The Posix service "RazorDB_Starguide" has been successfully 
installed. To start the service, use "service start 
RazorDB_Starguide".


Installation complete. Additional setup information is in the 
file:

//D/TowerConcepts/razor_db/Starguide/RAZOR_UNIVERSE/
rz_new_database.info

Would you like to display it now? [y] n

Starting the database server

To start the database server service, perform the following:

• Run "Shortcut to Services" from the Razor program group.
• Select "RazorDB_<database>", where <database> is the name of the database you wish to start.
• Start the database service by clicking on "Start".

NOTE: To automatically start the database server at boot time, change the startup option from "manual" to "automatic"

Razor passwords

Refer to "Remote client password" on page 45 and "Password functions" on page 158 for details on creating and maintaining Razor passwords.

Administering databases

Database administration includes direct maintenance (editing) of various configuration files within the database hierarchy. These files are, and must remain, in POSIX text format. The Razor shells provide the vi editor but Razor administrators are free to use any editor of their liking as long as the file, once edited, remains in POSIX text format. Use of the vi editor is strongly encouraged since that editor maintains the correct text file format.

¹ New installations will automatically be provided with the required license information via Notepad. This information should be copied to an e-mail which should be sent to `licenses@tower.com'.
² The script will look at your present configuration and ask some simple questions. Except under very unusual circumstances, you should accept the defaults you are offered as shown in the square brackets "[]".
³ A Razor group should not be confused with a UNIX group: they are different beasts. See "Databases, groups, and attributes" on page 31 and "Containers: databases, groups, and folders" on page 183.
⁴ The PROJECT group is used by the threads tool to manage a collection of related threads (a thread of threads). See "Projects: Thread of threads" on page 143.