【導(dǎo)讀】時(shí)空信息融通平臺(tái)KSOA. 北京時(shí)空超越科技有限公司

　　

【正文】 臺(tái)等。 名詞解釋 : 下面就本安裝說明涉及到的一些名詞加以解釋： ? 服務(wù)控制臺(tái) ：是一個(gè)服務(wù)管理程序，它提供一個(gè)服務(wù)管理的外殼和日志的管理，為各個(gè)不 KSOA 技術(shù)手冊(cè) 17 同的服務(wù)（如短信服務(wù)、許可認(rèn)證服務(wù)、計(jì)劃任務(wù)服務(wù)等等）提供一個(gè)統(tǒng)一的管理平臺(tái)。 ? 系統(tǒng)控制臺(tái) ：集中控制和管理各系統(tǒng)執(zhí)行的操作平臺(tái)；其三大職能包括：系統(tǒng)控制、系統(tǒng)維護(hù)、系統(tǒng)二次開發(fā)。 ? 金卡 /銀卡 ：又叫加密狗，北京時(shí)空超越科技有限對(duì)產(chǎn)品進(jìn)行注冊(cè)以及站點(diǎn)數(shù)控制的加密卡，金卡適用于 KSOA 的所有產(chǎn)品模塊，銀卡僅適用于獨(dú) 立店鋪系統(tǒng)的供應(yīng)鏈管理模塊。 ? WEB 服務(wù)： 通過 Inter/局域網(wǎng)發(fā)布信息，接收并處理用戶輸入信息的遠(yuǎn)程服務(wù)。 ? TOMCAT：是使用最為廣泛 Web服務(wù)器。 ? BDE： Borland Database Engine，為 Borland 公司提供的數(shù)據(jù)庫連接庫，通過 BDE 應(yīng)用程序可以訪問大多數(shù)數(shù)據(jù)庫系統(tǒng)。 ? ODBC： Open Database Connectivity，開放式數(shù)據(jù)庫連接，通過 ODBC 應(yīng)用程序可以訪問大多數(shù)數(shù)據(jù)庫系統(tǒng)，功能與 BDE 類似，但 BDE 是 Borland 公司提供的，而 ODBC 是一個(gè)開放的標(biāo)準(zhǔn)。 第二章 KSOA服務(wù)器端安裝 1 安裝前檢查 在確保已經(jīng)滿足“服務(wù)器安裝要求”之后，還需要檢查一下當(dāng)前的軟件運(yùn)行環(huán)境： ? SQL Server 是否已經(jīng)存在 skmaster 數(shù)據(jù)庫 和 ksoa 數(shù)據(jù)庫，如果已經(jīng)存在，請(qǐng)確保是否為需要保留的數(shù)據(jù)庫，如果不是，請(qǐng)先進(jìn)入 SQL Server 的企業(yè)管理器，刪除這兩個(gè)數(shù)據(jù)庫。檢查方法是：“程序”－ “ Microsoft SQL Server” － “ 企業(yè)管理器” － “數(shù)據(jù)庫”，在打開數(shù)據(jù)庫后，在數(shù)據(jù)庫列表中查找 skmaster和 ksoa 兩個(gè)數(shù)據(jù)庫。如下圖： KSOA 技術(shù)手冊(cè) 18 ? 請(qǐng)確認(rèn)已經(jīng)停 止了 IIS 的 “ World Wide Web Publishing Service”服務(wù)。檢查方法是：打開“控制面板”－ “管理工具”－ “服務(wù)”，在打開的“服務(wù)”窗口右邊的列表中查找“ World Wide Web Publishing Service”， 如果有，雙擊該項(xiàng)，彈出的窗口如下圖： 然后點(diǎn)“確定”按鈕退出。 ? 檢查當(dāng)前登錄的用戶是否具有管理員的權(quán)限，如果不是，請(qǐng)以管理員身份登錄。 KSOA 技術(shù)手冊(cè) 19 ? 檢查是否安裝了網(wǎng)絡(luò)防火墻軟件，如果安裝了，請(qǐng)系統(tǒng)管理員打開 TCP/IP 的 1009 端口和1433 端口。 ? 請(qǐng)檢查已經(jīng) 安裝了網(wǎng)卡并且網(wǎng)絡(luò)暢通，并檢查是否安裝了 TCP/IP 網(wǎng)絡(luò)協(xié)議，沒有，則必須安裝該網(wǎng)絡(luò)協(xié)議。安裝了該網(wǎng)絡(luò)協(xié)議后，請(qǐng)正確設(shè)置 IP 地址信息（請(qǐng)?jiān)儐栂到y(tǒng)管理員） 如果帶有金卡 /銀卡需要安裝，可以在產(chǎn)品安裝前將卡插入 USB 接口，操作系統(tǒng)會(huì)提示你安裝產(chǎn)品驅(qū)動(dòng)，這時(shí)候就可以了，產(chǎn)品安裝時(shí)，會(huì)自動(dòng)安裝金卡 /銀卡的驅(qū)動(dòng)程序，等到產(chǎn)品安裝完畢，該卡就可以正常使用了。 2 開始安裝 現(xiàn)在可以開始安裝。 其主要安裝過程如下所示。 首先點(diǎn)擊安裝程序下 文件，會(huì)出現(xiàn)以下界面： 點(diǎn)擊“下一步”按鈕，會(huì)出現(xiàn)如下界面： KSOA 技術(shù)手冊(cè) 20 該界面顯示的時(shí)空公司軟件安裝的許可證協(xié)議，如果想成功的進(jìn)行程序的安裝，必須點(diǎn)擊“是”按鈕，點(diǎn)擊該按鈕后，安裝程序會(huì)出現(xiàn)以下界面： 該頁主要是對(duì) KSOA 管理系統(tǒng)做一個(gè)詳細(xì)的說明，用戶可以通過該界面了解 KSOA 的組成、特點(diǎn)、應(yīng)用范圍等，點(diǎn)擊“下一步”按鈕： KSOA 技術(shù)手冊(cè) 21 用戶姓名指的是本機(jī)的用戶名，可以更改，也可以不改，如果此機(jī)器固定為某一個(gè)人使用，則在此程序的使用者選項(xiàng)中點(diǎn)擊“僅限本人”，否則請(qǐng)選擇“使用本機(jī)的任何人”選項(xiàng)，點(diǎn)擊下一步，出現(xiàn)以下界面： 系統(tǒng)會(huì)提示一個(gè)缺省的安裝目錄，安裝人員 可以根據(jù)自己機(jī)器硬盤空間的安排，通過瀏覽按鈕來選擇不同的路徑進(jìn)行安裝，確定路徑以后點(diǎn)擊“下一步” KSOA 技術(shù)手冊(cè) 22 完全安裝（默認(rèn)） ：完全安裝所有的服務(wù)，如果沒有特殊的需求，請(qǐng)選擇此項(xiàng)。 自定義安裝 ：自定義安裝是用戶可以根據(jù)自己的實(shí)際需要選擇所要安裝的各個(gè)平臺(tái)，注意如果用戶為連鎖總部安裝，需要手工選中數(shù)據(jù)導(dǎo)入服務(wù)項(xiàng)，否則系統(tǒng)不會(huì)自動(dòng)安裝，其界面如圖所示： 點(diǎn)擊下一步，系統(tǒng)繼續(xù)進(jìn)行安裝： KSOA 技術(shù)手冊(cè) 23 參數(shù)設(shè)置界面中提供系統(tǒng)的一些重要的參數(shù)設(shè)置項(xiàng)，這些參數(shù)至關(guān)重要，請(qǐng)認(rèn)真填寫。其中主要參數(shù)說明如下： ? 本店標(biāo)識(shí) ： 本店標(biāo)識(shí)在數(shù)據(jù) 導(dǎo)入服務(wù)的時(shí)候用到，因此，如果選擇安裝了數(shù)據(jù)導(dǎo)入服務(wù)（一般情況是連鎖店鋪總部），則一定要設(shè)置本店標(biāo)識(shí)。否則，可以不需要配置。該參數(shù)也可以進(jìn)入服務(wù)控制臺(tái)后進(jìn)入“參數(shù)設(shè)置”中修改。本店標(biāo)識(shí)或者為空（獨(dú)立店鋪）；或者為是 3個(gè)字符長(zhǎng)的字符串（第一個(gè)字符必須是字母）。 ? 創(chuàng)建數(shù)據(jù)庫 ：“創(chuàng)建數(shù)據(jù)庫”的 CheckBox（復(fù)選框），一旦選擇了該項(xiàng)，將會(huì)在本機(jī)的 SQL Server 數(shù)據(jù)庫中安裝 skmaster 數(shù)據(jù)庫以及 ksoa 數(shù)據(jù)庫。如果本機(jī)沒有安裝 SQL Server，將會(huì)提示“無法建立數(shù)據(jù)庫連接”等錯(cuò)誤，所以一定要確保本機(jī) 已經(jīng)安裝了 SQL Server 并且啟動(dòng)了 SQL Server 服務(wù)。 ? 數(shù)據(jù)庫服務(wù)器名 ：該名指的是服務(wù)器名，即安裝該程序的計(jì)算機(jī)名。默認(rèn)為 localhost，一般情況下不用修改。特別是選中了“創(chuàng)建數(shù)據(jù)庫”復(fù)選框后，一定要確保該值為本機(jī)的計(jì)算機(jī)名稱 /IP 地址，或者是 localhost。 ? 數(shù)據(jù)庫文件存放路徑 ：該路徑為安裝過程中新建立的數(shù)據(jù)庫文件的存放地址，可以選擇 SQL Server 系統(tǒng)的默認(rèn) Data 路徑： C:\Program Files\Microsoft SQL Server\MSSQL\Data，也可以設(shè)置別 的路徑。（建議把該路徑指定到一個(gè)硬盤空間能夠滿足 KSOA 系統(tǒng)空間要求的路徑。） ? WEB 服務(wù)安裝目錄 ： KSOA Web 服務(wù)（包括安裝 、 Tomcat 以及 KSOA 服務(wù)等），將安裝在該目錄下。默認(rèn)為 C:\SKWebService，用戶可以自己修改該項(xiàng)，指定為其他的目錄。 ? 安裝卡驅(qū)動(dòng) ：為安裝提供的金 /銀卡的驅(qū)動(dòng)程序 KSOA 技術(shù)手冊(cè) 24 以上項(xiàng)都有默認(rèn)值，使用這些默認(rèn)值就可以正常安裝（除數(shù)據(jù)庫存放路徑以外）。 設(shè)置好以上參數(shù)后，點(diǎn)擊“下一步”按鈕，進(jìn)入以下界面： 點(diǎn)擊“下一步”按鈕，繼續(xù)進(jìn)行安裝 如 果該程序不是第一次安裝，是卸載后的第二次安裝，并且沒有手動(dòng)刪除 skmaster 和 st_KSOA數(shù)據(jù)庫，則安裝系統(tǒng)會(huì)進(jìn)行檢測(cè)并提示是否恢復(fù)原來的數(shù)據(jù)庫模板，一般情況點(diǎn)擊“取消”按鈕后，系統(tǒng)會(huì)繼續(xù)安裝，等待一會(huì)后系統(tǒng)會(huì)提示安裝完畢。 KSOA 技術(shù)手冊(cè) 25 點(diǎn)擊“完成”后，服務(wù)器端的安裝結(jié)束。 3 程序卸載 在安裝完 KSOA 的服務(wù)端后，可能由于某種原因需要重新安裝，這個(gè)時(shí)候可以進(jìn)行程序的卸載操作。 卸載前的準(zhǔn)備工作： ? 請(qǐng)確保 Tomcat 服務(wù)已經(jīng)關(guān)閉（關(guān)閉 Tomcat 命令行窗口）。 ? 請(qǐng)確保服務(wù)控制臺(tái)程序已經(jīng)關(guān)閉。（請(qǐng)檢查右下角是否 有服務(wù)控制臺(tái)圖標(biāo)，有則說明沒有正確關(guān)閉服務(wù)控制臺(tái)程序）。 然后，請(qǐng)進(jìn)入“控制面板”→ “添加刪除子程序”來進(jìn)行刪除（請(qǐng) 不要 自己手動(dòng)通過刪除目錄的形式來刪除安裝后的程序，否則會(huì)導(dǎo)致無法正確卸載）。 在添加刪除子程序中，選中“ KSOA 服務(wù)”，點(diǎn)擊“更改 /刪除”按鈕后程序出現(xiàn)以下界面： KSOA 技術(shù)手冊(cè) 26 選擇“刪除所有的已安裝功能”，點(diǎn)擊“下一步”后系統(tǒng)會(huì)自動(dòng)進(jìn)行程序刪除。 卸載完畢后，可以將 SQL server 中的安裝時(shí)產(chǎn)生的兩個(gè)數(shù)據(jù)庫 skmaster 和 ksoa 手動(dòng)刪除，也可不刪除。下次重新安裝時(shí)系統(tǒng)會(huì)提示覆蓋。 4 配置 Web 服務(wù)參數(shù)修改 一般情況下， Web 服務(wù)在服務(wù)器安裝完成后即可正常使用。在某些特殊情況下，例如 Web 服務(wù)器遷移到其他的計(jì)算機(jī)或者數(shù)據(jù)庫服務(wù)器連接用戶名密碼改變等，則需要手動(dòng)修改 Web 服務(wù)器的參數(shù)配置。 默認(rèn)情況下， Web 服務(wù)內(nèi)容將安裝在 C:\SKWebService\Tomcat\webapps\root 下， Web 服務(wù)的配置參數(shù)在 C:\SKWebService\Tomcat\webapps\root\WEBINFO\classes\。該配置文件為一個(gè)文本文件， 用記事本打開即可修改。示例如下： driver= （不能修改） =jdbc:jtds: =sa ＃數(shù)據(jù)庫登錄用戶名 = ＃數(shù)據(jù)庫登錄密碼 =100 KSOA 技術(shù)手冊(cè) 27 =2 conntimeout=3000 ＃數(shù)據(jù)庫連接超時(shí)，默 認(rèn)為 3000 毫秒（也就是 3 秒），此項(xiàng)可以根據(jù)用戶的網(wǎng)絡(luò)環(huán)境而設(shè)定 debug=false mailhome= C:/SKWebService/mailhome pagesize=15 addresssize=10 其中主要的需要修改的參數(shù)部分就是： =jdbc:idae7:localhost:1433?charset=gbkamp。database=st_KSOA 其格式如下： =jdbc:idae7:[數(shù)據(jù)庫服務(wù)器名稱 ]:[數(shù)據(jù)庫端口號(hào) ]?charset=gbkamp。database=st_KSOA SQL Server 數(shù)據(jù)庫端口號(hào)默認(rèn)為 1433 端口，一般情況下不用修改它。 數(shù)據(jù)庫服務(wù)器名稱根據(jù)需要可以做修改。 服務(wù)控制臺(tái)參數(shù) 默認(rèn)情況下，只有許可認(rèn)證服務(wù)是在服務(wù)控制臺(tái)啟動(dòng)時(shí)同時(shí)啟動(dòng)的，而其他的服務(wù)模塊（如短信、計(jì)劃任務(wù)等）需要手動(dòng)啟動(dòng)，也可以在每個(gè)服務(wù)模塊自己參數(shù)設(shè)置中設(shè)定“服務(wù)控制臺(tái)啟動(dòng)時(shí)自動(dòng)啟動(dòng)服務(wù)”。 服務(wù)控制臺(tái)參數(shù)設(shè)置詳情請(qǐng)參見相關(guān)技術(shù)手冊(cè)。 金 /銀卡安裝說明 金 /銀卡的安裝與授權(quán)注冊(cè)的工作步驟如下： ? 在服務(wù)器端產(chǎn)品安裝完成后，在正式注冊(cè)之前，先退出服務(wù)控制臺(tái)程序 、 Web 服務(wù)控制臺(tái)； ? 插入金 /銀卡，啟動(dòng)服務(wù)控制臺(tái)程序。 ? 在客戶端產(chǎn)品安裝完成以后，進(jìn)入系統(tǒng)控制臺(tái)，執(zhí)行“授權(quán)注冊(cè)”模塊，生成系統(tǒng)標(biāo)識(shí)。 ? 將該系統(tǒng)標(biāo)識(shí)值發(fā)送給北京時(shí)空超越科技有限公司相關(guān)注冊(cè)服務(wù)人員。 ? 得到時(shí)空反饋碼后，將反饋碼輸入到相應(yīng)輸入框中，并保存信息。 ? 再重新啟動(dòng)服務(wù)控制臺(tái)程序，并啟動(dòng)“ Web 服務(wù)控制臺(tái)”。 KSOA 技術(shù)手冊(cè) 28 5 常見問題 問題一： KSOA Web 服務(wù) 無法啟動(dòng)（啟動(dòng)服務(wù)時(shí)看不見 Tomcat 字樣的命令行窗口，或者啟動(dòng)后過幾秒 Tomcat 命令行窗口自動(dòng)消失）。 解答：一般情況下有兩種可能會(huì)導(dǎo)致 Web 服 務(wù)無法啟動(dòng)。 第一、用戶安裝了 IIS 的 ”World Wide Web Publishing Service” ，或者如 Apache 等等其他的 Web服務(wù)器，由于 KSOA的 Web服務(wù)設(shè)定使用 80端口作為服務(wù)端口，這使其他的 Web服務(wù)與 KSOA Web服務(wù)沖突。 IIS 的 ”World Wide Web Publishing Service” 可以參考 KSOA 服務(wù)端安裝的安裝檢查來解決該問題。 第二、在安裝其他軟件供應(yīng)商的應(yīng)用程序時(shí)，安裝了別的版本的 JDK，并且該 JDK 的版本低于（如 JDK 或者 JDK ），導(dǎo)致在環(huán)境變量中的 JAVA_HOME 設(shè)置為其他版本 JDK 的安裝路徑，解決辦法時(shí)將環(huán)境變量中的 JAVA_HOME 設(shè)置為 C:\SKWebService\。如果不清楚如何設(shè)置環(huán)境變量請(qǐng)咨詢系統(tǒng)管理員。 第三章 KSOA客戶端安裝 1 安裝前