AsanDoc: Installation manual
1. Requirements
1.1. Hardware requirements
If you are using Digital ID (Rəqəmsal İD) smartcard, please ensure that SCM Card Reader is installed.
There are no additional specific hardware requirements to modern PC (CPU, memory, hard drive) to run AsanDoc Client software.
1.2. Software requirements
AsanDoc Client software runs on the following Windows, Mac and Linux Systems:
- Windows XP
- Windows Vista
- Windows 7
- Windows 8
- Mac 10.6
- Mac 10.7
- Mac 10.8
- Ubuntu 12.04
- Fedora 18
- openSUSE 12
2. Windows installation
2.1. Download
Download the latest version of AsanDoc Client for Windows from the following location:
http://www.asanimza.az/download/
2.2. Installation
Initiate installation process of windows version of AsanDoc Client by running downloaded Microsoft installer package. Please use superuser permissions to run the installer or contact your administrator.
Click ‘Next’on the welcome dialog to start the installation process:
On the next screen you can change the installation path of AsanDoc Client. By default, a shortcut icon will be created on your computer desktop and an entry will be added to Start Menu. Uncheck the corresponding check boxes in case you do not need these shortcuts.
Click ‘Next’ to proceed with the installation.
Click ‘Install’ button in the next dialog.
After clicking ‘Install’ button window with request for confirmation of your intention to install AsanDoc Client may be displayed. Click ‘Yes’ to continue with the installation.
When the installation process has been completed click ‘Finish’ button to close the setup dialog.
AsanDoc Client software has been successfully installed on your Windows system.
NOTE:
In case you are upgrading AsanDoc Client from version 1.0.0.84 (or anterior) to 1.0.0.194 (or posterior) version please follow the steps below specified.
a. Uninstall the previous version of AsanDoc Client.
b. Follow the instructions mentioned below to remove the certificates installed by previous AsanDoc Client version:
Click “START” button, open “RUN” window, type “certmgr.msc” into command line and click “OK”.
Click “Action” button.
Choose “Find Certificates…” item from dropped down list.
“Action” menu, “Find Certificates…” menu item
Type “asan” keyword into the “Contains” field and then click the “Find Now” button.
Select the certificates and do right click over them. Choose ‘Delete’ action from droped down menu
Certificates deletion (step 1)
Click ‘Yes’ button to confirm deletion of the certificates.
Certificates deletion (step 2)
c. Install new version of AsanDoc Client.
3. Mac installation
3.1. Download
Download the latest version of AsanDoc Client for Mac from the following location:
http://www.asanimza.az/download
3.2. Installation
Initiate installation of AsanDoc Client package by running the Disc Image (.dmg) file downloaded.
Click ‘Continue’on the welcome dialog to start the installation process:
The software license agreement is displayed. Click ‘Continue’ to proceed with the installation.
Click ‘Agree’ button to agree with the license terms in order to continue the installation of AsanDoc Client:
In the next dialog window click ‘Install’ to begin installation of the application to your computer.
After clicking ‘Install’ button window with request for confirmation of your intention to install AsanDoc Client may be displayed. Please indicate your username and password and click ‘Install Software’ to continue with the installation.
When the installation process has been completed click ‘Close’ button to close the setup dialog.
AsanDoc Client software has been successfully installed on your Mac system.
4. Linux installation
4.1. Ubuntu
4.1.1. Configuration
Add the AsanDoc Client package repository path to your Ubuntu package management system sources list or let your system administrator do that.
Open terminal window and execute the following (one-liner) command using regular user whobelongs to the “sudo”group:
sudo echo “deb http://www.asxm.gov.az/repository/asandoc/deb presice main” >> /etc/apt/sources.list
The AsanDoc Client package requires the xml-security-c16 package to be installed. If this package is not in the default Ubuntu repositories, an additional security repository should be configured. This can be done with the following one-liner command:
sudo echo “deb http://security.ubuntu.com/ubuntu precise-security main restricted universe” >> /etc/apt/sources.list
4.1.2. Installation
The AsanDoc Client packages are being signed by the key installed by asandoc-keyring package. Hence, update repositories list and install keyring package. In its turn, the keyring package will install the package key on your computer. Install asandoc client as a second step.
Open terminal window and execute the following commands usingregular user who belongs to the “sudo” group:
sudo apt-get update
(please ignore the error related to untrusted status of AsanDoc repository, this problem will be eliminated after the next command execution)
sudo apt-get install asandoc-keyring
(enter ‘y’ to indicate your your confidence to the package from non-authenticatedsource)
sudo apt-get install asandoc-client
AsanDoc Client has been successfully installed on your Linux system.
4.2. Fedora
4.2.1. Configuration
Add the AsanDoc Client package repository to your Fedora package management repositories list or let your system administrator do that.
Add file /etc/yum.repos.d/asandoc.repo using regular user who belongs to the group “sudo”.
The content of the file should be:
[asandoc]
name=Asandoc Fedora Repository
baseurl=http://www.asxm.gov.az/repository/asandoc/rpm
enabled=1
gpgcheck=0
Save and quit thefile.
4.2.2. Installation
Open terminal window and execute the following commands using regular user who belongs to the “sudo” group:
sudo yum check-update
sudo yum install asandoc-client
AsanDoc Client has been successfully installed on your Fedora system.
4.3. openSUSE
4.3.1. Configuration
The AsanDoc Client package requires the xml-security-c package to be installed. If this package is not in the default openSUSE repositories, an additional repository should be configured.This can be done with the following one-liner command:
sudo zypper ar http://download.opensuse.org/repositories/security:/shibboleth/openSUSE_12.3 security_shibboleth
To install the AsanDoc client package, a repository providing that package must be installed. This can be done with the following command:
sudo zypper ar http://www.asxm.gov.az/repository/asandoc/opensuse
4.3.2. Installation
Open terminal window and execute the following commands using regular user who belongs to the “sudo” group:
sudo zypper refresh
sudo zypper install asandoc-client
AsanDoc Client has been successfully installed on your openSUSE system.