During the migration, all SMPTE OLC community documents for Technology Committees (TC) and TC Subgroups were transferred to the SMPTE SKN and with it to Microsoft Teams and Microsoft SharePoint. This includes documents from active groups but also inactive groups which were hidden from the SMPTE OLC users. In addition, all files from the Library section of SMPTE OLC were transferred.
All documents from active groups were transferred to the SMPTE SKN team equivalent of the SMPTE OLC community.
Please Note, empty folders in SMPTE OLC community were deleted during the creation of the OLC backups by HigherLogic.
Missing Files, Links and ID Folders
The HigherLogic document backup contained some issues which needed to be resolved before the documents could be deployed to the SMPTE SKN. The issues have to do with suspected file references to the OLC database, duplicate file names introduced by the HigherLogic versioning system and links which were contained in some folders
ID Folders (aka Number Folders)
Every file in the SMPTE OLC update was wrapped into, what we call, an ID folder with the folder name being a variable length number. We suspect that this number served as a link between the SMPTE OLC Database and the file.
Preserving these ID folders would have made it impossible to find a document quickly and a decision was made to remove the folders and to move the contained files up one level in the folder structure. This removal process was not successful in a few occasions. We suspect two reasons.
SMPTE OLC Revision System
In some cases the removal of the ID folder failed because the folder contained several files with the same file name (so the file content was different).probably due the use of the OLC revision system.
- Folder “1 year and 5 tear Review Documents” contains an ID folder.
- ID folder 53063 contains a file with a file name replicated in the parent folder
It is suspected that one file is a revision of the other. Unfortunately, one cannot tell from just the file name which is the “Head” or the latest revision of the original file. Luckily, information to determine the Head was created using the SMPTE OLC database metadata provided in the HigherLogic SMPTE OLC backup. This information is available in the SMPTE Standards Community team on the SMPTE SKN. Please go to the “Standards Information” channel, click on the “Files” tab and navigate into the “OLC Legacy Document Info” folder. View the file “olc_legacy_rev_log.html” for revision information and to determine the Head file of a revision document collection.
Some SMPTE OLC folders contained links to other SMPTE OLC documents or to online resources. During the creation of the SMPTE OLC backup these link were converted into files with the file name “link”. These “link” files contain the URL used on the SMPTE OLC system to point at the resource. An example is shown below.
Multiple link files were created if a SMPTE OLC folder contained multiple links. During the removal of the ID folders online one link file was taken out of the ID folders while the others remained. This was due to the same file name.
Conversion Process Documentation
Additional information was created during the conversion process:
- olc_archive_scrub_2020_12_15_log.txt: A file containing all Log messages from the conversion process.
- olc_archive_rename_2020-12-15_log.txt: A file containing information on a few files which were renamed.
- Olc_archive_md5_2020_12_15.txt: Contains MD5 hash for every file in the SMPTE OLC backup.
Most importantly, we do provide a report on the conversion process and every problem encountered. This report is provided as a text file called README-olc-transfer_2020-12-16.txt.
These files are all located in the “OLC Legacy Document Info” folder on the SMPTE SKN together with the previously mentioned files.