The toolkit comprise a set programs written mainly in Korn shell script, to aid in administering and using UNIX based systems with Roadtech software. Roadrunner and related software. Bundled with a small set of binaries.
The scripts are generaly fairly tolerant of their install location, and the file system layout. To run you need symbolic links from one of the directories in the search path, the the key scripts in the directory to which they were instaled. They will mostly sort the rest out from there.
It is recommended that the host system is installed and configured in line with industry best practise as set out in the guides published by the NSA and CIS.
It is recommended that LVM is used to mange the storage space for multiple file systems. This follows practise on AIX systems, and allows space to be assigned as the system develops. The following is consistent with CIS guidelines.
| Mount Point | FS flags | Comment |
|---|---|---|
| / | Consider SSD. | |
| /boot | ||
| /home | nodev | If not a network share, consider SSD. |
| /ehome | nodev | Local directory for EDI user accounts. Consider SSD. |
| /lhome | nodev | Local accounts if /home is a network share. Consider SSD. |
| /tmp | nodev,nosuid,noexec | May be a RAM disk. Contents may be wiped on a reboot |
| /usr/share/roadtech | RoadTech scripts and data. Consider SSD. | |
| /var | ||
| /var/log | Aim for enough space for 4 weeks retention. | |
| /var/log/audit | Aim for enough space for 4 weeks retention. | |
| /var/tmp | nodev,nosuid,noexec |
Presuming that the system has the above layout of file systems the following directories, could be suitable choice for installing the scripts, and associated applications.
| Directory | Used for | Variable |
|---|---|---|
| /usr/share/roadtech/data | Roadrunner live data set. | RR_Dir |
| /usr/share/roadtech/testarea | Roadrunner test data set. | N/A |
| /usr/share/roadtech/RT_Admin | Roadtech scripts. | RT_Admin |
| /usr/share/roadtech/RT_Admin/bin | Programs or utilities shipped with the toolkit. | N/A |
| /usr/share/roadtech/RT_Admin/cgi-bin | Web Server extensions | IL_CGI |
| /var/www/ImageLibrary | Root for Website to serve images from. | IL_Dir |
| /var/www/ImageLibrary/pod_cache | Cache of recoded image files. | |
| /var/www/ImageLibrary/pod_images | Original document files. |
Only applicable to Linux. Scripts will all run on a system with SeLinux installed and enforcing the Targeted policy.
Variable set to account code of user who "owns" the scripts. Historically this is also the account that owns the COBOL run time, and the Roadrunner programs and data.
Set to group with permission to use scripts. Historically this is also the group that can invoke the COBOL run time.
Group with rights to view images. This is the group that the web server runs as. For Linux this is usually the group "apache".
Default value is datalink.
Used in an AIX cluster. Value defaults to "roadtech".
Scripts should work on a group of systems, that share /home, between them.
By means of a cluster file system, NFS, or autofs.
Theoretically it is possible to run RoadRunner off a cluster, where you have several compute nodes sharing the data via a cluster file system. As of 2010 I do not know any one using this arrangement. It is far more efficient to run on one node with adequate processing power and a fast storage subsystem.
Where it is available scripts use the tool getent to access security information,
whether from local files, or a shared directory via LDAP. Rather that accessing /etc/passwd directly.
This works well in conjunction with the shared home support noted above.
Yes there have been a number of releases, these can be identified by the code displayed at the top left of the menu screens. The code is based on the revision date of the script rr85.sh.
These notes are for the 2010 rewrite, unless you are QA testing you want these notes instead.
This depends on the version of both the operating system and roadrunner.
New version should support the following OS, to full or near full functionality.
The following should be supported with verying levels of functionality.
The version you are running can be distinguished by the date code displayed on the top left of the opening screen. If code ends "exp" it is a development version and should not be used on a production system.
Customers should in general be running a recent version.
Since the 2003 release the scripts have been written to use the library file setenv.lib, to configure options, and set environment variables to indicate the presence and locations of various hardware devices, and software packages.
If you are writing any scripts to use with RoadRunner see the notes from 2002-3.
To be useful the contents of a backup must be consistent. This is particulary important for database type applications such as RoadRunner. The backup scripts make checks for this, they will fail and record the failyer if any files within the sets being backued up change or are deleted during the backup.
All scripts that may change or remove files, must check for the existence of a backup flag, either global, per application, or specific to a single DATASET within an application. If the flag file exists then the script must exit gracfully without making changes.
All of the standard scripts will abort gracefully if a flag is found on any of these checks. No files shall, under any circumstances, be altered within the file tree of any DATASET, unless the corresponding flags for the DATAPATH, have been checked within the preceding second.
The menu options will change depending on :-
An obvious example of dynamic menus is backup.
There is a fundamental issue, the upgrade is performed using the current programs. It the new version contains enhancements that require different configuration then, an old update routine may not know about them.
Wherever possible the update routine of the current program set is updated first. To know about forthcoming changes. For this reason you should always use the built in update system, and avoid skipping a large number of intermediat versions.
Updates between version are normally small and the routines are written to allow live updating. If however you are skipping a lot of versions, I would suggest that the update is done after a backup, and with users off the system.
Secondly the suite includes check routines to validate the configuration.
Note current version, the version you are going to.
Note current configuration.
As the Road Tech administrative user, run RTadmin. Select the utilities menu. The select the Administration menu. Select the Update Menu
Select the update method that goes with the provided update media.
Wait 3 minutes before proceeding to the next step.
As the Administrative user. Go to the System utilities menu Select the option to "Show configuration"
If anything looks wrong, please provide a screen dump of the configuration, and what version you were upgrading from an to.
Exit the menus and fix via the system options file if possible.
Repeat if you changed anything.
As the Road Tech administrative user, run RTadmin. Select the utilities menu. The select the Dataset menu.
Select the option to "Show DATASET Settings">
If anything looks wrong, please provide a screen dump of the configuration, and what version you were upgrading from and to.
Exit the menus and fix via the roadrunner options file if possible.
Repeat if you changed anything.
If you have multiple datasets repeat for each set.
As the Administrative user. Go to the System utilities menu Go to the Check menu.
Select the option to "Check links and ownerships"
Option check things in phases. Some steps depend on what options have been installed.
| Obsolete files | Remove |
| symbolic links | |
| rt.var | If missing create, if out of date create new template as rt.var.new, exit for user to reconcile. |
| RTadminPerm | |
| rr.var | If missing create, if out of date create new template as rr.var.new, exit for user to reconcile. |
| RR permissions | If Roadrunner is installed set file permissions. |
| dataset.var | Per data set variables. If missing create, if out of date create new template as dataset.var.new, exit for user to reconcile. |
The scripts are either command line based, or display a menu. There are some that can be either.
Exact options and behaviour depend on who is running the utilities.
Command line scripts run from a prompt and may take optional arguments. They are mostly intended to run with out further user input.
All of the scripts and menus take a similar format.
18/02/2003 AIX Ver 4 rel 2
Default Print Queue := postscript
1 Media menu.
2 Print services.
3 Mail menu.
6 hostman's programme menu.
Q Quit.
[ ]
|
The top two lines contain a general data block giving a date code indicating the script version, the operating system and version, and the default print destination.
They are displayed by the library function menu_header
Additional header info may be displayed, that is relevant in the context of the menu.
For example the Roadrunner menus use the function menu_header_r to display information relevant to roadrunner.
RTedi uses the function menu_header_e to display relevant information at the top of the screen.
Main RoadTech Administration script, it is in some ways overworked :-)
Links are created in the program directory for the platform usually /usr/bin, under both names pointing to where this administrative program was installed.
The old name is reminder that these programs stared life back in 1990 purely to administer roadrunner on AIX.
When invoked on its own it displays a context sensitive menu. the exact options, depend on the type of system, the user who is running it, and what optional modules are installed on the system.
This is the script to start roadrunner. Links are created in the program directory for the platform usually /usr/bin, under both names pointing to where the administrative programs were installed.
Invoked on its own it will start roadrunner using the last DATASET used.
It may alternatively be invoked with an optional Parameter indicating
the
DATAPATH
to use.
rr /usr/share/rr85
One other variant exists, if the variable definition
MENU=TRUE
appears in the file $rrdir/rr.var a menu of the available
datasets will be built using the information from the file
$rrdir/.datapaths.
Road Tech EDI menu and scripts. RTedi
|
|