Aras Innvatr Installatin Guide Aras Innvatr 9.2 Dcument #: 9.2.012292009 Last Mdified: 5/21/2010 Aras Crpratin
ARAS CORPORATION Cpyright 2010 All rights reserved Aras Crpratin 300 Brickstne Square Suite 904 Andver, MA 01810 Phne: 978-691-8900 Fax: 978-794-9826 E-mail: Supprt@aras.cm Website: http://www.aras.cm Ntice f Rights Cpyright 2010 by This material may be distributed nly subject t the terms and cnditins set frth in the Open Publicatin License, V1.0 r later (the latest versin is presently available at http://www.pencntent.rg/penpub/). Distributin f substantively mdified versins f this dcument is prhibited withut the explicit permissin f the cpyright hlder. Distributin f the wrk r derivative f the wrk in any standard (paper) bk frm fr cmmercial purpses is prhibited unless prir permissin is btained frm the cpyright hlder. Aras Innvatr, Aras, and the Aras Crp "A" lg are registered trademarks f Aras Crpratin in the United States and ther cuntries. All ther trademarks referenced herein are the prperty f their respective wners. Ntice f Liability The infrmatin cntained in this dcument is distributed n an "As Is" basis, withut warranty f any kind, express r implied, including, but nt limited t, the implied warranties f merchantability and fitness fr a particular purpse r a warranty f nn-infringement. Aras shall have n liability t any persn r entity with respect t any lss r damage caused r alleged t be caused directly r indirectly by the infrmatin cntained in this dcument r by the sftware r hardware prducts described herein. Page 3
Table f Cntents SEND US YOUR COMMENTS...6 1 OVERVIEW...7 1.1 GETTING STARTED...7 2 PREREQUISITES...8 2.1 MINIMUM SYSTEM REQUIREMENTS...8 2.1.1 Client...8 2.1.2 Server...9 2.1.3 Netwrk...9 2.2 OBTAINING AN UNLIMITED LICENSE KEY...10 2.2.1 Obtaining yur server MAC address...10 2.2.2 Requesting an Unlimited license...11 2.3 OBTAINING A SUBSCRIBER LICENSE KEY...12 2.3.1 Obtaining yur server MAC address...12 2.3.2 Requesting a Subscriber license...13 2.3.3 Installing the Subscriber license...13 3 UPGRADING FROM PREVIOUS VERSIONS...14 4 ARAS INNOVATOR INSTALL...15 4.1.NET CLIENT CONFIGURATION...15 4.2 INSTALLING ARAS INNOVATOR SERVER...15 4.3 RUN THE FILE INNOVATORSETUP.MSI...15 4.3.1 Welcme page...15 4.3.2 License Agreement...16 4.3.3 Prerequisites and Dcumentatin...17 4.3.4 Aras Innvatr Destinatin Flder...18 4.3.5 Setup Type...19 4.3.6 Custm Setup...20 4.3.7 License Cnfiguratin...21 4.3.8 Server Web Alias Setup...22 4.3.9 SMTP Setup...23 4.3.10 Vault Server Preferences...24 4.3.11 Cnfigure Database...26 4.3.12 Begin the Installatin...35 4.3.13 Installatin Status...35 4.3.14 Installatin Cmpleted...36 5 LOGGING INTO ARAS INNOVATOR...37 6 CONFIGURE ARAS INNOVATOR (OPTIONAL)...38 6.1 CLIENT CACHING CONFIGURATION...38 6.2 DB CONNECTION...39 6.3 UI TAILORING SECTION...40 Page 4
6.4 DISABLING THE COMPILING OF TEMPORARY DLLS...41 6.5 INSTALLING THE REPORTING SERVICE...41 6.6 CONFIGURING ARAS INNOVATOR FOR SINGLE SIGN-ON...41 6.7 CONFIGURING THE ARAS INNOVATOR SERVICE...42 6.8 CONFIGURING CUSTOM INSTALLATIONS...42 6.9 CONFIGURING ALTERNATE VAULTS INSTALLATIONS...43 6.10 CONFIGURING VAULT FILE UPLOAD SIZE LIMITS...44 6.11 CONFIGURING VAULT SECURITY...45 6.12 CONFIGURING SEPARATE CLIENT AND SERVER WEB FOLDERS...45 6.13 RESTART THE IIS SERVER AFTER CONFIGURATION CHANGES...47 7 SVG VIEWING REQUIREMENTS...48 7.1 CLIENT PC MACHINES AND SVG...48 7.2 WEB SERVERS AND SVG...48 8 TROUBLESHOOTING...49 8.1 LOGIN URL RETURNS THE CLIENT IS NOW CLIENT/....49 8.2 CLIENT SIDE ERROR LOGGING IN TO ARAS INNOVATOR...49 8.3 HTTP ERROR 404 - FILE OR DIRECTORY NOT FOUND. ON LOGIN...51 8.4 HTTP 500 INTERNAL SERVER ERROR ON LOGIN...51 8.5 CHECKING THE MDAC (MOUNTING ERRORS)...51 8.6 IMAGE BROWSER EMPTY PARENT PATHS DISABLED...52 8.7 MAIN GRID NOT PAINTING COLUMNS OR HEADERS...55 8.8 INSTALLING ARAS INNOVATOR TO A DEDICATED MICROSOFT SHAREPOINT SERVER 55 8.9 OPTIONAL VAULT CONFIGURATION PARAMETERS...56 9 DATABASE OWNER CONFIGURATION...57 10 RUNNING INSTALLER MULTIPLE TIMES...58 10.1 COMPLETE INSTALL THE FIRST TIME...58 10.2 MODIFY, REPAIR, OR REMOVE...58 11 ARAS INNOVATOR SERVER UNINSTALL...60 11.1 LOCATING THE UNINSTALLER WINDOWS SERVER 2003...60 11.2 LOCATING THE UNINSTALLER WINDOWS SERVER 2008...61 11.3 UNINSTALLING...62 Page 5
Send Us Yur Cmments Aras Crpratin welcmes yur cmments and suggestins n the quality and usefulness f this dcument. Yur input is an imprtant part f the infrmatin used fr future revisins. Did yu find any errrs? Is the infrmatin clearly presented? D yu need mre infrmatin? If s, where and what level f detail? Are the examples crrect? D yu need mre examples? What features did yu like mst? If yu find any errrs r have any ther suggestins fr imprvement, please indicate the dcument title, and the chapter, sectin, and page number (if available). Yu can send cmments t us in the fllwing ways: Or, Or, Email: Supprt@aras.cm Subject: Aras Innvatr Dcumentatin Pstal service: Aras Crpratin 300 Brickstne Square Suite 904 Andver, MA 01810 Attentin: Aras Innvatr Dcumentatin FAX: 978-794-9826 Attn: Aras Innvatr Dcumentatin If yu wuld like a reply, please prvide yur name, email address, address, and telephne number. If yu have usage issues with the sftware, please visit http://www.aras.cm/supprt/ Page 6
1 Overview Aras Innvatr is a Web-based system fr prviding cntrl and distributin f prduct infrmatin thrughut the internal and extended enterprise and during the entire life cycle f a prduct. Aras Innvatr is mre than typical dcument management it links cnfiguratin management, wrkflw, and dynamic tracking f prduct data. By leveraging the infrastructure f the Internet, suppliers and custmers can becme mre tightly invlved within a prduct life cycle, which directly imprves prcess efficiency, speed, quality, and lwers verall cst f business. Aras Innvatr is enterprise sftware that is 100% brwser-based making it easy t use, learn, and administer. Aras Innvatr is an pen slutin based n standard Internet prtcls such as HTTP/HTTPS, SOAP, and XML making integratin with legacy applicatins straightfrward and fast. 1.1 Getting Started This dcument prvides detailed instructin fr the installatin f a new Aras Innvatr server instance. The steps detailed in this dcument are intended t allw a nvice administratr t install Aras Innvatr. Hwever, mre general knwledge f system administratin, databases, and high-level prgramming (HTML, JavaScript and ActiveX) is required t fully custmize an Aras Innvatr package with required business rules. The fllwing is the sequence f steps t fully install and ready Aras Innvatr fr custmizatin. 1) Verify System Prerequisites 2) Aras Innvatr Server/Vault Server Installatin 3) Client Setup 4) Aras Innvatr Server/Vault Server Uninstall Nte: The fllwing installatin and setup prcess assumes that the Aras Innvatr Server instance, the Web Server, the Vault Server and the Aras Innvatr Database are lcated n the same machine. Hwever, each f these cmpnents can be lcated n different machines as lng as the hst and directry paths can be reslved ver yur netwrk. Page 7
2 Prerequisites Aras Innvatr requires several cmpnents fr prper peratin: Web Server Database Server Aras Innvatr Server 2.1 Minimum System Requirements Fllwing is a list f Minimum System Requirements t prperly install and perate Innvatr. 2.1.1 Client Platfrm Cmpnent Platfrm Revisin Operating System MS Windws Windws 7 Vista XP SP3 Web Brwser MS Internet Explrer 8 7 6.NET.Net Framewrk 3.5 3.0 2.0 SVG Viewer (Optinal) Adbe SVG Viewer 3.03 Cnfiguratin System Requirement Prcessr Speed Free Disk Space Main Memry Mnitr Pentium IV 1 GHz 80 MB 512 MB 1024x 768 reslutin with 16-bit clr. Page 8
2.1.2 Server Platfrm Cmpnent Platfrm Revisin Operating System MS Windws 2008 Web Server MS Internet Infrmatin Server.Net.Net Framewrk 3.5 2003 SP2 Relatinal Database MS SQL Server 2008 7 6 3.0 2.0 2005 Reprt Server (Optinal) MS SQL Server 2008 2005 Cnfiguratin System Requirement Prcessr Speed Free Disk Space Main Memry Mnitr Pentium IV 2 GHz 1 GB 1 GB 1024x 768 reslutin with 16-bit clr. 2.1.3 Netwrk Cnfiguratin System Requirement Netwrk File systems Micrsft TCP/IP Ethernet Netwrk Adapter NTFS Nte: Administrative privileges are required fr each server cmpnent t be prperly installed and/r cnfigured. Page 9
2.2 Obtaining an Unlimited License Key Aras Innvatr sftware requires a special license key in rder t run. The license key is unique t the server n which it will be run. In rder t btain a license key, yu must knw the MAC address f yur server. T autmatically generate a License Key visit the licensing page at http://www.aras.cm/supprt 2.2.1 Obtaining yur server MAC address The MAC Address (Physical Address) f the Aras Innvatr server is required in rder t generate a license key. The MAC address has the fllwing frmat: 00-50-04-2A-C1- E2. This machine id can be determined by running the fllwing cmmand in a Cmmand Prmpt windw: C:\>ipcnfig/all The cmmand will return the machine s cnfiguratin infrmatin, including the Physical Address (MAC address) as belw: Page 10
2.2.2 Requesting an Unlimited license Once yu have btained the MAC Address f yur server g t licensing page n the Aras website t autmatically generate a License Key at http://www.aras.cm/supprt Alternately, cmmunity member with an active subscriptin package can send an email t licenses@aras.cm r t yur accunt representative in the fllwing frmat: Subject License file needed Bdy Mac Address f the machine being installed n Versin f Innvatr Yu will receive a reply cntaining the fllwing infrmatin License Key generated Be prepared that the Aras Innvatr Setup Wizard will request this infrmatin, s have it ready. Page 11
2.3 Obtaining a Subscriber License Key Subscribers may request a license key that enables the use f additinal tls and features with the Aras Innvatr installatin. The license key is unique t the server n which it will be run. In rder t btain a license key, yu must knw the MAC address f yur server. 2.3.1 Obtaining yur server MAC address The MAC Address (Physical Address) f the Aras Innvatr server is required in rder t generate a license key. The MAC address has the fllwing frmat: 00-50-04-2A-C1- E2. This machine id can be determined by running the fllwing cmmand in a Cmmand Prmpt windw: C:\>ipcnfig/all The cmmand will return the machine s cnfiguratin infrmatin, including the Physical Address (MAC address) as belw: Page 12
2.3.2 Requesting a Subscriber license Custmers with an active subscriptin package can send an email t licenses@aras.cm r t yur accunt representative in the fllwing frmat: Subject Subscriber License file needed Bdy Mac Address f the machine being installed n Versin f Innvatr Yu will receive a reply cntaining the license key. 2.3.3 Installing the Subscriber license When yu receive yur Subscriber license key, yu will simply need t replace yur existing unlimited license key. 1) Edit the InnvatrServerCnfig.xml file fund in the rt f the installatin. 2) Replace the existing Unlimited license key <License lic_type="unlimited" lic_key="8405ae926ca286b14bbc58b8b0ab55ac"/> With the Subscriber license key yu received <!-- name=aras Crpratin mac_address=00-11-22-33-44-55 Versin=9.2 --> <License lic_type="unlimited" lic_key="a176bce863a286b14b7658b8b0ab5570" expires_n="2012-12-31"/> 3) Increment the CustmBuildVersin attribute by 1: <Innvatr> <UI-Tailring lgin_lg="... <IEClient RequiredSyncMde5="Never" CustmBuildVersin="2" /> <perating_parameter key="debug_lg_flag" value="false" />... 4) Restart the w3svc service(iis). Page 13
3 Upgrading frm Previus Versins The Aras Innvatr Installer can nt be used t upgrade yur Aras Innvatr cde tree r database frm a previus versin f Aras Innvatr. The versin f the database and the versin f the cde tree must match. If yu wish t upgrade frm a previus versin f Aras Innvatr, please review the Aras Innvatr Release Ntes t see what path t take r cntact Aras at inf@aras.cm t discuss yur upgrade ptins. Page 14
4 Aras Innvatr Install 4.1.Net Client Cnfiguratin The Aras Innvatr - Installatin Guide will walk yu thrugh the steps needed t install Aras Innvatr and upn cmpletin yur IT System Administratrs shuld review the Aras Innvatr -.NET Client Cnfiguratin. The Aras Innvatr -.NET Client Cnfiguratin dcument will walk yu thrugh the necessary steps t cnfigure client PC machines t run the Aras Innvatr sftware in the.net Framewrk. This dcument can be fund at http://www.aras.cm/supprt/ r in the Dcumentatin flder f the Aras Innvatr CD image. 4.2 Installing Aras Innvatr Server The Aras Innvatr installatin file (InnvatrSetup.msi) may be btained either frm http://www.aras.cm/supprt/ r the Aras Innvatr CD Image. Ensure that the Aras Innvatr installatin file (InnvatrSetup.msi) has been dwnladed t a lcal hard drive f the cmputer where the sftware will be installed. It is recmmended nt t delete this cpy InnvatrSetup.msi when the installatin is cmplete. 4.3 Run the file InnvatrSetup.msi Duble click n the file InnvatrSetup.msi t start the Aras Innvatr Installer. 4.3.1 Welcme page The first screen f the Installer is shwn belw. Click Next t prceed r Cancel t exit setup. Page 15
4.3.2 License Agreement Please read the license agreement carefully befre agreeing and prceeding with the install. This screen allws yu t print the license agreement using a rich text editr, such as Wrdpad, by selecting the Print buttn. The Next buttn will remain disabled until I accept the terms in the license agreement is selected. Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup. Page 16
4.3.3 Prerequisites and Dcumentatin Please ensure yu have reviewed the Aras Innvatr Installatin Guide and have all necessary cmpnents installed and cnfigured n the server. These checks are prvided as reminders f sme f the requirements fr installatin. Yu have Administratr lgin access t the IIS server Yu have administrative right n the cmputer yu are installing t, and have the IIS server installed and cnfigured. Yu have.net framewrk installed and cnfigured Either 2.0 (r higher) SQL Server is installed and yu have a lgin with admin privileges Yu have installed a MS SQL Server instance n the database server Yu must have SQL Server Authenticatin enabled Yu knw the SQL Server lgin/passwrds needed fr installatin. License Key issued frm Aras If yu have nt btained a license key at this time, please d s nw. See als Obtaining a License Key Request a license key Select the Request buttn t autmatically g t the license request page at http://www.aras.cm/supprt/ Dwnlad Installatin Dcumentatin Select the Request buttn t autmatically g t the dcumentatin page at http://www.aras.cm/supprt/ The Next buttn will remain disabled until all fur selectins are checked. Page 17
Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup. 4.3.4 Aras Innvatr Destinatin Flder This screen allws yu t pick the directry t which Innvatr will be installed. By default it is C:\Prgram Files\Aras\Innvatr but yu can click Change t select a directry f yur chice. This dcument will assume the default value. Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup. Page 18
4.3.5 Setup Type Specify either the Cmplete r the Custm ptin fr installatin. The Cmplete ptin will install Innvatr with all features. The Custm ptin allws the user t select nly the feature set necessary Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup. Page 19
4.3.6 Custm Setup If yu chse Custm Setup, yu will see this screen next. (If yu chse Cmplete, g n t the next sectin.) Chse the features f Aras Innvatr yu want installed: Innvatr Server and/r Vault Server and/r Databases. Select the services by changing the drpdwns t the left f each ptin. Nte the extra buttn n this dialg, here is what they d: Change - allws yu t specify the install directry. Help - gives help n this screen. Space - will shw disk size requirements and availability. Nte: This dcument will assume a cmplete installatin was chsen fr maximum cverage. If yu chse nly ne ptin it will represented nly by a subset f screens featured here. Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup Page 20
4.3.7 License Cnfiguratin License Key: A unique key btained frm If yu have nt btained a license key at this time, please d s nw. (See als Obtaining a License Key) Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup Page 21
4.3.8 Server Web Alias Setup Web alias - Web Alias is used t create the virtual directry fr the Innvatr Server and therefre t access Aras Innvatr. T access Aras Innvatr, yu will type a URL f the frm: http://<servername>/<web_alias> Fr example, if yu were t select the default Web Alias InnvatrServer, then yu will access it as: http://<servername>/innvatrserver Where <servername> is the name r IP address f the server hsting Aras Innvatr (if it is installed lcally then yu can just refer t the server as lcalhst ) It is recmmended that yu fllw standard web alias restrictins when selecting a name. If yu are unsure what this means, please restrict yurself t alphanumeric characters. It is als recmmended that the cmplete URL nt cntain underscre characters, because it can interfere with the lading f sessin ckies. Set up lcalhst fr Aras Innvatr This ptin is intended fr evaluatin purpses nly. This will reset the permissins fr the Lcal Intranet Zne f Internet Explrer, and add a.net Security Plicy fr http://lcalhst/<web_alias> t the installatin machine. A desktp icn will be added at the end f the installatin, giving yu instant access t the installed Aras Innvatr, with the minimum required permissins. It is nt recmmended t use this ptin when installing t a prductin server. Page 22
4.3.9 SMTP Setup This screen allws yu t specify the SMTP server t be used within Aras Innvatr t send emails n lifecycle prmtins, wrkflw tasks, etc. The SMTP Server value is set t queue by default, referring t the IIS mail queue. If yu wish t use this default, yu must then cnfigure the IIS SMTP Server t frward emails t yur SMTP Server. This can increase perfrmance f methds that cnstruct and send email frm Aras Innvatr by eliminating the need fr the available cnnectin t the SMTP Server. Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup. Page 23
4.3.10 Vault Server Preferences This screen allws yu t specify the Vault Name, the Applicatin Server URL, and the lcal path fr files fr the Vault Server which is used with the Aras Innvatr Server. Vault Name - The Vault instance t be installed. All new instances f Innvatr must cntain ne vault named Default. Alternate r additinal vaults may be cnfigured separately after the initial installatin. Applicatin Server URL - since Vault Server is nt a standalne applicatin, and is useful nly alng with the Aras Innvatr Server, this field allws yu t specify the Applicatin Server URL fr the instance f Aras Innvatr yu are ging t use with this Vault Server. The Applicatin Server URL is f the fllwing frmat: http://<servername>/<web_alias>/server/innvatrserver.aspx Where: <servername> is the name f the server where the Innvatr Server is running. Fr example, if it is running n the lcal machine, the server is lcalhst <web_alias> is the name f the Aras Innvatr Server Virtual Directry and cnsequently the name that is used t access the Aras Innvatr Server. This is the same Web Alias that yu specified earlier in Server Web Alias Setup. A best practice is fr a standard install is http://lcalhst/$[http_path_server]/server/innvatrserver.aspx Lcal Path Fr Files - the full lcal path t the directry n this machine where yu wuld like the files t be stred. This flder shuld be in a lcatin where there is sufficient disk space t accmmdate the files yu expect users t check int the system, and shuld als be in a lcatin where the files will nt be Page 24
deleted by prcesses ther than the Vault Server, as these files are being managed by Aras Innvatr. A best practice t select a flder with a knwn label that will nt be deleted in a lcatin with adequate disk space. The installer will default t the lcal drive with the mst available disk space and recmmend the \Aras\Vault flder. (Example: D:\Aras\Vault) Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup. Page 25
4.3.11 Cnfigure Database This screen allws yu setup ne r mre Aras Innvatr databases. Yu must have SQL Server Authenticatin enabled n yur Micrsft SQL Server instance t install and run Aras Innvatr. Database Server This refers t the SQL Server instance yu wish t install t. By default this is set t the first available SQL Server instance n the lcal machine, but can be set t any valid SQL Server Registratin instance. T set this value, simply key in the name f a knwn instance r select Brwse t see what SQL Server registratins the installer recgnizes as available. Cnfiguratin Optins This is the methd by which yu chse t install the Aras Innvatr database. Each ptin will be explained separately in the fllwing fur sub-sectins. Page 26
4.3.11.1 Create a new database This ptin is used t create a new database. This is the mst cmmn cnfiguratin fr new installatins f Aras Innvatr. DBA Lgin Optins In rder t install a database, we must first cnnect t the database server. There are tw methds f establishing a cnnectin t the database server. Windws Auhenticatin Cnnect t SQL server as the current lgged in user. SQL Server Authenticatin Cnnect as the SQL Server Administratr Lgin ID the lgin f the DBA with permissins t create new databases. Check with yur system s DBA what this parameter shuld be. Page 27
Passwrd the passwrd fr the lgin used t create the database. Again, check with yur system s DBA what this parameter shuld be. Yu will need t select Cnnect nce the lgin ptins have been filled ut. This will allw the installer t cnfirm cnnectin t the SQL Server instance befre prceeding. Database Lgin Optins Create a new database will als create the innvatr database user and the SQL Server lgin defined in this sectin f the Cnfigure Database screen with privileges as a database wner f the database created. The innvatr database user must be the database wner in MS SQL Server and des NOT use the SA lgin t lg int the database. (See als Database Owner Cnfiguratin) Lgin ID - This is the lgin that will be used by the innvatr database user. The installer will map this lgin t the innvatr database user after the innvatr database user is created. The installer will be creating the innvatr database user with rights as a database wner. This user will be used t create all Aras Innvatr bjects in the database. D nt use the SA lgin. Passwrd - Yu need t specify the passwrd fr the database user lgin that will be cnfigured. Database Optins The name and type f database t be installed. Database Template - Select either Innvatr Slutins r Innvatr Cre as the template t be used fr the creatin f the new database. The Innvatr Cre database cntains nly the cre data structures f Aras Innvatr. The Innvatr Slutins database includes the cre cmpnents plus additinal data elements fr the Prgram Management, Prduct Engineering and Quality Planning slutins. Database Name - Specify the name yu wish yur new Aras Innvatr SQL Server database t be called r accept the default name prvided. When all fields are cmplete, select Cnfigure Database t install the database. Page 28
4.3.11.2 Ppulate an existing database This ptin is used t ppulate an existing empty database with the required data and t add this data base t the Aras Innvatr cnfiguratin file t be used with this installatin f Aras Innvatr. Yu must knw the user lgin mapped t the innvatr database user t use this ptin. This ptin is used when nly the lgin assciated with the innvatr user is knwn. Database Lgin Optins This is the lgin assciated with the innvatr database user, and must be the database wner in MS SQL Server but des NOT use the SA lgin t lg int the database. (See als Database Owner Cnfiguratin) Lgin ID - This is the lgin that is used by the innvatr database user. This user will be used t create all Aras Innvatr bjects in the database. D nt use the SA lgin. Passwrd - Yu need t specify the passwrd fr the database user lgin. Page 29
Yu will need t select Cnnect nce the lgin ptins have been filled ut. This will allw the installer t cnfirm cnnectin t the SQL Server instance befre prceeding. Database Optins The name and type f database t be installed. Database Template - Select either Innvatr Slutins r Innvatr Cre as the template t be used fr the creatin f the new database. The Innvatr Cre database cntains nly the cre data structures f Aras Innvatr. The Innvatr Slutins database includes the cre cmpnents plus additinal data elements fr the Prgram Management, Prduct Engineering and Quality Planning slutins. Database Name - Specify the name f the database yu are installing t. This value may be keyed in r select Brwse t see what SQL Server registratins the installer recgnizes as available. When all fields are cmplete, select Cnfigure Database t install the database. Page 30
4.3.11.3 Use an existing database This ptin is means t add an existing Aras Innvatr database t the cnfiguratin file used with the newly installed Aras Innvatr. The database must be cmpliant with the versin f Aras Innvatr being installed; meaning that the data it is ppulated with must be cmpliant with the current versin f Aras Innvatr. Als, yu must knw the user lgin mapped t the innvatr database user. Database Lgin Optins This is the lgin assciated with the innvatr database user, and must be the database wner in MS SQL Server but des NOT use the SA lgin t lg int the database. (See als Database Owner Cnfiguratin) Lgin ID - This is the lgin that is used by the innvatr database user. This user will be used t create all Aras Innvatr bjects in the database. D nt use the SA lgin. Passwrd - Yu need t specify the passwrd fr the database user lgin. Page 31
Database Optins The name and type f database t be installed. Database Name - Specify the name f the database yu are installing t. This value may be keyed in r select Brwse t see what SQL Server registratins the installer recgnizes as available. When all fields are cmplete, select Cnfigure Database t install the database. 4.3.11.4 Cnfigure nly (n validatins) This ptin is means t add an existing Aras Innvatr database t the cnfiguratin file used with the newly installed Aras Innvatr. The database must be cmpliant with the versin f Aras Innvatr being installed; meaning that the data it is ppulated with must be cmpliant with the current versin f Aras Innvatr. Als, yu must knw the user lgin mapped t the innvatr database user. The difference between this ptin and Use an existing database is that the lgin will nt validate the lgin credentials against the database. This ptin is mainly prvided fr develpment purpses. Page 32
Database Lgin Optins This is the lgin assciated with the innvatr database user, and must be the database wner in MS SQL Server but des NOT use the SA lgin t lg int the database. (See als Database Owner Cnfiguratin) Lgin ID - This is the lgin that is used by the innvatr database user. This user will be used t create all Aras Innvatr bjects in the database. D nt use the SA lgin. Passwrd - Yu need t specify the passwrd fr the database user lgin. Database Optins The name and type f database t be installed. Database Name - Specify the name f the database yu are installing t. This value may be keyed in r select Brwse t see what SQL Server registratins the installer recgnizes as available. When all fields are cmplete, select Cnfigure Database t install the database. Page 33
4.3.11.5 Install Anther Database r Prceed Once yu have installed a database, yu may change the ptins and install again, r yu can select Next t prceed with the installatin. Yu must cnfigure at least ne database befre prceeding. Click Next t prceed with installatin. Click Back t return t the previus screen. Click Cancel t exit setup. Page 34
4.3.12 Begin the Installatin This screen will display next, whether yu chse Custm r Cmplete Install. Click Install t start the installatin f the features (NOTE: Yu will n lnger be able t make any changes nce yu click the Install buttn n this screen) Click Back t return t the previus screen. Click Cancel t exit setup. 4.3.13 Installatin Status This screen shws the installatin status. Click Cancel t exit setup. Page 35
4.3.14 Installatin Cmpleted The screen belw is the last in the installatin wizard. The buttns displayed will pen up a web brwser t Aras web pages. http://www.aras.cm/supprt Lcatin fr dwnlads, dcumentatin, and ther Aras Innvatr supprt infrmatin. http://www.aras.cm/cmmunity Lcatin f frums and blgs relating t usage, best practices, and verall enhancement f the Aras Innvatr experience. Please, be sure nt t delete yur installer frm yur hard drive when yu are dne with an installatin. Yu must reuse the same installer t install ther instances f Aras Innvatr r its cmpnents. Page 36
5 Lgging int Aras Innvatr Aras Innvatr uses a Web Brwser as the cntainer fr its administratin and end-user interface. Please review the Aras Innvatr - Internet Explrer Client Machine Cnfiguratin dcument fr the recmmended Internet Explrer Settings. The System Administratr shuld als review the Aras Innvatr -.NET Client Cnfiguratin dcument t decide n the prper deplyment f the.net security plicies, as well. Client PC machines will nt be able t lg in until these security plicies are set. A user with administratr rights typically perfrms custmizatin f Aras Innvatr. Initial setup f Aras Innvatr will determine the admin user name lgn. By default, the user admin will have a lgn passwrd f innvatr. T lg in as administratr, 1. Start Internet Explrer 2. Pint yur web brwser at http://<servername>/<web_alias> Nte: The cmplete lgin URL is determined by the Web Server virtual directry name setup. (e.g. http://<servername>/innvatrserver) 3. Enter the default lgin infrmatin. a. Enter the default administratr s designated username and passwrd (username admin, passwrd innvatr ). b. Select the crrect database frm the drp dwn menu. This is the database yu named in the InnvatrServerCnfig.xml 4. Click Lgin buttn Nte: Anyne will be able t lg in with administrative accesses with this default user. While this is acceptable in a develpment envirnment, it is recmmended that yu setup a new accunt fr prductin databases with administrative privileges, and disable this lgin. Page 37
6 Cnfigure Aras Innvatr (Optinal) Aras Innvatr uses a cnfiguratin file t manage licensing and server infrmatin that is required t successfully start, lcate and cnnect t active cmpnents in its peratin. 1) Open the InnvatrServerCnfig.xml file lcated in the rt f the install directry in a text editr. C:\Prgram Files\Aras\Innvatr 2) Edit the Client Caching behavir 3) Edit the DB Cnnectin Sectin. See belw fr details. 4) Edit the UI Tailring Sectin. See belw fr details. 6.1 Client Caching Cnfiguratin Aras Innvatr can cnfigure the behavir fr caching temprary internet files in the Internet Explrer wrker prcess running the Aras Innvatr client. Specifically, the Innvatr Server settings verride the behavir f Internet Explrer when checking t see if a page yu have previusly viewed has a newer versin. This ability is used t increase perfrmance ver wide area netwrks where latency is an issue, but can have an impact fr all end users. The settings fr yur installatin can be cntrlled by the IEClient tag in the InnvatrServerCnfig.xml: <Innvatr> <UI-Tailring lgin_lg="... <IEClient RequiredSyncMde5="Never" CustmBuildVersin="" /> <perating_parameter key="debug_lg_flag" value="false" /> There are tw parameters that can be used t cntrl client sessin behavir: RequiredSyncMde5 This parameter has 5 settings EveryVisit Internet Explrer will check every time t see if a page yu have viewed previusly has a newer versin. OnIEStart - Internet Explrer will nt check t see if a page yu have previusly viewed has a newer versin. Internet Explrer will nly check t see if a page yu have previusly viewed has a newer versin if that page was viewed in a different sessin r the previus day. Autmatically Internet Explrer will decide when t check t see if a page yu have previusly viewed has a newer versin. Never Internet Explrer will nt check t see if a page yu have previusly viewed has a newer versin. Recmmended prductin setting. LeaveAsIs Aras Innvatr will nt change the setting used t access Aras Innvatr. The recmmended prductin setting is Never. If the IEClient tag is nt present, the default behavir f LeaveAsIs will be used. In develpment envirnments, EveryVisit r LeaveAsIs may be preferred t facilitate deplyment f changes during develpment. Page 38
CustmBuildVersin This is an integer value. Default is null. Every time a change is made t the static cntent n the server (html, images, etc.) yu will need t increase this value by 1. This will frce the clients t relad the Aras Innvatr client t pick up the changes the next time they lg in. As with any change t prductin, Aras strngly suggests yu ntify users t lg ut f their current sessin while deplying the change. Any changes made t the Aras Innvatr installatin directry require the fllwing steps t ensure deplyment t all users: 1) Deply the change t the installed cde tree n the server. 2) Edit the InnvatrServerCnfig.xml file fund in the rt f the cde tree. 3) Increment the CustmBuildVersin attribute by 1: <Innvatr> <UI-Tailring lgin_lg="... <IEClient RequiredSyncMde5="Never" CustmBuildVersin="2" /> <perating_parameter key="debug_lg_flag" value="false" />... 4) Restart the w3svc service(iis). 6.2 DB Cnnectin This sectin prvides the fundamental data enabling the Aras Innvatr server t cnnect t the Aras Innvatr database. Use this sectin t manually create custm cnnectins t existing databases. Variable id database server uid pwd dbtype Definitin Any alphanumeric name t be used t identify the database when using Innvatr. The name f the Aras Innvatr database in SQL Server The name f the server where the database is installed. The username t cnnect t the abve database The passwrd fr the username listed abve database SQL Server Belw is an example f a prperly frmatted DB Cnnectin sectin f the InnvatrServerCnfig.xml. Micrsft SQL Server database <DB-Cnnectin id="innvatr" database="innvatrslutins" server="lcalhst" uid="innvatr" pwd="innvatr" dbtype="sql Server" /> Edit the InnvatrServerCnfig.xml file lcated in rt f the install directry. C:\Prgram Files\Aras\Innvatr. 1) Id = Innvatr Name yu wish t appear in the drp dwn list when accessing Innvatr. If the id attribute is nt present in the entry, then database name will be Page 39
used t identify the database when using Innvatr. Please select this name carefully, as it will als be the name f the flder yu vault files will be stred in. 2) database = Innvatr name f the database yu are cnnecting t 3) server = Servername the name f the SQL Server instance where the database installed 4) uid = innvatr The username t cnnect t the abve database. 5) pwd = innvatr The passwrd t cnnect t the abve database 6) dbtype = SQL Server Des nt change 6.3 UI Tailring Sectin If desired, edit the UI Tailring sectin f the InnvatrServerCnfig.xml. This sectin f the InnvatrServerCnfig.xml file allws the custmer t mdify the lgin screen, the main screen title bar, and the banner page (if any). Variable lgin_lg branding_img prduct_name banner_url banner_height pener_fcus_n_lgut windw_histry_back_befre_lgin Definitin The URL (relative t the Innvatr hme directry) t the image t be used n the Innvatr lgin screen The URL (relative t the Innvatr hme directry) t the image t be used n the Innvatr lgin screen The title t be used n the main Innvatr windw title bar The URL (relative t the Innvatr hme directry) t the HTML page t be used as the Innvatr banner. The height f the banner sectin f the main Innvatr windw, if n banner is desired, set this value t 0. If false then Aras Innvatr des nt try t give the pener windw fcus when the user lgs ut f Aras Innvatr. This defaults t true. If false then the /Client/scripts/default.aspx des nt try t d a histry.back() after it creates the lgn pp-up windw in which the /Client/scripts/innvatr.aspx will run. By default, this is true. If false then the /Client/scripts/default.aspx des nt try t d a histry.back() after it creates the lgn pp-up windw in which the /Client/scripts/innvatr.aspx will run. Belw is an example f a prperly frmatted UI Tailring sectin f the InnvatrServerCnfig.xml file. <UI-Tailring lgin_lg="../images/lgs/innvatr_splash.jpg" branding_img="../images/lgs/banner_02.jpg" prduct_name="aras Innvatr" banner_url="../scripts/banner.aspx" banner_height="50" /> Page 40
6.4 Disabling the Cmpiling f Temprary DLLs Aras Innvatr Methds are cmpiled befre executin. The default behavir f Aras Innvatr is t generate these methds temprary files t aid in trubleshting. These files will be stred in the file system in the \Innvatr\Server\dll flder f the installatin by default. Because the files are generated at runtime, the DLL files generated in this flder will nt list the Aras Crpratin cmpany name r the Aras Innvatr prduct name in file prperties. Further, the DLL files generated in this flder at runtime will nt have a digital signature. T disable the generatin f these files in the file system yu will need t add the fllwing tag t the InnvatrServerCnfig.xml, fund in the rt f yur installatin flder. <Innvatr> <UI-Tailring lgin_lg="... <IEClient RequiredSyncMde5="Never" CustmBuildVersin="" /> <perating_parameter key="debugservermethd" value="false" /> <perating_parameter key="debug_lg_flag" value="false" /> T enable the use f this flder again, yu will simply need t change the value t true. <Innvatr> <UI-Tailring lgin_lg="... <IEClient RequiredSyncMde5="Never" CustmBuildVersin="" /> <perating_parameter key="debugservermethd" value="true" /> <perating_parameter key="debug_lg_flag" value="false" /> Disabling the use f this flder will have n negative effect n a prductin system. 6.5 Installing the Reprting Service Aras Innvatr uses integratin with Micrsft SQL Server Reprting Service. This service must be installed and cnfigured in rder t run Aras Innvatr reprts. Please refer t the Aras Innvatr - Micrsft Reprting Services Guide fr details n installing and cnfiguring the service. This dcument can be fund at http://www.aras.cm/supprt/ r in the Dcumentatin flder f the Aras Innvatr CD Image. 6.6 Cnfiguring Aras Innvatr fr Single Sign-On The Aras Innvatr Single Sign-On feature prvides a mechanism fr custmers t take advantage f their existing user authenticatin scheme s that an Innvatr lgin can be prcessed withut the user entering an Innvatr specific passwrd. This new feature has been architected s that it can be easily cnfigured t adapt t an Active Directry envirnment r, if the custmer has anther user authenticatin scheme, hks have been included t integrate a nn-standard methd. Please refer t the Aras Innvatr Windws Authenticatin dcument. This dcument can be fund in the Dcumentatin flder f the CD Image and utlines cnfiguring yur Aras Innvatr installatin fr user authenticatin. Page 41
6.7 Cnfiguring the Aras Innvatr Service The Aras Innvatr Service is a Windws executable prgram that runs as a Windws Service. It is used t autmatically run Aras Innvatr Methds n a peridic schedule, as specified in the InnvatrServiceCnfig.xml file. A single running instance f the Aras Innvatr Service can be cnfigured t peridically cnnect t any number f Aras Innvatr Servers and fr each Aras Innvatr Server run any number f Methds. The standard Windws Event Viewer is used fr lgging f prgram status and errr messages. Please refer t the Aras Innvatr - Service Instructins dcument fr infrmatin n cnfiguring yur Aras Innvatr installatin t use this service. This dcument can be fund in the Dcumentatin flder f the CD Image. 6.8 Cnfiguring Custm Installatins When using the custm install ptin certain files must be cnfigured t allw Aras Innvatr cmpnents t wrk tgether. 1) The Aras Innvatr Server must knw where the database is installed. Fr the system where Aras Innvatr Server is installed, fllw the steps utlined in DB Cnnectin Sectin. 2) The Database must pint t the designated vault lcatin. T set up the vault: a) Lg in as administratr. b) Expand the Administratin Flder and Select Vaults c) Select the buttn frm the tp left f the vault brwser windw and select the Default vault that cmes up d) Right-click n Default vault, and select Edit frm the cntext menu. The dialg belw is displayed: e) Name Default (we are cnfiguring the Default vault server) f) Vault Url This is the IIS path t the VaultServer.aspx. By default, this path shuld be: $[HTTP_PREFIX_SERVER]$[HTTP_HOST_SERVER]$[HTTP_PORT_SERVER]$[HTT P_PATH_SERVER]/vault/vaultserver.aspx Page 42
(1) If the Vault Sever is installed n a separate machine than the Innvatr Server, then the web alias may need t be hard cded: http://<servername>/<web_alias>/vault/vaultserver.aspx g) Click the (save, unlck, and clse buttn) 3) The Vault Server shuld have access t the Aras Innvatr Server and Database Server The vault server must knw the lcatin f the InnvatrServer.aspx. Here is hw t cnfigure it: a) Open the file VaultServerCnfig.xml. This file shuld be lcated in the rt f the installed directry fr the Vault server, fr example: C:\Prgram Files\Aras\Innvatr\VaultServerCnfig.xml b) Change the AppServerURL t pint t the InnvatrServer.aspx. S, <AppServerURL>$[HTTP_PREFIX_SERVER]$[HTTP_HOST_SERVER]$[HTTP_POR T_SERVER]$[HTTP_PATH_SERVER]/Server/innvatrserver.aspx</AppServerUR L> becmes: <AppServerURL>http://<servername>/<web_alias>/Server/innvatrserver.as px</appserverurl> 6.9 Cnfiguring Alternate Vaults Installatins When using the custm install ptin certain files must be cnfigured t allw Aras Innvatr cmpnents t wrk tgether. 1) Run a custm installatin t set up the new vault, which in this example we will call New. 2) The Database must pint t the designated vault lcatin. T set up the vault: a) Lg in as administratr. b) Expand the Administratin Flder and Select Vaults c) Select the Create a New Item buttn frm the tp left f the vault brwser windw. The dialg belw will be displayed. Page 43
d) Name New (The name f the vault server we are cnfiguring) e) Vault Url This is the IIS path t the VaultServer.aspx. Because this is nt the default vault the URL shuld be hard cded: http://<servername>/<web_alias>/vault/vaultserver.aspx a. When a vault is installed by itself, the default web alias will be http://<servername>/vault/vaultserver.aspx f) Click the (save, unlck, and clse buttn) 3) The Vault Server shuld have access t the Aras Innvatr Server and Database Server, meaning that the vault server must knw the lcatin f the InnvatrServer.aspx. Here is hw t cnfigure it: a) Open the file VaultServerCnfig.aspx. This file shuld be lcated in the rt f the installed directry fr the Vault server, fr example: C:\Prgram Files\Aras\Innvatr\VaultServerCnfig.xml b) Change the AppServerURL t pint t the InnvatrServer.aspx. S, <AppServerURL>$[HTTP_PREFIX_SERVER]$[HTTP_HOST_SERVER]$[HTTP_POR T_SERVER]$[HTTP_PATH_SERVER]/Server/innvatrserver.aspx</AppServerUR L> becmes: <AppServerURL>http://<servername>/<web_alias>/Server/innvatrserver.as px</appserverurl> c) Change the vault name in the file, t the name f the server we are using, in this case New. <name>default</name> becmes: <name>new</name> 6.10 Cnfiguring Vault File Uplad Size Limits The size f a file that can be upladed t Aras Innvatr is determined by yur IIS settings. T vault files larger than 500 Megs yu will need t change a cnfig file in the Vaultserver. It is recmmended that.net 2.0(r higher) be used n the server if large files will be vaulted with these settings. 1) Edit the fie \VautServer\web.cnfig 2) Change the line <httpruntime maxrequestlength="500000" T <httpruntime maxrequestlength=" 2097151" Page 44
This value cntrls the maximum file uplad size t the vault. The change utlined here will allw yu t vault files up t 2 Gigs in size. 3) Restart IIS n the server 6.11 Cnfiguring Vault Security The vault security feature that restricts the accessing f files directly in the vault server withut authenticatin and prper permissin can be disabled thrugh additin f the fllwing flag in the VaultServerCnfig.xml: <?xml versin="1.0" encding="utf-8"?> <VaultServer> <AppServerURL>http://lcalhst/$[HTTP_PATH_SERVER]/Server/ InnvatrServer.aspx</AppServerURL> <LcalPath>C:\Aras\Vault</LcalPath> <lgin_name>vadmin</lgin_name> <passwrd>vadmin</passwrd> <name>default</name> <versin>9.1</versin> <enfrce_user_credentials>0</enfrce_user_credentials> </VaultServer> Setting enfrce_user_credentials t 0 disables this feature. Setting enfrce_user_credentials t 1 leaves this feature enabled. The default behavir is t have this security enabled and is recmmended fr prductin use. 6.12 Cnfiguring Separate Client and Server Web Flders Aras Innvatr allws fr the ability t install tw instances f the Innvatr Server. One server will run Client and Server web aliases, while the secnd server runs the Client nly. This cnfiguratin allws distributed lading f web pages between different servers, while serving database requests thrugh ne server. There are a few things that shuld be kept in mind when running in this cnfiguratin. Changes t The cde tree must be kept in sync. Any changes t the cde tree shuld be deplyed t all cde trees, r else users may be missing files when attempting t perfrm an actin against an ut f date server. Variable paths fr cnnecting t the VaultServer are nt recmmended. T set up a distributed client server fllw the fllwing steps. 1) Cmplete the install f the full Innvatr instance n the first server, including the Innvatr Sever, Innvatr database, and vault. We ll refer t this as ServerA 2) Cmplete a full install f the full Innvatr Server tier n the secnd server. We ll refer t this as SeverB. 3) Edit the InnvatrSeverCnfig.xml n ServerB. Yu will need t add tw lines t this file t define the cnnectin t the web alias n ServerA and database. It shuld lk smething like this t start: Page 45
<Innvatr> <UI-Tailring lgin_lg="../images/lgs/innvatr_splash.jpg" branding_img="../images/lgs/banner_02.jpg" prduct_name="aras Innvatr" banner_url="../scripts/banner.aspx" banner_height="50" /> <perating_parameter key="debug_lg_flag" value="false" /> <perating_parameter key="debug_lg_limit" value="10000" /> <perating_parameter key="debug_lg_pretty" value="true" /> <disabled_perating_parameter key="perfrmance_lgging" value="cpu" /> <perating_parameter key="xslt_prcessr_debug" value="true" /> <disabled_perating_parameter key="email_debug_ptin" value="file" /> <License lic_type="unlimited" lic_key="fc49306d47602f8ed1be1d6bf0835ea1" /> <Mail SMTPServer="queue" /> <perating_parameter key="temp_flder" value="c:\prgram Files\Aras\Innvatr\Innvatr\Server\temp" /> <perating_parameter key="servermethdtempdir" value="c:\prgram Files\Aras\Innvatr\Innvatr\Server\dll" /> <perating_parameter key="debug_lg_prefix" value="c:\prgram Files\Aras\Innvatr\Innvatr\Server\Lgs\" /> </Innvatr> a. Yu will need t add the server cnnectin <Server name="servera" BaseURL="http://<servername>/<web_alias>/Server/" EXT=".aspx" /> ServerA The name f the Aras Innvatr instance n ServerA t is t be identified by. It is best t make this a shrt alphanumeric string. b. Next yu will need t define what database t cnnect t. In ServerA s InnvatrServerCnfig.xml file yu will find the database cnnectin parmeters. <DB-Cnnectin id="innvatrslutins" database="innvatrslutins" server="lcalhst" uid="innvatr" pwd="innvatr" dbtype="sql Server" /> In ServerB s InnvatrServerCnfig.xml file yu will need t add the fllwing line. <DB-Cnnectin id="innvatrslutins" /> The id attribute must match in bth files t be able t cnnect. 4) Restart IIS n bth servers. Page 46
6.13 Restart the IIS server After Cnfiguratin Changes It is recmmended that yu restart IIS (Wrld Wide Web Publishing service) after any change t the InnvatrServerCnfig.xml file in rder t ensure the changes t are enfrced n client PC machines. T Restart IIS: 1) Frm the Start menu select Start Settings Cntrl Panel Administrative Tls Services 2) Select the Wrld Wide Web Publishing service 3) Select Actin Restart frm the main menu. Page 47
7 SVG Viewing Requirements 7.1 Client PC Machines and SVG Aras Innvatr integrates Scalar Vectr Graphics files int the many reprting ptins made available t the Aras Innvatr administratr. Hwever, in rder fr the endusers t view these SVGs the client PC machine must have an SVG viewer installed. Aras Crpratin recmmends dwnlading Adbe SVG Viewer 3.03 frm the Adbe website. 7.2 Web Servers and SVG Aras Innvatr integrates Scalar Vectr Graphics files int the many reprting ptins made available t the Aras Innvatr administratr. Hwever, in rder fr the endusers t view these SVGs the Web Server must have the SVG extensin as a defined mime type in IIS. If the SVG Mime type is nt enabled, please use the fllwing steps: 1) Lg nt the server that yu have the Innvatr Server installed n. 2) Frm the Start menu select Settings Cntrl Panel 3) Open Administrative Tls 4) Open Internet Infrmatin Services (IIS) Manager 5) Expand (lcal grup) 6) Select Web Sites 7) Right-Click n Default Web Site and select Prperties 8) Select the HTTP Headers tab 9) In the Mime Types sectin at the bttm f the tab, select the Mime Types buttn 10) In the Mime Types dialg, select New a) Extensin = SVG b) Mime Type = image/svg+xml 11) Select OK t clse the dialg 12) Select OK t clse the Mime Type dialg. 13) Select OK t clse the Prperties windw. Page 48
8 Trubleshting 8.1 Lgin URL returns The client is nw Client/. If yu receive a message like the ne shwn, The client is nw Client/. This indicates that all f the.net hks are nt prperly installed t IIS. T fix this issue, please select the.net framewrk frm the Add/Remve Prgrams windw, and select repair. After this is cmplete, yu will need t ensure that the ASP.NET versin is set crrectly in the Prperties f the default web site. 8.2 Client side errr lgging in t Aras Innvatr Page 49
If yu receive a client-side errr when attempting t lg int Aras Innvatr, it may be due t insufficient access privileges in IIS. 1) Open up IIS 2) Right click n the Innvatr virtual directry, and click n prperties. 3) Click n the directry security tab 4) Click the Edit buttn 5) Specify a user that has administrative privileges n the machine that is running IIS. Click the ptin fr Annymus access, Allw IIS t cntrl passwrd and Integrated Windws authenticatin 6) Click OK & OK 7) Restart the IIS Web service. Page 50
8.3 HTTP Errr 404 - File r directry nt fund. n lgin If when attempting t lgin int Aras Innvatr yu get a standard file nt fund errr, the mst cmmn cause is that ASP pages are nt allwed t run n yur server. T test this try the fllwing URL: http://<servername>/<web_alias>/client/mini-diag.html If this page displays, it indicates that yur sftware is installed, but that ASP pages are nt allwed t run. T fix this, please fllw the fllwing steps: 1) Lg nt the server that yu have the Innvatr Server installed n. 2) Frm the Start menu select Settings Cntrl Panel 3) Open Administrative Tls 4) Open Internet Infrmatin Services (IIS) Manager 5) Expand (lcal grup) 6) Select Web Service Extensins 7) In the panel n the right, there shuld be an entry like ASP.NET v2.0.50727. Highlight it. 8) Select the Allw buttn. 8.4 HTTP 500 Internal Server Errr n lgin If when attempting t lgin int Aras Innvatr yu get a standard IIS page nt fund cntent: i.e. the windw size is crrect, but instead f the fields fr username and passwrd, there is an errr page HTTP 500 Internal Server Errr. Additinally the fllwing warning message may be lgged in the system event lg: The server failed t lad applicatin /LM/W3SVC/1/Innvatr. The errr was General access denied errr This prblem may be caused by installing Micrsft Visual Studi v6 with SP6. The install has a bug and changes the security f the file WINNT/System32/mfc42.dll which is used t run ASP pages. The slutin wuld be t grant the IWAM_CmputerName user accunt the Read & Execute permissin fr the mfc42.dll file. 8.5 Checking the MDAC (Munting Errrs) There have been prblems seen with MDAC versin 2.7 it has been verified that with 2.6 and 2.8 the prblems are reslved. Check If yu are having Database Munting issues. 1) T check what versin f MDAC yu are using: 2) Select Start Run 3) Type regedit 4) Brwse t: HKEY_LOCAL_MACHINE\Sftware\Micrsft\DataAccess\ 5) Lk at Versin and r FullInstallver lks like the fllwing Versin REG_SZ 2.60.6526.2 FullInstallVer REG_SZ 2.60.6526.2 Page 51
8.6 Image Brwser empty parent paths disabled If yu find that every time yu attempt t bring up the Image Brwser (t select sme image) nne f the images are available. First f all yu shuld check whether the flder Innvatr\client\images des in fact exist and cntains the images. If the flder is crrectly in place but the prblem persists then yu shuld try t access the Image Brwser directly: http://lcalhst/innvatrserver/client/scripts/imagebrwser/imagebrwser.html where lcalhst/innvatrserver shuld be replaced with the innvatr server path (i.e. servername/web_alias). It shuld return the crrect Image Brwser and check if the files are crrectly in place: Page 52
If this is nt the respnse that yu gt then sme cnfiguratin prblem exists. If the respnse yu gt lks like this: Page 53
Then yu shuld check whether the virtual directry fr the Aras Innvatr Server has parent paths enabled. T d that: 1. G t Start Prgrams Administrative Tls Internet Infrmatin Services 2. Navigate t the virtual directry fr yur Aras Innvatr Server: a. Expand the flder with the Machine Name b. Expand the flder Web Sites c. Expand the flder Default Web Site d. Click n the Virtual Directry crrespnding t yur Aras Innvatr Server (the string yu enter after http://<server_name/ ) 3. Right click n the Virtual Directry and select Prperties frm the menu 4. In the presented prperties windw click n the Cnfiguratin buttn, this will bring up the Applicatin Cnfiguratin windw 5. In the Applicatin Cnfiguratin windw select the Optins tab 6. Cnfirm that the Enable parent paths is checked If it is nt, then check it and click OK. Nw the Image Brwser shuld wrk, if this des nt help then send an email t supprt@aras.cm. Page 54
8.7 Main Grid nt painting clumns r headers After yu lgin int Aras Innvatr Server the main grid wuld never paint clumns r headers, hwever pages such as InBasket r relatinshiptabs culd wrk. Attempt t pen the Internet Explrer and yu might see the fllwing message: XML Exceptin: Incrrect cmments tag This is a client side prblem and the rt cause f it is that the wrng versin f the XML parser is used (this culd fr example be caused by installing Visual Studi v6 with SP6, that changes the XML parser used by Innvatr). The slutin fr this is t un-install and then t re-install the XML parser. 8.8 Installing Aras Innvatr t a dedicated Micrsft Sharepint Server When installing Aras Innvatr t a machine that was previusly set up as a Micrsft Sharepint Server, certain IIS setting managed by Micrsft Sharepint can prevent Aras Innvatr frm lading. If yu are experiencing prblems with yur Aras Innvatr Installatin n a dedicated Micrsft Sharepint Server, yu may try the fllwing steps t slve the prblem. 1) In IIS management cnsle set Execute Permissins t "Scripts nly" fr InnvatrServer, InnvatrServer\Client and InnvatrServer\Server 1) Add partitinreslvertype="" attribute n sessinstate element in InnvatrServer\Server\web.cnfig 2) Add enablesessinstate="true" attribute n pages element in InnvatrServer\Server\web.cnfig 3) Add <trust level="full" /> inside system.web element in InnvatrServer\Server\web.cnfig 4) Add <trust level="full" /> inside system.web element in InnvatrServer\Client\web.cnfig Page 55
5) Enable annymus access fr InnvatrServer\Client t allw.net cntrls access resurces. (Keep enabled Windws authenticatin fr InnvatrServer\Server.) 8.9 Optinal Vault Cnfiguratin Parameters Sme IIS setups can have prblems with the chunk size when accessing files in the vault. If yu are experiencing issues accessing large files in the vault, yu may try the fllwing setting in yur VaultServerCnfig.xml. <?xml versin="1.0" encding="utf-8"?> <VaultServer> <AppServerURL>http://lcalhst/$[HTTP_PATH_SERVER]/Server/ InnvatrServer.aspx</AppServerURL> <LcalPath>C:\Aras\vault\</LcalPath> <lgin_name>vadmin</lgin_name> <name>default</name> <passwrd>vadmin</passwrd> <versin>9.1</versin> <WriteFileMaxLength>4194304</WriteFileMaxLength> </VaultServer> The WriteFileMaxLength tag will limit the size f the chunk size when transferring the file. Page 56
9 Database Owner Cnfiguratin Aras Innvatr prvides the ptin t create, ppulate existing, r cnfigure existing databases in MS SQL Server. In rder t allw cntinued upgrading f Innvatr certain guidelines shuld be fllwed regarding the MS SQL Server users and lgins used t access the Aras Innvatr database. The innvatr user must have access t the database. This user is created as part f a standard installatin when using the create ptin. This must be cnfigured manually when an installatin uses the ppulate r cnfigure ptins. The innvatr user must have database wner privileges. This privilege is created as part f a standard installatin when using the create ptin. This must be cnfigured manually when an installatin uses the ppulate r cnfigure ptins. The nn-system database bjects shuld be wned by the innvatr database user. Nn-system bjects are thse nt created by MS SQL in initial creatin f the database in MS SQL All installed bjects will be created with this wner. All bjects created by the Innvatr Server will be created with this wner. Lgins used by the innvatr database user shuld nt be the same as the MS SQL Server System Administratr lgin. The innvatr database user lgin shuld nt match the sa lgin The innvatr database user lgin shuld nt match any ther MS SQL Server Administratr lgin used in additin t the sa lgin. Page 57
10 Running Installer Multiple Times 10.1 Cmplete Install the First Time Innvatr is designed t be installed, either as a whle r in cmpnents, t the same server multiple times. This means that every time the installer is run, it will be treated as a new installatin. Please be sure nt t delete yur installer frm yur hard drive when yu are dne with an installatin. Yu must reuse the same installer t run the installatin the next time. 10.2 Mdify, Repair, r Remve If yu are seeing the screen abve the installatin is nt being treated as a new installatin. This usually indicates that yu are trying t install the same versin f Aras Innvatr that was previusly installed. Yu shuld use the cpy f the installer that was run t install the existing versin f Aras Innvatr. If this cpy f InnvatrSetup.msi is nt available, please use the fllwing steps t enable the installer t run as new. 1. Dwnlad the installer t yur hard drive. 2. Lcate the ChangeGUID.exe file a. This can be fund in the flder where the existing Aras Innvatr instance is installed. b. This can als be fund in the Utilities flder f the Aras Innvatr CD Image. 3. Open a cmmand prmpt Page 58
4. Change directry t where the ChangeGUID.exe file is lcated a. I will use C:\ as my example. 5. Execute the file while specifying the full path t the installer a. ChangeGUID <path>\innvatrsetup.msi b. Where <path> is the directry path t where the InnvatrSetup.msi is lcated. Page 59
11 Aras Innvatr Server Uninstall 11.1 Lcating the Uninstaller Windws Server 2003 In rder t uninstall Aras Innvatr 1. Frm the Start Menu, g t the Cntrl Panel, under Settings. 2. Select Add r Remve Prgrams 3. Frm the list, select Aras Innvatr a. If mre than ne listing fr Aras Innvatr is shwn, yu can identify the installatin by selecting Click here fr supprt infrmatin. b. The dialg will display the versin number and directry that Aras Innvatr was installed int. Page 60
4. Click n the remve buttn t start the uninstall. 11.2 Lcating the Uninstaller Windws Server 2008 In rder t uninstall Aras Innvatr 1. Frm the Start Menu, g t the Cntrl Panel. 2. Select Prgrams and Features 3. Frm the list, select Aras Innvatr a. If mre there is mre than ne installatin make sure yu are in the details view. Right click the details grid and select mre and make sure Cmments and Versin are checked ff. b. Under the Cmments and Versin sectin dialgue shuld tell yu the install path and the versin f Aras Innvatr respectively (bxed in red abve) 4. Click the Uninstall buttn(circled in red abve) t begin the uninstall. Page 61
11.3 Uninstalling When Uninstaller starts this screen will be presented. Click Yes t prceed Click N t exit the Uninstaller. Once yu click Yes n this screen the uninstall prcess will begin, and the status f the Uninstall will be displayed n the screen. Click Cancel t exit the Uninstaller. When Uninstall cmpletes, Aras Innvatr has been fully remved frm yur machine. Page 62