ARGUSDeveloper Install Guide
ARGUSDeveloper Install Guide
009
Installation Guide
Document Version 1.01
August 7th, 2014
Published by:
ARGUS Software, Inc.
3050 Post Oak Boulevard
Suite 900
Houston, Texas 77056
Telephone (713) 621-4343
Facsimile (713) 621-2787
www.argussoftware.com
Information in this Installation Guide is subject to change without notice and represents no commitment on the
part of ARGUS Software.
This Installation Guide are copyright © 2014, ARGUS Software. All rights reserved. This Installation Guide is a
confidential and proprietary trade secret of ARGUS Software and its licensors, made available only under a license
containing obligations of confidentiality. Information in this Installation Guide is subject to change without notice.
"ARGUS Software" is a trademark of ARGUS Software, Inc. All other trademarks and registered trademarks are
property of their respective companies.
ARGUS Developer allows the sophisticated modelling of your development project by utilising many options and
features in the application, enabling a wide variety of methodologies to be employed as used in the global real
estate market.
Purpose
This booklet is provided as an installation guide to enable you to get ARGUS Developer up and
running.
The installation, use and application of the software is subject to the Terms and Conditions set out
in the license agreement, and opening the package constitutes acceptance of these terms. The
license agreement can be found in the program installation folder after you have performed an
installation (PDF file). It is important to note that demonstration versions of the programs may not
be used for actual business or financial gain, and the user is deemed to agree that the intended use
of the software is for evaluation purposes only.
For further information about licensing, installation and use of the software, please contact ARGUS
Software. See “Getting Additional Assistance” on page 5.
• Context Sensitive Help. The context sensitive help system is available any time you are using the program by
pressing the F1 key.
• Calculations Manual.pdf - This is a guide to the main calculation methods employed in ARGUS Developer.
Online
Visit our support page at http://argussoftware.com/getsupport
By telephone
US/Canada: 1-888-MYARGUS (692-7487)
Hours of Operation
Americas:
7:30am to 6:30pm GMT -6 Monday to Thursday
7:30am to 6:00pm GMT -6 Friday
excluding USA public holidays
Europe:
9:00am to 5:30pm GMT Monday to Friday
excluding UK public holidays
Asia/Pacific:
7:00am to 7:00pm GMT +8 Monday to Friday
excluding Singapore public holidays
Australia:
9:00am to 5:00pm GMT+10 Monday to Friday
Excluding Australian public holidays
Windows XP
Windows Vista
Windows 7
Windows 8
System Requirements
The following represents minimal supported system requirements for use of ARGUS Developer v6.50.002.009.
Client PC Requirements
Whilst ARGUS endeavours to correct known issues, software is provided "as is" without warranty of any kind,
express or implied. In no event shall ARGUS be held liable for any direct, indirect, incidental, special or
consequential damages arising out of the use of or inability to use this software.
ARGUS recommends that clients check new versions in a test environment before releasing to their users.
ARGUS will provide test licenses to all clients under support who wish to upgrade to the new version.
Installation wizard
4. Click the Next > button to proceed. Please wait until you see the following message:
5. Select the appropriate country of operation from the options presented here.
Click the Next > button to proceed. Please wait until you seeError! Unknown
the following document property name.
message:
Please read the software licence agreement carefully before you proceed. The example shown
above is for a North American installation - you may see something different if you are installing a
version for a different country.
If you accept the terms of the licence, click the Yes button to proceed.
You are prompted to choose the type of installation that you require:
• Client installation – select this option if you are installing a copy that will be used as a client in a multi-user
environment where a full installation of the program is on a network server (see also “Installing ARGUS
Developer on a Network” on page 17).
Note that before you start installing any client machines, you must have already done a full installation on a
network server - this is so that all clients can be mapped to the server installation.
• Full installation – select this option if you are installing the system for a stand-alone installation, or for an
installation that is used on a network server in a multi-user environment.
• Upgrade existing installation – select this option if you wish to upgrade from any earlier version of Developer.
Select the appropriate option from the list and click the Next > button to proceed.
Please use “Full Installation” on page 9, “Upgrade Installation” on page 11 and “Client Installation” on page 15
for further installation details.
Full installation
If you choose to perform full installation, the procedure is as follows:
The installation wizard prompts you to enter details of an installation folder for ARGUS Developer:
Browse to a location where you wish to install ARGUS Developer - you can change the pathname using the Browse
button.
If you are installing onto a network server (in order to install ARGUS Developer for use in a multi-user
environment) use the Browse button to change this path to the network drive letter and folder in which you want
to install ARGUS Developer (for example K:\ARGUS Developer).
Click the Next > button to proceed. Error! Unknown document property name.
The example shown above is for the North American region - if you are installing to a different region, you will see
a different region of operation listed here.
When the installation has finished, you should see the following message:
You should now proceed to activate ARGUS Developer. Please see “Activating your License” on page 27 for
instructions on how to activate your license.
Upgrade Installation
Note: Before you begin an upgrade installation, ensure you have a full backup of the Data, Report and Template
folders. All users must be logged out of the program before you proceed.
The upgrade process will automatically attempt to check in your license key. When the upgrade has been
completed, you must check out the license to continue working with Developer.
Version 6 is fully compliant with Windows file and folder locations to allow for improved security and ease of use.
You will find that files are stored in familiar places, just like other programs.
After the software has been upgraded, a separate post-installation process is started automatically. The purpose of
this is to ensure that all files and folders are either copied or moved to the correct Windows locations.
If you choose to perform an upgrade installation, the procedure is as follows:
Browse to the location of the ARGUS Developer installation that you wish to upgrade - you can change the
pathname using the Browse button.
At this point, the installer will automatically attempt to check in your license key. If this is successful, the
installation will continue.
If the check in is not successful, you will be notified that your existing license will not be compatible with the new
version of Developer. It is recommended that you cancel the upgrade and contact the Support Team to obtain a
replacement license. Should continue with the upgrade, Developer will not work and you will be required to obtain
a replacement license.
Following the license check in, the installation will commence, and the progress is displayed:
At this point in the upgrade, the post-installation process referred to earlier in this section is started. As the post-
installer works through its separate tasks, an information bar is shown on screen, containing a description of the
current process. Depending on the time taken to complete each task, the information bar may be displayed only
briefly, or not at all.
During the post-install process, you are asked if you would like to upgrade your Default Project Template or KPI
Dashboard (formerly the Results Bar). If you are installing to any region other than North America, you will see an
additional option for the upgrade of Stamp Duty / Land Transfer Tax templates.
Note: If you have customized the default project template with changes to calculation assumptions and/or have
links to a caveat file, these will be overwritten if you choose to upgrade the template.
If you do not select any of the options, the upgrade will proceed without updating the templates.
The post-installation process will now run through to completion. Any obsolete files and folders that were
automatically installed in earlier versions are moved to a folder called _Deleted. When the process has finished,
you can either view these files and folders, or delete and move them to the Recycle Bin. Note that it may not be
possible to move files and folders to the Recycle Bin if it has been disabled, or you are upgrading on a network.
When the installation has finished, you should see the following message:
Note: The upgrade process will automatically check in the license key. After the upgrade has been completed,
you must check out the license to be able to run the new version of Developer.
Client installation
Note: Before you begin, ensure that a full installation of ARGUS Developer has been set up on a network
fileserver. This is the server version of ARGUS Developer to which the client will connect. See “Installing ARGUS
Developer on a Network” on page 17 for further details of this procedure.
The installation wizard prompts you to enter details of the installation folder for the ARGUS Developer server:
Use the Browse... button to browse to the filename and path of the ARGUS Developer program installed on the
network fileserver. Please ensure that all client machines that you set up share the same mapped drive letter
and path to the server installation.
Error! Unknown
To confirm the installation, click the Next > button to proceed. The installation documentand
will commence, property name.is
the progress
displayed:
When the installation has finished, you should see the following message:
If you have not yet activated your installation, you will need to do so now. You should activate the license from the
client machine (see “Activating your License” on page 24). To do this, you only need to activate the license once -
any other client installs you set up will then automatically be able to access the fileserver installation.
• The procedure for installing ARGUS Developer is described in “Full Installation” on page 9.
• The procedure for installing an ARGUS Developer client is described in “Client installation”
on page 15.
• Fileserver installation - First, complete a full installation of ARGUS Developer onto the
fileserver (see “Full installation” on page 9 for further details). Note that the licence should be
activated from a client machine.
• Client installations - Then, set up each workstation for use as a client by running a client
installation (see “Client installation” on page 15 for further details).
Once you’ve installed a client, you can activate the licence from the client machine (see
“Activating your Licence” on page 24). To do this, you only need to activate the licence once
- any other client installs you set up on other machines will use the same licence as the
fileserver installation.
Users on networks can share the ARGUS Developer program and data files. Once ARGUS
Developer has been installed on the network, a workstation user can connect to the program using
the client installation.
• The network must be operational, and you must have read, write, create, modify and delete
privileges for the network directories in which you want to install ARGUS Developer.
• You should determine the logical drive letter and network fileserver folder to which ARGUS
Developer is installed (for example, W:\Program Files\ARGUS Software\ARGUS
Developer); if you wish to change this, browse to your preferred drive letter and folder on
the fileserver.
• Ensure that the program is installed on a drive which can be accessed by all client machines.
When performing the ARGUS Developer installation, if you are installing onto a network server
use the Browse feature to change the path to the network drive letter and folder in which you want
to install ARGUS Developer (for example W:\Program Files\ARGUS Software\ARGUS
Developer).
• Before commencing an upgrade, please ensure that the installation on the fileserver is not
running.
• If you have any custom Templates, take a backup of these before proceeding with the
upgrade. Templates can be found in the Regions\<Your Region>\Templates folder.
After you have done this, you can perform the upgrade installation as described in “Upgrade
installation” on page 11.
This means that for successful scalability, you will need a server that will have the memory and processor power to
handle the demands of the software.
Developer will run when used with Citrix or Terminal Services, but please bear in mind the following:
Disclaimer: Although the application will run successfully in a Citrix/Terminal Services environment, formal
testing of the application in such an environment has not been undertaken. ARGUS Software can take no legal
responsibility for any problems that arise from this use of the application. If issues arise that pertain to your
Citrix/Terminal Services environment, please refer to that third-party product’s documentation or manufacturer
for guidance.
Developer is not certified to work under Citrix. However, many of our clients have installed and run ARGUS
software using Citrix in two main configurations described in greater detail below.
Creating and maintaining a Citrix network takes a reasonable level of expertise and should only be undertaken if
you have previous experience. Although ARGUS will provide guidance where possible, networks and Citrix
configurations are the responsibility of the client company.
What is Citrix?
Citrix software provides users with a means to manage their data and applications across departments, offices and
worldwide sites. Although this can be achieved using more traditional network configurations, these networks may
be restricted by the speed of the network links, especially where the client computer is communicating with a
server in another office or country.
The principle behind Citrix is that the computer processing is done remotely. The application program is housed on
the Citrix server or an optional, linked server with a fast (normally local) connection with the Citrix server. Since all
the “thinking” is done centrally, the client computer need only send user inputs to the Citrix server and view the
results as they appear. The client computer is not involved in database updates or recalculations, and the speed
and dependability of the link between the client computers and the central servers becomes less critical.
Example: A person is using a client computer and changes some data in an input field. When they click into
another input field, the client computer informs the Citrix server of the change. The Citrix or application servers
then perform various calculations and the resulting picture of the screen is fed back to the client computer. This
picture will show the end result of a calculation.
• Citrix software is normally installed on a server running Microsoft Windows 2000, 2003 + R2 or 2008 + R2
Server.
• The processing is run centrally and the application program may not be able to “see” or use hardware attached
to the client computer such as local hard disks or printers.
• Citrix allows individual applications to be run locally, on the client computer, or remotely as described above.
Standard hints
The hints below relate to both installation types:
• Use mapped drives for the client install; UNC paths will not work.
• Do not bury the application too deeply - try to avoid more than three mapped levels plus the devwin.exe
application name.
• Avoid using long address names when mapping to the application. Spaces appearing in address names could
potentially cause problems, although this is less likely with recent versions of operating systems.
• The client computers or Citrix server (depending on your configuration) must have read and write access to the
installation folder.
1. In the %systemroot%\system32\usrlogn1.cmd file on the Citrix server, add a line to map a drive letter to the
share on the Linked server.
2. On the console of the MetaFrame server, map the same drive letter to the share on the Linked server.
3. Put the Citrix server into “install” mode and install the application to the mapped drive folder, as described in
the above PDF document.
4. Go through the ARGUS Developer licensing procedure.
5. For project file backup purposes, while still in “install” mode, change the default file save locations in Developer
to a mapped drive on a share on a file server. This is done by opening Developer and going to File |
Administration | System Configuration. Click the Data File Locations tab, and change the User Data Folder
location to a drive that is backed up regularly.
6. Put the server into “execute” mode.
7. When publishing the application, manually type the mapped path to the devwin.exe executable in the ARGUS
share.
This means that for successful scalability, you will need a WAN with sufficient bandwidth to handle the demands of
the software.
Developer will run when used with a WAN, but please bear in mind the following:
Disclaimer: Although the application will run successfully in a WAN hosting environment, formal testing of the
application in such an environment has not been undertaken. ARGUS Software can take no legal responsibility
for any problems that arise from this use of the application. If issues arise that pertain to your WAN hosting
environment, please refer to that third-party product’s documentation or manufacturer for guidance.
Click Change/Remove and then click Yes. The software will begin the uninstallation process. You are asked to
confirm the process:
If you wish to proceed, click Yes. You are prompted to specify whether you wish to uninstall the entire application,
or specific components:
Select the appropriate option and click Next > to proceed. A message like the following is displayed:
Uninstallation finished
Note: The uninstall process will not remove any existing ARGUS Developer data files, template files, stamp duty
files or cost code files.
Warning: If you want to uninstall a client, you must ensure that the client machine is disconnected from the
network - this is a precaution to prevent you from accidentally uninstalling the installation on the server.
Activation procedure
When you run the program for the first time (by double-clicking on the ARGUS Developer icon on
the Windows desktop), you are prompted to enter an activation code and serial number. If you do
not have your activation code or serial number, please contact your ARGUS sales representative or
the ARGUS Support line.
Note: If you are setting up ARGUS Developer for use in a client-server configuration over a
network, the license should be activated from one of the client machines.
When you launch the program, the following screen will appear:
Enter your Email Address and the Serial Number into the appropriate fields. Take care to enter
these exactly as supplied by ARGUS Software. The serial number may be called Product Key in
the correspondence you receive.
Select your region of operation from the Location drop down box.
Choose the type of activation you wish to use, by selecting either of the Activate through Internet
or Activate by Phone option buttons.
Activation by Internet
To use this activation method, select the Activate through Internet option button.
If you are not sure whether your PC is connected to the Internet, click the Detect internet
connection status link.
If you are unable to connect to the Internet, you can choose to activate your license by phone. See
“Activation by telephone” on page 26 for further details.
Click the OK button to close down the message. You are returned to the activation dialog.
Click the Next >> button to proceed. A license agreement will be displayed:
Check the I Agree box and click the Next >> button to activate your license. You will receive a
message to confirm that it has been successfully activated:
Click the Finish button to complete the process. You can now proceed to use ARGUS Developer.
Activation by telephone
Alternatively, if you are activating your license by telephone, type in your Company Name, Email
Address and Serial Number then select the Activate by Phone option:
Check the I Agree box and click the Next >> button to proceed.
The following page will provide information that you will need to give to ARGUS Support to
activate your license (you may see a different layout and details here):
To aid you in reading the installation number, you can click the ? button.
Error!
This displays a small dialog which lists the installation number in words - all Unknown document
you need to do is readproperty name.
this out to ARGUS Support.
Click OK to close down this dialog, and click the Next >> button to proceed.
ARGUS Support will supply you with an authorization key, which you must enter into the
Authorisation Key box. This is a long alphanumeric string, so take care when typing it in.
Click the Next >> button to activate your license. You will receive a message to confirm that it has
been successfully activated:
Click the Finish button to complete the process. You can now proceed to use ARGUS Developer.
Checking in a License
Open Licence.exe, then click the Check In... button:
Check-in dialog
Note: Make a note of all the information you see in this dialog - you will need it for reactivating
your license on the computer to which you are moving the ARGUS Developer
license. Do not lose this information.
Select the Check in through Internet option, and click the Next >> button (if you are unable to
connect to the Internet, you can choose to check in your license by phone - call ARGUS Support
for guidance).
If the check-in was successful, you should see the following message:
Successful check-in
Error!
When you are returned to the License Maintenance program, it will now Unknown
show document
the program as property name.
unlicensed:
If you have checked-in a license in order to license a separate installation (such as on a laptop or a
PC at a separate location), you will need to re-activate the license on that other computer.
When you have performed the installation according to the instructions detailed in “Full
installation” on page 9, you will need to activate the software. To activate the software, follow the
procedure as detailed in “Activation procedure” on page 24.
Note: To successfully complete the activation process, you will need the Company Name,
Email Address and Serial Number that you noted down when you checked-in your license.
When you go through the activation procedure, you are prompted to enter this information.
After you have re-activated the license, if you wish to, you can transfer the Data files from your old
installation.
From the old installation, copy the “Data” folder (typically in C:\Documents and
Settings\<user name>\ARGUS Developer to the new installation of ARGUS
Developer.
You may also wish to copy across your files from the “Template” folder to the appropriate folders
on the new installation. Your template folder can typically be found at C:\Program
Files\ARGUS Developer\Regions\<Your Region>\Templates.
You can now proceed to use the fresh installation of ARGUS Developer.
Contact ARGUS Support for the appropriate license changes to be made. Once you have been
advised by ARGUS that the extra modules or users have been added to your license, you can
proceed.
Before you start, ensure that you have a functioning Internet connection. Also, ensure that all users
are logged out. To check that all users are currently logged out, browse to your ARGUS Developer
program folder (typically, this is C:\Program Files\ARGUS Software\ARGUS
Developer) and locate the Licence.exe file.
If the License Maintenance program looks like this (with the “License Error! Unknown
Is Currently document property name.
in Use”
message displayed), click the “License Is Currently in Use” link to display the list of users:
You will need to contact these users and get them to log out of the application. Close down the
License Maintenance program. Once all users have logged out, you can proceed.
Open the license maintenance program again by double-clicking on the Licence.exe file:
Click the Refresh... button to update your license and add the new module(s) and/or users.
Click the Next >> button to proceed. You are prompted with a summary of the changes to the
license:
You should see the license details change on the license maintenance screen:
In our example shown here, you will note that the number in the Max Users field has changed.
You can now use ARGUS Developer with the new module and/or user options you have just
enabled.
Note: If you encounter any problems or errors when performing changes to your license, you
should contact ARGUS Support (See “Contact Details” on page xx).
Resetting a license
In some circumstances, it will be necessary to reset the license. This may happen when the license
files on your computer or server have been damaged. A likely cause of damage is when a license
file is copied or restored from backup.
After selecting the Reset command, the license files will be removed from your computer and
Developer will no longer run. The Support Analyst will update the license details for your account
and you will then be able to check out the license. When the license has been checked out,
Developer can be started as usual.
In addition to your standard license, you can add up to 3 further license options.
Contact ARGUS Support for the appropriate license changes to be made. Once you have been
advised by ARGUS that the extra options have been added to your license, you can proceed.
Before you start, ensure that you have a functioning Internet connection. Also, ensure that all users
are logged out. Browse to your ARGUS Developer program folder (typically, this is C:\Program
Files\ARGUS Software\ARGUS Developer) and locate the Licence.exe file.
Click the Activate... button to activate this option. This allows you to activate the option in the
usual way:
After successful activation, you should see a screen like the following:
If you look at the license maintenance program again, you will note that the new license option has
been successfully activated alongside the standard license:
You will note also that the words “Combi License” are displayed in the bottom right-hand corner.
This screen summarises all the modules that are available with each license option you have
installed. It will also tell you which license options are currently in use.
You can use the Select License Option drop-down to choose which of the license options you
wish to use when you start up Developer.
Note: If you encounter any problems or errors when performing changes to your license, you
should contact ARGUS Support (See “Additional Assistance” on page 5).
Note: You will find a copy of this installation guide in Adobe Acrobat PDF format in the Regions\<your
region>\Documentation folder.