Moving an Account

Moving an Account

Top  Previous  Next


Moving an account within the same QM environment usually requires nothing more than copying the entire account directory, changing the pathname in the QM.ACCOUNTS file and modifying any VOC records that reference the account pathname such as those describing locally catalogued subroutines for which the FULL.PATH option of the CATALOGUE command was used.


Moving an account to a different server is more complex and requires the steps below.


Note: It is essential that there are no QM sessions accessing a file while it is moved using an operating system level command. Failure to observe this rule may result in file corruption.



Linux to Linux or Windows to Windows


1.Copy the entire account directory to the new server, preferably using the same pathname as the original system.

2.Ensure that the new account location is referenced from the QM.ACCOUNTS file.

3.If the account pathname has changed, any reference to the old pathname in the VOC file must be changed.

4.Identify any files outside of the account directory that are used by the application and copy these, again preserving or modifying the pathname.

5.If the application uses globally catalogued subroutines, these must be recatalogued on the new system. If all application accounts are being moved, the easiest way to do this is to copy the global catalogue directory (the gcat subdirectory of the QMSYS account) from the original system to a temporary location on the new system and then use the *IMPGCAT tool to import the items that are not part of QM itself.

6.Ensure that any external software used by the application is available on the new system.



Windows to Linux


There are two additional problems when moving from Windows to Linux.

Operating system pathnames are case insensitive in Windows but case sensitive in Linux.

Directory files use a carriage return / linefeed pair as the newline in Windows and just a linefeed in Linux.


The case sensitivity issue applies to all operating system files and directories within the account, including record ids in directory files. It can only be resolved by examination of the application to ensure that casing is as expected.


The line terminator issue can be resolved by use of the *FIXDIR tool but it is essential that this is not applied to directories that hold binary data such as QMBasic object code.



Linux to Windows


The same two additional issues apply as for Windows to Linux but the case sensitivity issue is less of a problem moving in this direction. It is important to note that on a Lunix system, a directory file could have two records named, for example, "A" and "a" but on a Windows system these are both the same record and one will overwrite the other.



Copying Items from the QMSYS Account Directory


It is strongly recommended that users do not copy the QMSYS account in its entirety because this may result in system errors, especially if the two systems are running different releases of QM. Instead, selective copying/editing should be used.


$FORMSIf the system uses Pick style form queue emulation, the relevant form queue definitions should be copied or recreated.
$LOGINSThis file is inaccessible to QM sessions but holds information relating to the features controlled by the ADMIN.USER command and the application level security option. If all users are moving to the new system, simply use an operating system copy command to move the file. If only some users are moving, use ADMIN.USER to recreate the required user definitions.
$SERVERSThis file is also inaccessible to QM sessions and holds server definitions for QMNet and the Virtual File System. Either copy it in its entirety with an operating system command or recreate it.
$VAULTIf the encryption key vault is copied to the new system, the master key must be re-entered using the RESET.MASTER.KEY command.
ACCOUNTSRecords may be copied selectively or the entire file may be moved using an operating system command.
ecs-mapsECS character maps can be copied individually or in their entirety.
gcatThe global catalogue must not be copied in its entirety unless both systems are running the same version of QM. The *IMPGCAT tool mentioned above may be useful.
VOCThe only item that should be copied is the MASTER.LOGIN paragraph, if present.
qmconfigThis file should be examined carefully and items moved/edited as needed. The EDIT.CONFIG command may be useful.
terminfo.modsIf used, this file may need to be copied to the new system.



Copying an Entire System to a New Server


As an alternative to the steps described above, moving an entire system to a new server of the same type (Windows/Linux/etc) can be done as follows:


Install QM on the new system. This will require a change to the licence and it may be useful to visit to generate a seven day "emergency licence" which will be replaced by a new permanent licence later.


1.Shutdown QM on both the old and new servers.


2.Use an operating system tool to copy all account directories, including QMSYS to the new server, using the same pathnames as on the old server.


3.Reinstall QM on the new server so that any standard parts of QM such as globally catalogued programs that were copied from the old server are replaced with the correct versions for the release of QM being used on the new server. If the old system uses encryption, the installer will request entry of the master key.


4.If the old server was a replication subscriber, the RPLSRVR configuration parameter may need updating.