v0.1.3 Last update: April 15, 2019
For information on the updates, known bugs, fixes, and other information, visit the UPDATES document.

• Description
• License
• Examples
• Dependencies
• Installation
• OS Compatibility
• TODO

Unix/Linux migration program -- Prepares shadow file for migration in incompatible systems.
This program was created between a migration from Unix Solaris 10 to Ubuntu (details are confidential), and since the password encryption algorithms are different, something had to be done to transfer thousands of user accounts without compromising the functionality of the system.
This program made everything much easier, and now if you need to do the same, you can simply use this program to speed up the process.

MIT License

Copyright (c) 2019 Evoluti, Inc. (Bryan Morfe CEO)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

In this hypothetical example I will be migrating from a Unix Solaris 10 system (IP Address 192.168.1.10) to linux Ubuntu 16 (IP Address 192.168.1.15).

Run the following command on the Ubuntu System (note that you need an account in Solaris with root privileges):
$ scp [email protected]:/etc/shadow $HOME
[email protected]'s password:

After the password for root is entered, you should have a copy of the shadow file in the home directory for my user in Ubuntu.

Run the following command on the Solaris System: (sudo privileges needed on Solaris, but no root access is needed on Ubuntu):
$ sudo scp /etc/shadow [email protected]:~/
password:
[email protected]'s password:

After both passwords are entered, you should have a copy of the shadow file for Solaris in the home directory of user on the Ubuntu System.

Run the following commands on Ubuntu (assume pwd=$HOME):
$ mkdir processed
$ shprep -c -r --shadow-file shadow --output-file processed/shadow -p D3fP@s5w0rD --hash-alg sha512

After that command, the generated shadow file will have default passwords for all users that originally had a password. Users that didn't have a password will stay that way. If no further processing is needed, this file could be copied into the /etc directory AFTER A BACKUP OF THE ORIGINAL IS MADE.

I am not responsible for any corrupted shadow files produced by this program. ALWAYS make a backup of the original shadow file before modifying it with this or any other software.

In order to compile, install, and run shprep, you need to have the following programs/utilities in your Unix/Linux/macOS system:

• make
• gcc

In Debian-like distributions of linux, you may run the following command:
$ sudo apt-get install make gcc

Open terminal and run the following command:
$ git clone https://github.com/BryanMorfe/shprep

You can also download the compressed (tarred) version by running the following command:
$ wget http://bryanmorfe.com/packages/shprep-latest.tar.gz

Download the tarred version.

If you used Option 1, you may skip to step to Step 2.

If you used Option 2, then simply run this command:
$ tar -xvf shprep-latest.tar.gz

This will decompress the tar into a directory called shprep-latest.

If you used Option 3, then you must go to the directory where the downloaded tar is and decompress, either with graphical user interface, or by using terminal and running the above command.

Run the following commands:
$ ./configure
$ make

If the above make command gives you an error undefined reference to 'crypt' it's because your System requires you to link the libcrypt library. To do so run this version of the make command:
$ make LIBS=-lcrypt

This should get rid of the problem.

Run the following command:
$ make install

Run the following command:
$ make clean

• Spread the code into a few other source files (maybe?)