You are on page 1of 60

URBANSMSSoilManagementStrategy

Software installation manual


Web application URBAN SMS suite
January, 2012

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

UrbanSMS
WP4
UrbanSMSTools
InstallationGuide

Technicaltrainingversion

Saved: Friday,January27,2012
Print:

Sunday,29January2012

CGSPlusd.o.o.

Page:1/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Content

UrbanSMS .............................................................................................................................................................. 1
WP4 ........................................................................................................................................................................ 1
UrbanSMSTools .................................................................................................................................................... 1
InstallationGuide ................................................................................................................................................... 1
Content................................................................................................................................................................... 3
1 Hardwarerequirements ................................................................................................................................. 5
2 Softwarerequirements .................................................................................................................................. 7
2.1
Importantsoftware ................................................................................................................................ 7
2.1.1
IIS6 ................................................................................................................................................. 7
2.1.2
Messagequeue............................................................................................................................... 7
2.1.3
GrassGISsoftware.......................................................................................................................... 8
2.1.4
MapGuideMaestrosoftware ......................................................................................................... 8
2.1.5
MapGuidesoftware........................................................................................................................ 9
3 UrbanSMSwebapplication(CD) .................................................................................................................. 11
3.1
UrbanSMSCDcontent....................................................................................................................... 11
4 InstallationofGrassGISengine.................................................................................................................... 11
5 ConfigurationsettingsoftheMessageQueue............................................................................................. 17
5.1
VerifyGrassinstallation........................................................................................................................ 17
6 InstallationofMapGuideopensource,version2.1.0 .................................................................................. 18
7 InstallationoftheMapguideMaestro2.1................................................................................................... 24
7.1
SetupofMapGuideMaestrowebservice ............................................................................................ 26
8 Mapadminsetpackages .............................................................................................................................. 47
9 ConfiguringtheUrbanSMSwebapplication ................................................................................................ 49
9.1
SettinguptheWeb.configfile .............................................................................................................. 49
9.2
IISsettings............................................................................................................................................. 51
9.3
Security ................................................................................................................................................. 54
9.4
Createfolderandcopydata ................................................................................................................. 55
9.5
Batchfiles ............................................................................................................................................. 55
9.5.1
SettingstheBATCHfileforGRASS................................................................................................ 55
9.6
TroubleshootingtheWebApplication ................................................................................................. 56
10
Createdatabase........................................................................................................................................ 56
11
MapGuidesettings ................................................................................................................................... 58

Page:3/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Aboutatask
ProjectUrbanSMS
http://www.urbansms.eu
WP4SoilManagerSuite
WPresponsible:
dr.BorutVraj,
AgriculturalInstituteofSlovenia,Hacquetova17,SI1000Ljubljana,Slovenia
Contact:cto@kis.si

Subcontractor:
CGSplus,InnovativeITandEnvironmentalTechnologies,d.o.o.
Brnievaulica13,SI1000Ljubljana,Slovenia
http://www.cgsplus.com/
Toolprogrammingteam:
Msc.MatjaIvai,univ.dipl.ing.geod.
Msc.DejanGregor,univ.dipl.ing.
Mr.DejanKos
Mr.AndrejBeden,
Dr.AlenkaajnSlak
Contact:Matjaz.Ivacicv@cgsplus.si

Page:5/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Aboutadocument

ThisdocumentpresentstheUrbanSMSsoftwareinstallationmanual.

Documentstage:Finalversion,December2011
Authors:
Msc.MatjaIvai,univ.dipl.ing.geod.
Msc.DejanGregor,univ.dipl.ing.
Mr.DejanKos
Mr.AndrejBeden,
Dr.AlenkaajnSlak
Contact:Matjaz.Ivacicv@cgsplus.si

Abstract
ThisdocumentrepresentsallstepsforsuccessfulUrbanSMSsoftwareinstallation.Itdescribesbasic
softwareaswellashardwarerequirements,systemconfigurationofdataanduserwebapplication.
Thedocumentdescribesstepbystepstepsforsuccessfulinstallationandsuggeststhebasicsettings
toenabletheeffectiveuse.

Page:6/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

1 Hardwarerequirements
MinimumServer,processor1,8GHZ(dualcore),2GBram,80GBdisk

2 Softwarerequirements
ThefollowingsoftwareisrequiredtoruntheUrbanSMSTools:

Microsoftserver2003Servicepack2
o IIS6
o Messagequeue
MicrosoftSQLserver2008>allversion
.NETFramework2.0,3.5
GrassGIS
MapGuideOpenSource
MapGuideMaestro

2.1 Importantsoftware
2.1.1 IIS6
YoumusthaveinstallIIS6.

CheckInternetinformationservices(IIS)

2.1.2 Messagequeue
YoumusthaveinstallMessagequeue.

Page:7/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

CheckMessageQueuingandclickDetailsandcheckTriggers

2.1.3 GrassGISsoftware
GeographicResourcesAnalysisSupportSystem,commonlyreferredtoasGRASSGIS,isaGeographic
InformationSystem(GIS)usedfordatamanagement,imageprocessing,graphicsproduction,spatial
modelling,andvisualizationofmanytypesofdata.ItisFree(Libre)Software/OpenSourcereleased
underGNUGeneralPublicLicense(GPL).GRASSisofficialprojectoftheOpenSourceGeospatial
Foundation.
MainGrasswebpage:
LinktoGRASSinformationsite:
http://grass.osgeo.org
LinktosetupfilewithWinGrass6.4
http://grass.osgeo.org/grass64/binary/mswindows/native/WinGRASS6.4.0RC61Setup.exeorFTP
OtherusefulGrassinformation:
http://grass.itc.it/
TodownloadGrassreferencemanualspleasevisit:
http://grass.itc.ireferencet/grass65/manuals/html65_user/index.html

2.1.4 MapGuideMaestrosoftware
MapGuideMaestroOpenSourceisawebbasedplatformthatenablesuserstodevelopanddeploy
webmappingapplicationsandgeospatialwebservices.
MainMapGuideMaestroprojectopensourcehopewebpage:
http://mapguide.osgeo.org/

Page:8/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

DownloadMapGuideMaestrosoftware
http://download.osgeo.org/mapguide/maestro/MapGuide%20Maestro%202.0.msiorftp
TodownloadMapGuideMaestromanualspleasevisit:
http://trac.osgeo.org/mapguide/wiki/maestro/UserGuide

2.1.5 MapGuidesoftware
http://download.osgeo.org/mapguide/releases/2.1.0/MapGuideOpenSource2.1.0.4283Final.exeor
ftp

Page:9/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

3 UrbanSMSwebapplication(CD)
3.1 UrbanSMSCDcontent
Forasuccessfulsoftwareuse,thefollowingsoftwareshouldbedownloadedinfurthersixsteps:

1.)
2.)
3.)
4.)
5.)
6.)
7.)

InstallGrass
ConfigMessageQueue
InstallMapGuide(server)
ConfigMessageQueue
InstallMapGuidemaestro
ConfigDatabase
ConfigUrbanSMSwebapplication
a. Webconfig

4 InstallationofGrassGISengine
WhenenteringtheGrassdownloadpage,pleasefollowstepbystepGrassinstallationprocedure:
Step1:RunGrassSetup

ClickNext

Step2:AcceptGrassLicenseAgreement.

ClickNext

Page:11/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Step3:AcceptGrassLicenseAgreement.
SelecttheGrassfolder.Toavoidpossibledifficultiesitissuggestedthatyouchangelocationto
C:/Grass.

ClickNext

Step4:SelectComponentstoinstall.
Thereisnoneedtoinstalldemodatasets.

ClickInstall(installationmighttakeafewminutes)

ClickNextwhencompleted

Step5:Whentheinstallationiscomplete

Page:12/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

NowtickLaunchGRASSGISandclickFinish

Grassisnowinstalled;pleasetickLaunchGRASSGISandclickFinish.

Step6:RuntheGrassapplicationandstartwithGrassconfiguration

Page:13/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Point1:ClickBrowse
Inpoint1clickbrowseandselectmapwherewillyouhavesaveddataandwriteprojectlocationin
point2.Importantprojectlocationcanbeonlyonewordorphrase.

Point2:Clickthelocationwizard
Inpoint1,pleaseselectyourlocationandthenclicknext.(Point2).Pleasechoosearbitrarynon
earthcoordinatesystem(XY),ifyouarenotfullyfamiliarwithotheroptions.

Page:14/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Clickfinish(point1)

InwarningwindowyouonlyclickOK.(VreduinSlovenian)

Point3:
TypeinthenameofyourmapsetandclickOK:

ClickOK(Vredu)

NowGrassisinstalledandconfiguredwithallbasicsettings.

Page:15/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

5 ConfigurationsettingsoftheMessageQueue
Goto:Start/ControlPanel/AdministrativeTools/ComputerManagement.

RightclickonPrivateQueuesandselectnew>PrivateQueue

SetthenameforQueueandselectTransactional

Potentialproblems:
MessageQueuemayhaveproblemswithexecutingofthebatchfile,soitsnecessarytosetthe
rights(permissions)fortheimplementationoftheMessageQueue.

5.1 VerifyGrassinstallation
RunGrassfromStart>AllPrograms>Gras64>Grass6.4.ORC6
Aftersuccessfulinstallation,Grassisstartedshowingthefollowingwindowonthescreen:

Page:17/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

6 InstallationofMapGuideopensource,version2.1.0
Step1:Installationstartswiththefollowingwindow.PleaseclickNext:

ClickNext

Step2:Tomoveforward,youshouldagreewiththelicenseagreement

Page:18/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

YoumustacceptthetermsintheLicenseAgreementandthenclickNext

Step3:Selectyourserver

SelectIISConfigurationandthenclickNext
Step4:Selectthetechnologyonwhichyouwishtorunthesoftware

Select.NETandthenclickNext

Step5:Createtheapplicationpool
Youcanchangetheapplicationpooloronlyclicknext.

Page:19/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Clicknext

Step6:TheIPaddressforMapGuideservershouldbeprovided

ItisrecommendednottochangetheIPaddress.PleaseclickNext

Step7:Selectthepathforyourinstallation

ClickNext
Step8:MapGuidecomponent

Page:20/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

ClickNext
Step9:Startinstallation

ClickInstall
Step10:PleaseclickFinishtocompletetheinstallation

ClickFinish

Step11:Tobeabletousethesoftware,thesystemmustberestarted.

ClickYes

MapGuideOpenSource2.1.0isnowinstalledonyourcomputer/server.
Step12:CheckifyouhaveAllowedASP.NET

Page:21/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

ClickAllow

Step13:YoumusthaveselectedrightASP.NETversion2.0.59727

Select2.0.59727
Step14:IntabDirectorySecuritybrowseforadminuseronyourserver.Toexecutealloperation
applicationneedfullaccess.YoumustalsocheckIntegratedWindowsauthentication

Page:22/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Browseadminuser

Step15:InapplicationpoolyouneedtochangeIdentitytoLocalSystem

InapplicationpoolidentityselectLocalSystem

Page:23/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

7 InstallationoftheMapguideMaestro2.1

Important:BeforeinstallingMapguideMaestro,IIS6needstobeinstalledfirstonyour
computer/server.
Step1:PleaseopentheMapguideMaestrodownloadpageandclickNexttostarttheinstallation
sequence

ClickNext
Step2:Pleaseacceptthelicenseagreement

ClickNext
Step3:Selectthedesiredcomponentstobeinstalled

Page:24/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

ClickNext

Step4:TostarttheinstallationoftheMapGuideMaestro,pleaseclickInstall

ClickNext
Step5:Installationisnowfinish

ClickNext

Page:25/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

7.1 SetupofMapGuideMaestrowebservice
MapguideOpenSourceisnowinstalled.Thenextstepistoconnecttothemapagenttroughthe
MapGuideMaestro.Todothat,weneedtoconfigtheinputdatapathfirst.
1.) Pleaseselectyourdatapath,usernameandpassword

ClickNext
2.)

ClickCreateanewresource
3.)

SelectFolder

Page:26/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

4.)

Selectthefoldername(e.g.UrbanSMS)
5.)

Clickwithrightmousebuttononfoldername(inourcaseUrbanSMS)andthenselectNew>Folder
Itisveryimportantthatthefollowingfilestructureisused:
Data
Layers
Layouts

Maps

Page:27/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

6.)

ThenrightclickonDatafolderandthenselectNew>Dataconnection

Thenselectthedataproviderforyourconnectionfromthelist.

SelectproviderandthenclickOK

Page:28/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

7.)
PleaseNote:Youcanselectdifferentproviders(pleaseseethefollowingexamples):
a) GDAL

Configurationdataconnection

Point1:Copythephysicalpath:
C:\Data\urbansms\GISData\12.5\USMS\ToolData\gOM\
Point2:Testtheconnectiontomakesureeverythingisinorder(Providerreportsnoerrors)
Point3:Selectthecoordinatesystem
ThenclickAddanewcoordinatesystemoverride

ClickonSource

Page:29/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

SelectthecoordinateCategory:

Andthencoordinatesystem:

FinishselectionwithOK.

ClickOKandrepeatthisprocedurealsoforTarget

Point4:SaveDataconnection

Page:30/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

ProgramwillprobablyaskyouifyouwanttosavetheDataconnectionregardlessthewarnings
reported.YoucanclickYes.

b.)SHAPE

Point1:CopythephysicalpathwheresourceisExample:
C:\Data\urbansms\GISData\12.5\USMS\ToolData\gOM\
Point2:Tooltipcanshowuserdatawithsomeparameters.
Point3:Youcanchangevisibilityofdatafromthetablewithselectiononcheckboxvisible.
Point4:Youcanaddrole:
Point5:Youcandeleterole:
Point6:Typeintherule:

Page:31/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

ByclickingontheProperties,youcanviewtheshapes.
Exampleforrole:
AS_<20
AndthenclickOk.
Point7:Youcanchangethecolourofthetypedrole.
Point8:ItisalmostthesametotheTooltip,youcanaddthelabelontheselectedrole(withyour
data).
Example:CONCAT(AS_,'Asmg/kg')
Point9:Allrolesyoucanalsoaddtothelegendwithsomeshortdescription.

8.)

PleaseselectthefolderDataandtypeintheResourcenamewithoutaspecialcharacter.Thenclick
OK.
9.)
WehavenowcreatedtheDataConnection.

Page:32/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

ThenextstepistocreatetheLayer.

RightclickonthefolderLayerandthenselectNew>Layer
10.)

Clickon

Page:33/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

11.)

SelecttheDataconnectionfromthefolderData.

Page:34/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

12.)

Oneachlayeryoucanchangeseveralproperties.Forexample;thevisibilitysettingsdeterminethe
scalesonthewebpagefromwhichthelayerwillbevisible(Zoominginandout).
ClickSaveforsavepropertiesofthislayer.
13.)

SelectthefolderLayerandtypeinthemaneforResourcename.NOTE:pleasedonotusespecial
characters.Tofinish,clickOK.

Page:35/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

14.)

RightclickthefolderMaps,thenselectNewandthenMap
15.)

Page:36/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Point1:Select
Point2:SelectCoordinateCategory
Point3:CoordinateSystem
Point4:ClickOK
Point5:Indescription,typeintheprojectname(Example:UrbanSMS)
16.)
IntheLayersbygrouptabclickontheiconthatstandsforAddanewgroup.
Ontherightside,youcanthenchangethelayersproperties(nameandlegendlabel)ofthisadded
group.

Page:37/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

ThefollowingLayergroupsaresuggested:

17.)

InLayersbygroupclickonAddanewlayertothemap

Page:38/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

18.)

SelectthefolderLayersandthenlayerswhichyouwouldliketoshowonthemap.ThenclickOK.

Page:39/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

19.)
Thisisanexamplefortheaddedlayers.

Point1:Youcanchangethepropertiesoftheseaddedlayers.
Point2:Youcanchangetheproperties,foradded/selectedlayerswhicharepresent/visibleonleft
sideofthewebpage.Ifthisistickedthismeanstrue,otherwiseitisfalse.
Point3:Savemaps

Important:LayernameinNameboxMUSTbeidentical!

Page:40/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

SelectthefolderLayerandtypeintheResourcenamewithoutspecialcharacters.ThenclickOK.

Page:41/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

20.)
InthetabLayerbydrawingorderyoucanchangetheprioritybywhichthelayerswillbeshownon
thewebpage.

21.)ThedatalayersasseenintheDataandLayerfolders

Page:42/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Layers

Data

Page:43/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

22.)

RightclicktheLayoutsandthenselecttheNew>Layout

23.)

Insertthetitlename.(Example:UrbanSMS:Celje)
InsertSelect(Pleaseseethenextpicture)
Inserttheinitialtaskintaskpane.Theninsert"../../urbansms/SoilManagenmentTools.aspx"
Note;pleaseinserttheinitialtaskintaskpane.ThensaveLayouts(seenextpicture)

Page:44/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

SelectthefolderMapsandselectcreatedmap.

SelectthefolderLayoutsandtypeintheResourcenamewithoutspecialcharacters.ThenclickOK.

Page:45/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

OnLayoutsyoucanalsochangethedefaultmenu.Itissuggestedusethefollowing(dependsonthe
usersneeds).

Page:46/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

8 Mapadminsetpackages
domain/mapguide/mapadmin/
Defaultusername:Administrator
Defaultpassword:admin
MapadminLogin

Typeintheusernameandpassword

Importpackages
Tomakethepackagesyoumusttypeinthenameoflibrary(E.g.Library://UrbanSMS/andcustom
name(forexample;urbanSMS_2010).ThissavesallsettingsfromMaestroto*.mgp
Ifyouhavemoreversions/datayoucandynamicallyloadthemwithacommandLoadPackage.

Select/tickandloadthedesiredpackage

Page:47/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

OnCDyouhavetestdata.PleasecopyTest_UrbanSMS.mgptoC:\Program
Files\OSGeo\MapGuide\Server\PackagesandthenfindcategoryLoadPackegainclickLoad
Package.

9 ConfiguringtheUrbanSMSwebapplication
9.1 SettinguptheWeb.configfile
Web.configisasettingsfile,whichislocatedonthesameplaceastheapplication.

URLpathfromUrbanSMSwebapplication
<addkey="urlPage"value="http://localhost/UrbanSMSWeb/"/>

RootURLpathfromdomain
<addkey="urlRoot"value="http://localhost/"/>

LayoutsfromMapGuidemaestro
<addkey="webLayout"value="Library://UrbanSMS/Layouts/layout_UrbanSMS.WebLayout"/>

UserfromMapGuidemaestro
<addkey="defaultUser"value="Administrator"/>

PasswordfromMapGuidemaestro
<addkey="defaultPassword"value="admin"/>

MapnamewhichuseMapGuidemaestro
<addkey="mapName"value="map_UrbanSMS"/>

GrassWorkspacewhichwassetup
<addkey="grassWorkSpace"value="@celje"/>

ResultnameshouldbethesameasinMaestroinfoldermap(layername)
<!TOOLS1>
<addkey="tools1result"value="esq_result"/>
<!ENDTOOLS1>
<!TOOLS2>
<addkey="tools2result"value="gNS_result"/>
<!ENDTOOLS2>
<!TOOLS3>
<addkey="tools3result"value="gSC_result"/>
<!ENDTOOLS3>
<!TOOLS4>
<addkey="tools4result"value="asq_result"/>
<!ENDTOOLS4>
<!TOOLS5>
<addkey="tools5result"value="asq_result"/>

Page:49/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

<!ENDTOOLS5>
<!TOOLS6>
<addkey="tools6result"value="asq_result"/>
<!ENDTOOLS6>
<!TOOLS7>
<addkey="tools7result"value="asq_result"/>
<!ENDTOOLS7>
<!TOOLS8>
<addkey="tools8result"value="asq_result"/>
<!ENDTOOLS8>
<!TOOLS9>
<addkey="tools9result"value="asq_result"/>
<!ENDTOOLS9>

Ifyouhaveanyproblems,youcanenableloggingintheUrbanSMSapplication;

<!0NO1YES>
<addkey="EnableLoging"value="0"/>

PathforlogowhichispresentinthePDFreport;
<addkey="pdfHead"
value="E:\projekti\test\UrbanSMS_solution\UrbanSMSWeb\images\urbansms_central_logos_euro.j
pg"/>

Geometrydoesntchange;
<addkey="Geometry"value="Geometry"/>

Nameofthemessagequeue;
<addkey="MessageQueueName"value="UrbanSMS"/>

Pleasedonotchange;
<addkey="customPolygonLayerName"value="Customlayers"/>

ApplicationsIDfromyourapplication(inaspnet_Applicationstabel)
<addkey="applicationID"value="CA67C06EFF7B4B2BA733CB5C15FF1CBD"/>

PathforGrasscolourpath;
<addkey="color_grass_path"value="C:\ProgramFiles(x86)\GRASS64\etc\colors\"/>

Physicalpathfortheapplication;
<addkey="pathAppliaction"value="E:/projekti/test/UrbanSMS_solution/UrbanSMSWeb/"/>

DefualtGrasslayerforprojection;
<addkey="defaultGrassName"value="gNS_K"/>

Page:50/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Timedelayinmillisecondstimebetweenexecutionreport.Ifyouhaveslowserverincrease
number.(delayforalltoolsandfordelayLsrforLSRtools)
<addkey="delay"value="10000"/>
<addkey="delayLsr"value="20000"/>

9.2 IISsettings
ProjectUrbanSMSneedspermissionsforworkinIIS.Soitsveryimportentthatwesetallsettingsin
IIS.
Step1:AddurbanSMSmapinvirtualdirectory.Gotowwwrootfindmapurbansms,rightclickselect
properties,gototawWebSharingandcheckRead,WriteandExecute.

Step2:SetdirectorySecuruityonIIStospecialuserwithadministrationpermissionandcheck
IntegratedWindowsauthentication.

Page:51/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Step3:GotoServicesandfindASP.NETStateService,setStartupTypetoAutomaticinstarthim.

Step4:InstalMSChartwhichyoucanfoundonyourCD.

Page:52/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

ClickNext

NowyoumustacceptlicensetermandclickNext

Page:53/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

IfwasMSChartsuccessfullyinstall,thenyougetmessageThesoftwareupdatehasbeeninstalled
successfully.

Andnowrestartyourserver.

9.3 Security
Thewebapplicationcratesfilesindifferentfolders.Itisthatforimportanttosetthecorrect
permissiononthefolder:

Path:webapplication/BatchFile/
Path:webapplication/BatchFile/rule/
Path:webapplication/images/chart/
Path:webapplication/Log/
Path:webapplication/BatchFile/
Path:webapplication/Report/
Path:webapplication/Report/picture
Path:webapplication/Report/txtResult
Path:Grasspath/etc/colors

Page:54/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

SetFulControl

9.4 Createfolderandcopydata
CratefolderinC:(C:/Data/urbansms/GISData/)andthenextractfilefromCDUrbanSMSCE
demoDATA_5m_V6.0.ZIPandcopyinthisfolder.
Thisisresult:C:\Data\urbansms\GISData\5\USMS\

9.5 Batchfiles
Path:webapplication/BatchFile/

9.5.1 SettingstheBATCHfileforGRASS
TheWebapplicationholdstheBatchFilefolder(GrassSettings.bat),whichmustbereplacedwithyour
datafromtheGRASS.RunGrassfromyourdesktopandthenwriteintheCMD(inGRASS):

set.EditGrassSettings.batandchangepathfromdifferentfoldertoyourpath.(whatyou
getinGrassonlycopy).Whenthisisdone,pleasesaveyoursettings.
r.in.polyoverwriteinput="c:\Inetpub\wwwroot\urbansms\init_mask.txt"output=init_mask
(c:\Inetpub\wwwroot\urbansms\>rootpathfromyoururbansmsapplication)

Init_mask.txtfileconsistscoordinatesofLowerLeftandUpperRightboxforprojectarea.Pleasebe
carefulwithdataformat.

Page:55/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Sampleofinit_mask.txt

9.6 TroubleshootingtheWebApplication
Webapplicationcansometimesreporterrors.Toovercomethisandsolvetheproblem,thereare
severalscenarios:

Webapplication
Gotothewebaplication/web.configandfindtheposition<add key="EnableLoging"
value="0"/>. Changethevalueto1.Lookingatthewebaplication/Log/log.datayouview
theerrormessageandalsootherinformation.
MapGuide
CheckthelogfromtheMapGuide.GotoC:\ProgramFiles\OSGeo\MapGuide\Server\Logs.txt.
ExploringthelogsyoucanmakesureifsomethingiswrongwiththeMapGuide.
Report
Ifthereportisempty,thismeansthereisaproblemwiththeGRASS.Thenyoumustrestart
server.

Sometypicalproblems:

Goingintoselectedtool,theRequiredDatasetAvailabilityusuallyholdssomeinformation.In
casethisisempty,itprobablymeansthatthenameinthewebapplicationisdifferentfrom
thenameinMaestro.
o Errorinthewebaplication/Log/log.data
setLayerVisibleNapaka:OSGeo.MapGuide.MgObjectNotFoundException:Thespecifiedobjectwas
notfound.GetItem()line117file
c:\osgeo\mapguide_21\mgdev\common\foundation\Data/NamedCollection

Solution:ThedatalayernameinMaestroandwebapplicationmustbeidentical.Pleasemakesure
thisistrueandcorrectthelayernames.

10 Createdatabase
UrbanSMSapplicationusedatafromdatabase,forthisreasonwemustcratedatabaseinSQLServer
2005or2008.YoucanuseexistingSQLserverorinstallnow.(SQLServer2008R2Express)

Page:56/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Typenamefordatabase
Foraccessfromurbanismsapplicationtodatabaseyouhave2option,youcanusespecialuser,or
usenetworkservices.Forboutcaseyoumustaddpermissionondatabase.GotoSecurty>Login
>rightclickandfindtheuser.

Searchtheuserforlogin

ThesomeprocedureisforaddnewuserindatabaseUrban_SMSandgivehimownerpermission.

NowyoucanexecuteSQLscriptwhichcanyoufindonCD.(urban_sms.sql)

Page:57/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

11 MapGuidesettings

ThedefaultlocationfortheMapGuideOpensource:
C:\ProgramFiles\OSGeo\MapGuide.
InthesetupfileyoucanfindtheZIPfile;www.zip,whichmustbecopiedtotheC:\Program
Files\OSGeo\MapGuide\Web\www\viewerfiles(thisisoneofthefilesettingsforMapGuide)

Copywebconfig.inifromc:\ProgramFiles\OSGeo\MapGuide\Web\www\to
c:\Inetpub\wwwroot\urbansms\.

Copyserverconfig.inifromCDtoC:\ProgramFiles\OSGeo\MapGuide\Server\bin\andreplaceolder
serverconfig.ini.(ifyouhavedefaultinstallation,butfirstmakebackup)
Defaultlogin:
Username:Administrator
Password:admin007$

12 Administrationofusers
Administratorcanadd,deleteandeditallusersinUsertab.

Administratorcanaddnewuserwithfollowingnextrules:
User name is customized, but ppassword must consist Letters (abc),Numbers (123) and Special
characters(&%$#...).Forexample:
abc123$
Alltogetherpasswordshouldnotbeshorterthan6characterstogether.
User can be deleted only at first setup, before start to use UrbanSMS application. If you want to
disableloginforspecificuseryoujustsetvalueinfieldIsLockedOuttotrue.

Page:58/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

Whenusertypeswronglyhispasswordmorethanthree(3)times,passwordislockedandonly
AdministratorcanchangeIsLockedOutbacktofalse.

13 AdministrationofSMStools

WhenyoufinishedwithinstallationprocedureyouhavetogotoAdministrativeModulandforeach
toolcompletethefollowing:
ForNStooltheprocedureisasfollows:
Gotohttp://domain/urbansms/Admin/DetailData.aspx?toolid=2
(DomaininCeljecaseisforexample:urbansms.celje.si:8000)

Step1.
OpenEditunderEditInputDataNutrientStatus(NS)andconfirmthesettingswithUpdate.Itis
enoughtoupdatefirstrawinatableonly.

Step2.
Open Edit under Data interpretation & legend and confirm the settings with Update. It is
enoughtoupdatefirstrawinatableonly.

Step3.
Whenfinishstep1.and2.youhavetochecktheresultswithclickonSaveandtestunderTool
Algorithms.

Pleaseseethepictureandstepnumbersbellow.

Page:59/60

Interreg CENTRAL Urban SMS

WP4 Soil Manager Suite

WhenyousuccessfullyfinishedSaveandtestbuttonyoushouldget(incaseofNStoolforCelje)
thefollowingmessage
Successfullysavedandtested!|Rangeofdata:min=3.666667max=5.000000|)
Nowyouaresurethatinputdata,equationandlegendsettingsarecorrectforuseintheUrbanSMS
application.

Page:60/60

URBANSMSSoilManagementStrategy
This paper belongs to the following section of URBAN SMS work plan:
WP4 Soil manager suite / 4.4 update according local tests / 4.4.4 soil
manager suite

www.urban-sms.eu
Contact details of project partner commissioning / responsible for this
paper:
Borut Vraj, Agricultural Institute of Slovenia, Hacquetova 17, SI1000
Ljubljana, SI, cto@kis.si

This project is implemented through the CENTRAL EUROPE Programme


co-financed by the ERDF.
The paper in hand reflects the authors views and the Managing Authority
of the INTERREG IV B CENTRAL Programme is not liable for any use
that may be made of the information contained therein.

You might also like