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

　　

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