SDP_Win2Linux_Guide.adoc #1

  • //
  • guest/
  • perforce_software/
  • sdp/
  • dev/
  • doc/
  • SDP_Win2Linux_Guide.adoc
  • View
  • Commits
  • Open Download .zip Download (896 B)
= SDP Windows to Linux Migration Guide
Perforce Professional Services <consulting@perforce.com>
:revnumber: v2023.1
:revdate: 2023-08-11
:doctype: book
:icons: font
:toc:
:toclevels: 5
:sectnumlevels: 4
:xrefstyle: full
// Attribute for ifdef usage
:unix_doc: true

== Preface

This guide documents the process for migrating a Helix Core service from Windows to Linux.

A common scenario is that an on-premisis (on-prem) Windows Helix Xoer services 

*Please Give Us Feedback*

Perforce welcomes feedback from our users. Please send any suggestions for improving this document to consulting@perforce.com.

:sectnums:
== Overview

A Migration has these elements:

* Deployment of a new Linux Server machine.
* Setup of a server spec for a Linux Replica on the Windows master.

Each of these components is covered, in detail, in this guide.

[appendix]
== Why Migrate?

EDITME - add content later.
# Change User Description Committed
#22 31658 C. Thomas Tyler Updated Windows to Linux Migration Guide:
* Replaced instructions related to using reset_sdp.sh (the Helix Installer)
with guidance to use the install_sdp.sh script in SDP documentation.
* Rebranding: Replaced references to Helix and Helix Core, Helix Swarm, etc.
* Spell checked.
#21 31407 lee_marzke Clerical
Fix Appendix numbering, last section 4 changed to correct Appendix C
#20 31063 C. Thomas Tyler Updated revnumber and date for release.
#19 30910 C. Thomas Tyler Updated rev{number,date} fields in adoc files for release.
#18 30829 C. Thomas Tyler Fixed typo.
#17 30383 C. Thomas Tyler Updated rev{number,date} fields in adoc files for release.
#16 30342 C. Thomas Tyler Fixed bogus revs to the dev branch in released docs.

#review-30343 @amo
#15 30207 C. Thomas Tyler Doc work WIP
#14 30206 C. Thomas Tyler WIP.
#13 30204 C. Thomas Tyler Doc work in progress ...
#12 30202 C. Thomas Tyler Doc work in progress ...
#11 30201 C. Thomas Tyler Doc work in progress ...
#10 30178 C. Thomas Tyler Doc in progress updates.
#9 30159 C. Thomas Tyler Documentation work in progress.
#8 30000 C. Thomas Tyler Refined Release Notes and top-level README.md file in preparation
for coming 2023.2 release.

Adjusted Makefile in doc directory to also generate top-level
README.html from top-level README.md file so that the HTML file is
reliably updated in the SDP release process.

Updated :revnumber: and :revdate: docs in AsciiDoc files to
indicate that the are still current.

Avoiding regen of ReleaseNotes.pdf binary file since that will
need at least one more update before shipping SDP 2023.2.
#7 29953 C. Thomas Tyler Regeneratd docs.
#6 29937 C. Thomas Tyler Very rough draft still WIP.
#5 29934 C. Thomas Tyler WIP.
#4 29931 C. Thomas Tyler WIP - Windows to Linux guide; still very raw.
#3 29742 C. Thomas Tyler WIP.
#2 29741 C. Thomas Tyler WIP.
#1 29740 C. Thomas Tyler Bootstrapped empty doc.