|     
|
n
RAdmin Migration Instructions
This document provides instructions on how to migrate from earlier versions
of RAdmin to the current one.
- Version 1.12 to 1.13. Version 1.13 adds one new table and 1 new
configuration parameter for supporting Yubikey tokens. There are several
new private cgi-bin scripts.
Caution:We recommend that you back up your Radmin database before migrating.
- Unpack the new 1.13 distribution into a work area.
- Copy Sql.pm from Radmin/Sql.pm in your 1.12 distribution to
Radmin/Sql.pm in your new 1.13 distribution.
- Copy Paths.pm from Radmin/Paths.pm in your 1.12 distribution to
Radmin/Paths.pm in your new 1.13 distribution.
- Run
perl createdb.pl -create RADYUBIKEY goodies/upgrade-1.12-1.13.dat.
This will create the new table without destroying
any existing data.
- As root, run
perl install.pl -d. This will
reinstall the RAdmin files to the same place on the web server
as they were previously installed.
- Version 1.11 to 1.12. Version 1.12 adds one new table and 2 new
configuration parameters for controlling RAdmin-authenticated Admin
User sessions.
Caution:We recommend that you back up your Radmin database before migrating.
- Unpack the new 1.12 distribution into a work area.
- Copy Sql.pm from Radmin/Sql.pm in your 1.11 distribution to
Radmin/Sql.pm in your new 1.12 distribution.
- Copy Paths.pm from Radmin/Paths.pm in your 1.11 distribution to
Radmin/Paths.pm in your new 1.12 distribution.
- Run
perl createdb.pl -create RADADMINSESSION goodies/upgrade-1.11-1.12.dat.
This will create the new table without destroying
any existing data.
- As root, run
perl install.pl -d. This will
reinstall the RAdmin files to the same place on the web server
as they were previously installed.
- Version 1.10 to 1.11. Version 1.11 includes some new permissions in
the database to control operations on Digipass tokens
- Unpack the new 1.11 distribution into a work area.
- Run
perl createdb.pl goodies/upgrade-1.10-1.11.dat
- As root, run
perl install.pl -d. This will install
the RAdmin files to the same place on the web server as they
were previously installed.
- The above procedures will establish new permissions for
administering Digipass tokens for the
admin profiles Everything and Staff.
Check that the permissions for your
admin profiles are as as required.
- Version 1.8 to Version 1.9
Version 1.9 adds 1 new table: RADDIGIPASS for managing
VASCO Digipass tokens (www.vasco.com), and allocating tokens to
users etc. Support for Digipass tokens is optional, but if you
enable it, it requires the
Authen::Digipass module, included with Raditor 3.10 or later.
Caution:We recommend that you back up your Radmin database before migrating.
- Unpack the new 1.9 distribution into a work area.
- Copy Sql.pm from Radmin/Sql.pm in your 1.8 distribution to
Radmin/Sql.pm in your new 1.9 distribution.
- Copy Paths.pm from Radmin/Paths.pm in your 1.8 distribution to
Radmin/Paths.pm in your new 1.9 distribution.
- Run
perl createdb.pl -create RADDIGIPASS goodies/upgrade-1.8-1.9.dat.
This will create the new table without destroying
any existing data.
- As root, run
perl install.pl -d. This will
reinstall the RAdmin files to the same place on the web server
as they were previously installed.
- Version 1.6 to Version 1.7
Version 1.7 adds 2 new tables: RADSQLRADIUS and RADSQLRADIUSINDIRECT for managing
Realm-based and CLID-based proxying, using SQL lookups. It also adds some permissions
for managing access to those tables.
Caution:We recommend that you back up your database before migrating.
- Unpack the new 1.7 distribution into a work area.
- Copy Sql.pm from Radmin/Sql.pm in your 1.6 distribution to
Radmin/Sql.pm in your new 1.7 distribution.
- Copy Paths.pm from Radmin/Paths.pm in your 1.6 distribution to
Radmin/Paths.pm in your new 1.7 distribution.
- Run
perl createdb.pl -create RADSQLRADIUS:RADSQLRADIUSINDIRECT:RADMINCONFDESCS:RADMINCONFIG goodies/upgrade-1.6-1.7.dat.
This will create the
new tables and permissions required by 1.7 without destroying
any existing data.
- As root, run
perl install.pl -d. This will
reinstall the RAdmin files to the same place on the web server
as they were previously installed.
- The above procedures will add permission for accessing the new tables to
the admin profile Everything.
- Version 1.5 to Version 1.6
Version 1.6 includes some new tables to support the new permissions
system and the new optional subscriptions system.
Caution:We recommend that you back up your database before migrating.
- Unpack the new 1.6 distribution into a work area.
- Copy Sql.pm from Radmin/Sql.pm in your 1.5 distribution to
Radmin/Sql.pm in your new 1.6 distribution.
- Copy Paths.pm from Radmin/Paths.pm in your 1.5 distribution to
Radmin/Paths.pm in your new 1.6 distribution.
- Run
perl createdb.pl -create RADPERMISSIONS:RADPROFILEPERMISSIONS:RADPRODUCTS:RADSUBSCRIPTIONS:RADAUTHLOG basicdb.dat. There will
be some errors reported. Ignore these. This will create the
new tables required by 1.6 and populate them, without destroying
any existing data.
- As root, run
perl install.pl -d. This will
reinstall the RAdmin files to the same place on the web server
as they were previously installed.
- The above procedures will establish new permissions for
the admin profiles Everything and Staff.
Other admin profiles will now have _no_ permissions.
Check that the permissions for your admin profiles are
as as required.
- Version 1.4 to Version 1.5
Version 1.5 included minor changes to some previously unused database
tables. You can install the upgrade to version 1.5 without having to
recreate your database with these commands executed as root in your
RAdmin work directory:
Caution:We recommend that you back up your database before migrating.
perl install.pl
perl createdb.pl -create RADATTRS:RADVALUES -dropfirst radattrs.dat
- copy goodies/AuthRADMIN.pm to your Radiator installation
These commands will leave your existing database untouched, but it
will recreate and populate the previously unused tables RADATTRS and
RADVALUES.
Other versions
In order to upgrade between any other versions, you will need to
dump your current database, install the new software and then
reload your old data:
Caution:We recommend that you back up your database before migrating.
cd to distribution directory of your current version
perl createdb.pl -dump >/tmp/radmin.dat
cd to distribution directory of your new version
follow full installation instructions for your new version
perl createdb.pl /tmp/radmin.dat
copy goodies/AuthRADMIN.pm to your Radiator installation
n |