FreeAS2UserManualenWord格式.docx
- 文档编号:19291245
- 上传时间:2023-01-05
- 格式:DOCX
- 页数:28
- 大小:639.44KB
FreeAS2UserManualenWord格式.docx
《FreeAS2UserManualenWord格式.docx》由会员分享,可在线阅读,更多相关《FreeAS2UserManualenWord格式.docx(28页珍藏版)》请在冰豆网上搜索。
3.3.3Productinstalltaion6
3.3.4Postinstallation6
3.3.5Test7
3.3.6Directorystructure7
3.3.7InstallasWindowsservice8
3.3.8Productuninstallation8
3.4Backupandrestore8
3.5ExternalaccessURL8
4Quickstart9
4.1Overview9
4.2Scenario9
4.3Importconfiguration9
4.4Importedconfiguration10
4.4.1Partner10
4.4.2Outboundconfiguration10
4.4.3Inboundconfiguration11
4.5Otherconfiguration11
4.6Test11
5AdminConsole11
5.1Browsersupport11
5.2URL12
5.3Wildcard12
5.4Login12
5.5MainUI13
5.6Dashboard13
5.7Transaction14
5.8Log16
5.9Partnermanagement16
5.10Inbound17
5.11Outbound18
5.12Alertmanagement20
5.13User20
5.14Configmigration21
5.15Housekeeping21
5.16Help21
6Q&
A22
6.1Performanceoptimize22
6.2SystemhaltatInitializingc3p022
6.3Linux/Unixportbindfail22
6.4HowtochangeJRE(JavaRuntime)22
6.5Howtoupgradetomcat23
7AboutMintianandCloudHub23
7.1AboutMintian23
7.2CloudHub23
7.3CloudHubvsFreeAS223
8Nextstep23
1Documentdata
1.1Purposeofthedocument
ThismanualdescribehowtouseFreeAS2.Thetargetaudiencesinclduesproductimplementationpersonnelandcustomertechnicalstaff.
1.2Author
Name
Company
Tel
Jamie
MTTK
info@
1.3Documenthistory
Date
Changedby
Description
2013/12/6
Initialversion
1.4Relatedinformation
None
1.5Contactinformation
Anyquestionpleaseemailtoinfo@
Companywebsite(InChinesesofar)
2Overview
2.1Introduction
FreeAs2isanopensourcesoftwarewhichimplementEDIINTAS2protocol,itincludesencryption,digitalsignature,compresison,syncandasync(Partialsupport)MDN.
Thissoftwareis100%basedonjavatechnology,supprtsWindowsandLinuxplatform(NottestonUnix)
RegardingAS2protocolpleaserefertotherelatedAS2documentation.
Limitations
–PartiallysupportasyncMDN
–Nosupportforclusterinstalltaion
2.2Components
Component
Functionality
Systemruntime
ItcanbeaWindowsserviceonWindowsorbackgroundtaskonLinux
AdminConsole
WebUIforconfigurationandmonitoring
2.3Terms
Term
EDIINTAS2
ItisaprotocolfortransferringEDImessageoverInternet,definedbyIETFworkinggroupanddescribedinRFC4130.
MDN
MessageDispositionNotification,itidentifiesthereceiptofAS2message
AS2ID
AuniqueidentifierforeachAS2participant.ItcanbeDUNSoranycharacters.
Owner
ThisdocumentreferstotheAS2IDofthesitewheretheFreeAS2installed
Forsending,itisthesender;
forreceive,itisthereceiver
Partner
ThisdocumentreferstotheAS2IDofthesitetoexchangeAS2messagewithFreeAS2.
Forsending,itisthereceiver;
forreceive,itisthesender
3Installation
3.1Hardware
Nospecialrequirement,theminimalrequirementistosupportJavaVirtualMachinetorun
3.2Software
Category
Product
Result
OS
Windows
Windows7,WindowsXP,Windows2008passedtest
OndemandtestforotherOS
Linux
CentOS(2.6.xxkernel)passedtest
Unix
Nottest
DB
HSQLDB
Passedtest(Buildin)
MySQL
Passedtest
MicrosoftSQL
Server
Oracle
OtherDB
Java
OracleJRE
1.5Notsupport
1.6,1.7Testpassed
OtherJRE
Notice:
SystemsupportHSQLDBwithdefaultinstalled,MySQLisusedduringdevelopment
PleaseletmeknowifotherDBsupportisnecessary
3.3Installationsteps
3.3.1Checklist
No#
Item
Requirement
1.1
Hardware
Refertohardwarechapter
1.2
Refertosoftwarechapter
1.3
NoinstallationisnecessaryforHSQLDB
1.4
1.5
Network
Ifthissystemisaccessfromothersystem,astablenetworkconnectionandpublicIP(orIP/portmapping)ismandatory
3.3.2DBinstallation
No
3.3.3Productinstalltaion
Usedecompressionsoftware(suchaswinrar,winzip)toextractFreeAS2.ziptoanydirectory,forexamplec:
\FreeAS2.Nospecialcharacterandblankindirectoryisrecommanded.
3.3.4Postinstallation
ChangeTomcatport(Optional)
Thedefaultportoftheadminconsolerunningis828andexternalHTTPlistenportis825.
Tochangeportseditfileconf\tomcat.xml.
Thedesigngoaloftwoportsistogainbettersecurity.Thelistenerportshouldbesettobeabletoaccessexternallyandtheadminconsoleportcanbelimitedtointernalaccess.
tomcat.xmlisastandardtomcatconfigurationfile(Intomcatthenameisserver.xml).ItcanalsobeconfiguredtosupportHTTPS,userauthentication.
InstallJavavirtualmachine
TheJavaruntimeinstalledisa64bitwindowsversionJRE.Ifitdoesnotmatchyoursystem,pleasedownloadtheJREandextracttoruntime\jretoreplacetheinstalledone.
SetJavavirtualmachineparameter
Inwindowsremarkthecommentinchub.bat(removetherematline2)
InLinuxremarkthecommentinchub.sh(removetherematline2)
OnhowtosetJavavirtualmachineparameterrefertheJavadocumentation.
ifitisinstalledaswindowsservice,theparametersarenotchangedhere,referto“installaswindowsservice”chapter.
Sincethemaxmemorylimitationin32bitJavaitishighlyrecommendedtoinstall64bitJava.
Changeloglevel
conf/log4j.xmlisastandardlog4jconfigurationfile.Fordetailconfigurationrefertolog4jdocumentation
3.3.5Test
InbrowserinputURL:
http:
//yourip:
828/admin/
YouripistheIPaddressoftheFreeAS2installed,forlocalaccessuseURL:
//localhost:
Thedefaultloginuserisadminandpasswordis123456
Youhavefinishedinstallationifyoucanseetheloginpage.
3.3.6Directorystructure
Afterinstallationthedirectorystructureisasbelow:
Directory
bin
Scriptdirectory
startup.sh(startup.bat)StartFreeAS2
shutdown.sh(startup.bat)StopFreeAS2
installService(64).batInstallaswindowsservice
uninstallService(64).batUninstallwindowsservice
Sub-directoryjslisthenecessaryfilesandconfigurationforinstallingwindowsservice
conf
Configurationdirectory
data
Datadirectory
Sub-directory“payload”isthepayloadrepository
Sub-directory“db”storeshsqldbdatabasefiles
doc
Documentationdirectory
lib
Jarfiles,allthejarwillbeloadedduringstartup
log
Logdirectory
runtime
Runtime
jrejavaruntime
tomcatTomcatserver
temp
Temporarydirectory,itcanbepurged
Test
Storetestconfigurationanddata,itcanbedeletedinproductionstage
webapps
Webapplicationdirectory
Sub-directory“internal“storeAdminConsolewebapplication,itisdefaultbindonport828
Sub-directory“public“storelistenerwebapplication,itisdefaultbindonport825
3.3.7InstallasWindowsservice
ThisstepisonlyforWindows.
Runbin\installService.bat(For32bitWindows)orbin\installService64.bat(For64bitWindows)toinstall.Afterdonetheblowserviceisinstalled
Foradvancedconfigurationpleaseeditfilejsl.ini(For32bitWindows)orjsl64.ini(For64bitWindows),javavirtualmachinecanalsobeconfiguredhere.
UninstallWindowsservice,runbin\uninstallService.bat(For32bitWindows)orbin\uninstallService64.bat(For64bitWindows)
InWindows7itmayhavethe”OpenSCManagerfailed”error.Thismeansitcanonlybeexecutedwithadministratoraccount.Thepossiblesolutionis:
–runas
/user:
administrator
cmd(Inputadministratorpassword)
–cdc:
\FreeAS2\bin(Enter“bin”underFreeAS2installationdirectory)
–installService64.bat(Run)
3.3.8Productuninstallation
Thisproductwillnotstoreanythinginregistryandotherdirectory.
Touninstallfollowthebelowsteps
●Uninstallwindowsservice
♦Deleteinstallationdirectory
3.4Backupandrestore
Theadminconsolehasbackup/restorefunctionalitytobackup/restorequickly.Thedetailinformationinclduespartner,sendingconfiguration,receiveconfiguration,gloalconfigurationanduser.
Andtobackupallthedataunder“data“directoryisanothersolution.
3.5ExternalaccessURL
AS2messageURL
http:
825/listener/AS2Listener
AS2MDNURL
825/listener/AS2MDNListener
youripistheIPaddressofthemachineFreeAS2installed.Ifitisbehindafirewall,theIPandportmaybemapped,pleasecontactyournetworkadministartor.
4Quickstart
4.1Overview
ThechapterdemostratesaAS2sendingandreceivingscenario.
4.2Scenario
TwoAS2systemisneccessarytosendingandreceivingAS2messages.Tosimplifytheinstalltionthisscenariouseonesystemtodemo.
TwoAS2IDareconfigured:
yourcompanyandmttk.Yourcompanyisforsending,thesendingdatacomesfromdirectorytest\yourcompany\outbound.mtt;
mttkisforreceving,thereceivedfilewillbesavedtotest\mttk\inbound.
4.3Importconfiguration
AfterFreeAS2isinstalled,thereisnoconfigurationexceptadminuserrecord.Thisstepwillimporttheconfigurationfortheabovescenario.
InadminconsoleselectUtility/Configmigration.
In“Import”areaselectfile”test\config\migration_loop_test.zip”andclick
.
Donotforgettoactivetheoutboundconfiguration.
Nextchapterwilldescribedthe
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- FreeAS2UserManualen
![提示](https://static.bdocx.com/images/bang_tan.gif)