LEARNING AND RESOURCES
AXURE SHARE ENTERPRISE
INSTALLATION TROUBLESHOOTING GUIDES
© 2002-2016 Axure Software Solutions, Inc. All rights reserved. Axure ® is a registered trademark of Axure Software Solutions, Inc.
AXURE SHARE ENTERPRISE INSTALLATION GUIDE
Axure Share Enterprise requires both a web server and a database server. Installation steps must be performed for both servers. The installations can be performed simultaneously or separately (useful when there is a database administrator handling the provisioning and installation of the database and a separate system administrator). By default, installation of the web service will walk you through setting up the database server, but it can also detect if the database server has already been set up. If the machine that you are installing to already has Microsoft IIS installed, the “Default Web Site” web application must exist (and must be created) and will be overwritten. If the web application is being created, please configure it to run with an AppPool that runs under the “NetworkService” account.
Windows Server 2008 R2 or later web server
Microsoft SQL Server (2008 or later, Express Edition or better)
- Should be installed with Mixed Mode authentication (aka "SQL Server and Windows Authentication mode")
MySQL 5.6 or later
Note that it is also possible to install the web server and the database server on the same machine.
SYSTEM RESOURCE RECOMMENDATIONS
The system requirements for the Axure Share database are quite low. We generally recommend:
1 Ghz CPU
1 GB RAM
5 GB Disk Space
The Axure Share web service is more resource-intensive. Generation time for the HTML output is improved by using processors with better single-threaded performance. Axure Share also stores the generated HTML output files on the web server. Accordingly, it has much higher space requirements. We recommend:
2 Ghz CPU
1 GB RAM
30 GB Disk Space
To begin installing Axure Share Enterprise, download and run the installer available from the Download Axure Share Enterprise page.
An optional first step will install required tools if they are not already on the machine. If this step is performed, you'll need to restart the machine to complete their installation. The Axure Share Server Manager will resume where it left off after the restart.
This screen helps to determine which features will get installed. To configure the database server and the web server at once, choose "All features". To initialize the database server from another computer, choose "Custom" here.
All options are selected by default. To install only the Axure Share Server Manager, deselect "Axure Share Enterprise Web Service".
Upon completing these selections, the Axure Share Server Manager will launch. It will help you set up both the web server and the database server if you chose to install them at the same time.
AXURE SHARE SERVER MANAGER
To begin the Axure Share database setup, enter the hostname for the server along with a database user with administrative rights to the server. This is generally "root" for MySQL and "sa" for Microsoft SQL Server. If you're installing with SQL Server Express, it's generally configured with an instance name (defaulted to SQLExpress) which can be specified as shown above, with a "\SQLExpress" appended to the host name.
The user should have the necessary permissions to create tables and functions.
Note that it is required that you install SQL Server with mixed mode authentication ("SQL Server and Windows Authentication mode").
SYSTEM RESOURCE RECOMMENDATIONS
If you are configuring the database for the first time, choose "Create a New Database". Click "Next", and the Axure Share database tables will be created and a progress bar will be displayed.
If you have been provisioned a specific Database (SQL Server) or Schema (MySQL) then you can choose "Use Existing Database". Axure Share Server Manager will detect if any updates need to be made to the database. Clicking "Next" will take you to a screen that will indicate whether the Axure Share Enterprise database has already been initialized. Click "Next" again to continue.
CREATE DATABASE USER FOR AXURE SHARE
This screen provides the option to have the Axure Share Server Manager create a database user with the minimum necessary privileges for the Axure Share Enterprise web service. This is a recommended security best practice. In most cases, you should click "Next" to continue with the setup process. (Clicking "Skip" makes the Axure Share web service connect to the database with the administrative database account used to create the database. This is supported, but not recommended.)
If the Axure Share Server Manager is being run on a computer that does not have the Axure Share Enterprise web service installed, the Manager will display the password for this newly-created database user. The username and password can then be used when configuring the web service.
If instead you plan to manually create a database user for Axure Share, the user will need to be assigned the following privileges:
CREATE SYSTEM ADMIN USER FOR AXURE SHARE
If the system you are running on has the Axure Share web service installed, the next step allows you to enter an email and password for the Axure Share Enterprise system administrator. This is the main administrative account and can create other administrators and users as well as access specific global system settings.
An email and password must be provided during this step. These credentials will be used to log in to the installed Axure Share Enterprise system. It is recommended that you use a valid email address. This should be an administrator's email account e.g. <IT@example.com>.
FILE STORAGE LOCATION
Axure Share stores both *.rp files and the generated prototype files on the filesystem. This is generally located on the web server. The Axure Share generator also uses this folder for intermediate files created during generation. The default location is the %SYSTEMROOT%\ProgramData\AxureShare\data folder.
AXURE SHARE ENTERPRISE SETTINGS
The final screen is used to configure the Axure Share Enterprise system settings.
Once a domain has been associated with the web server, it is recommended that the mapped domain be entered here. This will be used by Axure Share when sending out emails and for navigating the system.
If you set a domain, you can only connect using that domain.
PROTOTYPE DOMAIN NAME
This is an optional domain that requires wildcard domain mapping to host each prototype on its own sub domain.
FORCE HTTPS (SSL) CONNECTIONS
Checking this box will require SSL connections to the Axure Share site. If a user requests an http URL, the user will be redirected to an https URL for that same prototype.
Click "Enable sending of notification emails" if this feature will be allowed. Notification emails can be configured by the user and are sent when a comment is posted on a prototype. We recommend enabling emails.
SENDER EMAIL ADDRESS
This is the sender name and email address that should appear as the sender on the emails sent by the system.
SMTP SERVER, USER, AND PASSWORD
This is the SMTP server along with the associated port (if applicable, to the right of the colon) as well as the username and password for an account on the SMTP server used for sending notification emails.
To learn how to add users, visit the Axure Share Enterprise Accounts and Permissions article.
To configure Axure RP to point to your server, read the Axure Share Enterprise User Guide.
Microsoft SQL Server
For example, if this domain is set to ".share.example.com", prototypes will be hosted at URLs like XXXXXX.share.example.com, where XXXXXX will be replaced by the unique six-digit code for each prototype.
If this field is left empty, prototypes will be hosted on the domain specified above or, if that is left blank, the incoming domain (for example, share.example.com/XXXXXX).
You'll need to set a domain in order to set a prototype domain.
After completing the steps above, click "Next" to finish the setup and browse to the Axure Share web server. Setup is now complete!