checkpcanywhere

Orbix3.
3.
13SSLInstallationGuideiiMicroFocusTheLawn22-30OldBathRoadNewbury,BerkshireRG141QNUKhttp://www.
microfocus.
comCopyrightMicroFocus2015.
Allrightsreserved.
MICROFOCUS,theMicroFocuslogoandMicroFocusLicensingaretrademarksorregisteredtrademarksofMicroFocusIPDevelopmentLimitedoritssubsidiariesoraffiliatedcompaniesintheUnitedStates,UnitedKingdomandothercountries.
Allothermarksarethepropertyoftheirrespectiveowners.
2015-09-07OrbixSSLInstallationGuideiiiContentsInstallingOrbixSSL3.
3SP13.
1Introduction1PrerequisitestoInstallingOrbixSSL3.
3SP13.
2InstallingOrbixSSL3.
3SP13withouttheGUI5InstallingOrbixSSL3.
3SP13withtheGUI.
6VerifyingyourInstallation7FurtherInformation.
8ivOrbixSSLInstallationGuideOrbixSSLInstallationGuide1InstallingOrbixSSL3.
3SP13ThisdocumentprovidesinstructionsforinstallingOrbixSSL3.
3SP13onMicrosoftWindows,RedHatEnterpriseLinux,Solaris,IBMAIX,andHP-UX.
OrbixSSL3.
3SP13requiresanexistinginstallationofOrbix3.
3SP13.
IntroductionThisdocumentprovidesinstructionsforinstallingOrbixSSL3.
3SP13onthefollowingplatforms:Windows7Windows8.
1WindowsServer2012R2RedHatEnterpriseLinux5,6and7Solaris10(SPARCandIntel)Solaris11(SPARCandIntel)AIX6.
1AIX7.
1HP-UX11iv2(11.
23)ItaniumHP-UX11iv3(11.
31)ItaniumOrbixSSL3.
3SP13requiresanexistinginstallationofOrbix3.
3SP13.
OrbixSSL3.
3SP13isenabledbylicensecodesforOrbix3.
3SP13JavaEditionorOrbix3.
3SP13C++Edition.
PleaserefertothefollowingwebpageforthelatestinformationonplatformssupportedbyOrbix3.
3SP13:http://supportline.
microfocus.
com/supportresources/Orbix3313SupportedPlatformList.
aspxJRErequirementsTheOrbixSSL3.
3SP13installationwasbuiltwiththeJava-basedInstallAnywhere,andrequiresaJRE(JavaRuntimeEnvironment).
YoushouldprovidetheJREyourself(see"Installationprerequisites"onpage3),oruseapre-installedJREorJDKbeforelaunchingtheinstaller.
Note:Duetolegalrestrictionsinsomecountries,theOrbixSSL3.
3SP13CD-ROMisnotsuppliedwithOrbix3.
3SP13.
2OrbixSSLInstallationGuideInstallationstepsToinstallOrbixSSL3.
3SP13,followthesesteps:1.
ChecktheprerequisitestoinstallingOrbixSSL3.
3SP13.
2.
InstallOrbixSSL3.
3SP13onyourhostmachine.
3.
Verifyyourinstallation.
BeforeyoubeginyourinstallationBeforeinstallingOrbixSSL3.
3SP13,seetheOrbix3.
3documentationwebpageathttp://support.
microfocus.
com/supportresources.
aspYoushouldreadthelatestversionoftheOrbix3.
3SP13ReleaseNotes,andcheckforanyupdatestothisinstallationguide.
Orbix3.
3SP13licensecodesYoumusthaveavalidlicensecodetoinstallOrbixSSL3.
3SP13JavaEdition,OrbixSSL3.
3SP13C++Edition,andOrbixNames.
AllothercomponentsofOrbixSSL3.
3SP13areactivatedbytheselicensecodes.
Thecodeisalongnumericstringtakingthegeneralform:00000000-11111111-22222222-33333333-44444444YourlicensecodeshouldbeincludedinaloosesheetinyourOrbixSSL3.
3SP13pack.
Otherwise,becauseOrbixSSL3.
3SP13isaservicepackreleaseofOrbix3.
3,thelicensecodesprovidedforOrbix3.
3arevalidforOrbixSSL3.
3SP13.
Ifyoudonothaveanylicensecodes,pleasecontactSupportbeforeproceedinganyfurther.
PrerequisitestoInstallingOrbixSSL3.
3SP13ExistingOrbixinstallationsYoumustinstallOrbixSSL3.
3SP13intothesamelocationasanexistingOrbix3.
3SP13JavaEditionorC++Editioninstallation.
TheexistinginstallationisupdatedbytheOrbixSSL3.
3SP13installation.
Note:OrbixSSL3.
3SP13cannotbeinstalledusingtheinstallerGUIonmachinesthatdonotsupport256(8-bit)colors.
Note:WheninstallingOrbixSSL3.
3SP13overaPCAnywhereremoteclient,useadisplayresolutionoftypeVGA(640x480).
Note:DonotinstallOrbixSSL3.
3SP13ontoanolderversionofOrbix.
OrbixSSLInstallationGuide3InstallationprerequisitesTheinstallationprerequisitesareasfollows:PrerequisiteNotesPrivilegesGeneralToinstallinanon-defaultlocation,youmusthavepermissiontocreatefilesanddirectoriesinthatlocation.
WindowsToinstallinthedefaultlocation,Windowsusersmusthaveadministratorprivileges.
UNIXToinstallintothedefaultlocation,UNIXusersmusthaverootprivileges.
UNIXDISPLAYTheinstallerwasbuiltusingInstallAnywhere,whichisaGUIapplication.
ToinstallwithouttheGUI,see"InstallingOrbixSSL3.
3SP13withouttheGUI".
ForaGUIapplicationtorunonUNIX,youneedtoinstallonaUNIXhostwithXandawindowingenvironmentconfigured.
Ensureyourdisplayenvironmentvariableissettotheworkstationyouareloggedinto.
Forexample,setthefollowingenvironmentvariable,substitutingthefullDomainNameSystem(DNS)nameofyourworkstationfororbix-dev.
microfocus.
com:exportDISPLAY=orbix-dev.
microfocus.
com:0.
0Contactyoursystemadministratorifyourequireassistance.
JRETheinstallerwasbuiltusingInstallAnywhere,whichisaJavaapplication,andrequiresaJRE(JavaRuntimeEnvironment).
YoumustprovidethelocationoftheJREfortheinstallationtorun.
YouneedaccessonallplatformstoanexistingJRE(orJDK).
Alternatively,youshouldobtainandinstalltheJREyourselfonyoursystembeforerunningtheinstaller.
WheninstallingaJRE,installallrequiredpatchesonallplatforms.
DomainnameTheinstallerrequiresyourdomainnameforOrbixSSL3.
3SP13configuration.
TheDomainNameSystem(DNS)isusedtoresolveInternetorUNIXcomputernames.
ContactyournetworkadministratortoobtainthedomainnameforyourTCP/IPinternetbeforeinstallingOrbixSSL3.
3SP13.
4OrbixSSLInstallationGuideCD-ROMLocationofinstallersTheOrbixSSL3.
3SP13installersontheCD-ROMarelocatedinaspecificdirectoryforeachplatform.
BrowsetheCD-ROMtofindtheinstallerforyourplatform.
MountingtheCD-ROMThefollowingexamplecommandscanbeusedtomounttheCD-ROM:ThecommandsusedtomounttheCD-ROMwillvarydependingonyoursystemconfiguration.
Forexample,/cdrommightneedtobereplacedwithadifferentmountpoint.
Contactyoursystemadministratorifyourequireassistance.
Inaddition,youcansimplifythisprocessusingtoolssuchasvoldonSolarisandLinux,orsmittyonAIX.
OperatingsystemsandcompilersPleaserefertothefollowingwebpageforthelatestinformationonplatformssupportedbyOrbixSSL3.
3SP13:http://supportline.
microfocus.
com/supportresources/Orbix3313SupportedPlatformList.
aspxDiskspacerequirementsTheOrbixSSL3.
3filestakeupapproximately30MBofdiskspaceonallplatforms.
Theinstalleralsorequiresapproximately50MBoftemporaryworkspace.
PlatformCommandWindowsNocommandrequiredLinuxmount-tiso9660/dev/cdrom/cdromSolarismount-r-Fhsfs/dev/c0t0d0s2/cdromAIXmount-oro-vcdrfs/dev/cd0/cdromHP-UXmount-tcdfs-ocdcase/dev/dsk/c3t2d0/cdromNote:OnWindows,ensurethatyouhaveenoughdiskspacebeforestartingtheinstallation.
OrbixSSLInstallationGuide5DefaultlocationInstallOrbixSSL3.
3SP13intothesamelocationasanexistingOrbix3.
3SP13installation.
ThedefaultlocationofyourOrbix3.
3installationisasfollows:InstallingOrbixSSL3.
3SP13withouttheGUIInstallingOrbixSSL3.
3SP13insilentinstallmodeallowsyoutoruntheinstallerwithoutusingtheGUI.
Thesilentmodeinstallerlookstoatemplatefilethatprovidestherequiredinformation.
InstallinginsilentmodeToinstallinsilentmode,enterthefollowingcommand:$.
/install.
bin-f/path/to/template.
fileInthiscase,template.
filecontainsthefollowinginformation.
PlatformDefaultLocationUNIXmaininstallation/opt/microfocus/orbix33WindowsC:\ProgramFiles\MicroFocus\Orbix3.
3SP13forWindowsWindows(installing32-bitkitona64-bitWindows)C:\ProgramFiles(x86)\MicroFocus\Orbix3.
3SP13forWindowsNote:OrbixSSL3.
3SP13installsinafixedlocationrelativetothepathyouspecify.
Installingintoanon-defaultlocationcreatesacopyofthedefaultlocationpathrelativetothenon-defaultlocation.
##Specimenpropertieswithoperatingsystemlicencecodes.
##C++andJava##SpecifythedirectorywhereyouwantOrbix3.
3SP13installedUSER_INSTALL_DIR=/local/install/dir##SpecifythelocationofyourJavaDevelopemntKitJAVA_LOCATION=/local/java/install/dirJAVA_VERSION=1.
5INSTALLER_UI=SILENT##SpecifythecomponentsofOrbixyouwanttoinstallPRODUCTS="Orbix3.
3-JavaEditionandC++Edition"##Specifyyourlicencekey:eitherthec++orthejavakeycanbeusedLICENCE_KEY_1=com6OrbixSSLInstallationGuideInstallingOrbixSSL3.
3SP13withtheGUIThissectiondescribeshowtoinstallOrbixSSL3.
3.
SP13usingtheGUIinstaller,whichisbasedonInstallAnywhere.
InstallationstepsToinstallOrbixSSL3.
3.
SP13usingtheGUI,performthefollowingsteps:1.
IntheLocateOrbix3.
3Installationscreen,enterthefilelocationthatyouwishtoinstallOrbixSSL3.
3SP13into,andclickNexttocontinue.
2.
IntheLicenseAgreementscreen,clickYestoagreetothetermsoftheLicenseAgreement,andclickNexttocontinue.
3.
IntheLicenseInformationscreen,enteryourlicensecode.
ClickNexttocontinue.
4.
IntheDomainInformationscreen,enteryourdomaininformation,andclickNexttocontinue.
5.
IntheJDKConfigurationscreen,enterthelocationofyourJavaDevelopmentKit.
ThisisnotrequiredforOrbixSSL3.
3SP13C++Edition.
ClickInstalltocontinue.
6.
Aprogressbarisdisplayedwhilethefilesareinstalled.
7.
Aftertheinstallationiscomplete,theOrbixwelcomepagelaunchesautomatically.
8.
IntheRebootComputerscreen,choosewhethertorestartyourcomputernoworlater.
9.
TheInstallCompletescreenisdisplayedtoconfirmthattheinstallationisfinished.
ClickDonetofinishtheinstallation.
Note:Youmusthavepermissiontocreatefilesanddirectoriesinthislocation.
OrbixSSLInstallationGuide7VerifyingyourInstallationConfigurationchecksWhentheinstallationiscomplete,followthesestepstoensurecorrectoperation:1.
CheckthecontentsoftheOrbixSSLconfigurationfiles,toensurethatthespecifieddirectorypathsanddomainnamematchthoseforyoursite.
2.
ReadtheOrbixSSL3.
3SP13ReleaseNotes.
3.
ForinstructionsonhowtoruntheexampleapplicationswithOrbixSSLsecurity,seethechapterGettingStartedwithOrbixSSLintheOrbixSSLC++Programmer'sandAdministrator'sGuideorOrbixSSLJavaProgrammer'sandAdministrator'sGuideThemostup-to-dateversionsofallOrbix3.
3documentsareavailableontheOrbix3.
3documentationWebpage.
ReinstallingthelicensecodeIfyouenteredthelicenseauthorizationkeyincorrectly,orleftitblankduringinstallation,youshouldreinstallOrbixSSL3.
3SP13.
PlatformLocationUNIX$ORBIX_ROOT/config/orbixssl.
cfg$ORBIX_ROOT/config/openssl.
cnfWindows%ORBIX_ROOT%\config\orbixssl.
cfg%ORBIX_ROOT%\config\openssl.
cnfNote:OrbixSSLsecurityisdisabledafterinstallationbecausethedefaultvalueofIT_DISABLEinorbixssl.
cfgistrue.
SeethechapterGettingStartedwithOrbixSSLintheOrbixSSLC++Programmer'sandAdministrator'sGuideorOrbixSSLJavaProgrammer'sandAdministrator'sGuidefordetailsonenablingsecurity.
Note:ThecertificatesupdatedbytheOrbixSSLupdateutilityatinstallationtimeareforOrbixSSLexampleprogramsonly.
Theyshouldnotbeusedfordeployedapplications.
CreatingandsigningcertificatesisdescribedinthechapterManagingCertificatesintheOrbixSSLC++Programmer'sandAdministrator'sGuideorOrbixSSLJavaProgrammer'sandAdministrator'sGuide.
Note:OrbixSSL3.
3SP13isenabledwithOrbix3.
3SP13JavaEditionorOrbix3.
3SP13C++Editionlicensecodes.
8OrbixSSLInstallationGuideUninstallingOrbixSSL3.
3SP13TouninstallOrbixSSL3.
3SP13,runtheUninstallOrbixfileintheUninstallOrbixdirectoryofyourOrbixSSL3.
3SP13installation.
Thefollowingareexamplelocations:FurtherInformationTechnicalsupportIfyourequirefurthertechnicalassistancewithusingthisproduct,pleaseseethefollowingwebpage:http://supportline.
microfocus.
comPlatformUninstallscriptUNIX$ORBIX_ROOT/UninstallOrbix/UninstallOrbixWindows%ORBIX_ROOT%\UninstallOrbix\UninstallOrbix.
exeNote:TheuninstallerremovesthecompleteinstallationofOrbixSSL3.
3SP13,butdoesnotremoveanyfilesthatwereaddedorgeneratedafterinstallation(forexample,logfiles,executablesgeneratedindemonstrationruns,implementationrepositories,andsoon).
IfyouintendtouninstallOrbixcompletely,youshoulduninstallOrbixSSL3.
3SP13beforeuninstallingOrbix3.
3SP13.