Set up device
To prepare a device for development:
- Find the device on the network to configure the IP address and the user credentials
- Setup the device on the network to make sure it’s ready to be connected to the network
- Check device compatibility to make sure that you use a device that supports ACAP
- Check device properties and update to the latest firmware (AXIS OS) if needed, see How to upgrade
- Check device properties and identify the device architecture to be able to choose the correct toolchain
Find the device on the network
Find the device
To find Axis devices on the network and assign them IP addresses in Windows®, use AXIS IP Utility or AXIS Device Manager. Both applications are free and can be downloaded from axis.com/support.
For more information about how to find and assign IP addresses, go to How to assign an IP address and access your device.
Access the device
- Open a browser and enter the IP address or hostname of the Axis device.
- Enter the username and password. If you access the device for the first time, you must set the root password. See Set a new password for the root account.
- The live view page opens in your browser.
Setup the device on the network
Some extra steps can be followed to make sure the device is ready to be used and connected to the network.
Verify that no one has tampered with the firmware
To make sure that the device has its original firmware (AXIS OS), or to take full control of the device after a security attack:
- Reset to factory default settings. See the product’s user manual for information on how to reset to factory default settings. After the reset, secure boot guarantees the state of the device.
- Configure and install the device.
Set a secure password
Axis devices send the initially set password in clear text over the network. To protect your device after the first login, set up a secure and encrypted HTTPS connection and then change the password.
The device password is the primary protection for your data and services. Axis devices do not impose a password policy as they may be used in various types of installations.
To protect your data we strongly recommend that you:
- Use a password with at least 8 characters, preferably created by a password generator.
- Don’t expose the password.
- Change the password at a recurring interval, at least once a year.
Set a new password for the root account
The default administrator username is root. If the password for root is lost, reset the device to factory default settings. See the product’s user manual for information on how to reset to factory default settings.
- Type a password. Follow the instructions about secure passwords, see Set a secure password.
- Retype the password to confirm the spelling.
- Click Create login. The password has now been configured.
Check device compatibility
To check if device supports ACAP, use VAPIX CGI http://192.168.0.90/axis-cgi/param.cgi
and check if the device supports EmbeddedDevelopment with a VAPIX GET/POST request and action list.
To extract the value of the parameter, use the CGI as device URL in a browser window:
http://192.168.0.90/axis-cgi/param.cgi?action=list&group=Properties.EmbeddedDevelopment.EmbeddedDevelopment
The following response shows a device that supports ACAP:
Properties.EmbeddedDevelopment.EmbeddedDevelopment=yes
Check device properties
To get basic device information, such as AXIS OS version and architecture, use VAPIX POST request and method getAllProperties:
http://192.168.0.90/axis-cgi/basicdeviceinfo.cgi
To extract the messages, use the CGI from a terminal, using the credentials set in the network configuration:
curl \
-u <username>:<password> \
--anyauth \
--data '{"apiVersion":"1.0","context":"Client defined request ID","method":"getAllProperties"}' \
"http://192.168.0.90/axis-cgi/basicdeviceinfo.cgi"
To get a pretty-print of the JSON response from the curl call, the program
jq
can be used by appending the following snippet<curl command> | jq
The following response contains architecture "Architecture": "armv7hf"
, and firmware version "Version": "9.50.1"
:
{
"apiVersion": "1.0",
"context": "Client defined request ID",
"data": {
"propertyList": {
"Architecture": "armv7hf",
"Brand": "AXIS",
"BuildDate": "Nov 07 2019 11:16",
"HardwareID": "764",
"ProdFullName": "AXIS P1448-LE Network Camera",
"ProdNbr": "P1448-LE",
"ProdShortName": "AXIS P1448-LE",
"ProdType": "Network Camera",
"SerialNumber": "ACCC8ED0C9EC",
"Soc": "Axis Artpec-6",
"SocSerialNumber": "00000000-00000000-442C2402-87C00153",
"Version": "9.50.1",
"WebURL": "http://www.axis.com"
}
}
}
How to upgrade
Axis offers product firmware (AXIS OS) management according to the active track or the long-term support (LTS) tracks. Regardless of the track chosen, it is recommended to upgrade AXIS OS regularly in order to get the latest security updates. AXIS OS can be upgraded using AXIS Device Manager, AXIS Camera Station, AXIS Companion, HTTP or FTP.
AXIS Device Manager or AXIS Camera Station
- Go to the Device Manager Tab in Axis Device Manager or Configuration Tab > Devices - Management in AXIS Camera Station.
- Select all devices that should be upgraded.
- Right click and select Upgrade Firmware, which will open a dialog with a list of device models and the current firmware version installed in each device.
- In the Upgrade Firmware dialog there are two options:
- Check for Updates which requires internet access.
- Browse to locate firmware file e.g. on hard drive or memory stick.
- Check for updates:
- Select Check for Updates to download a list of all firmware available for all device models.
- Browse:
- Select browse to locate firmware files and import them. It is possible to select and import several files at the same time.
- Each device model will show a dropdown containing all available firmware for a model. Firmware will be sorted by “Long Term Support” (LTS) and “Active” software tracks in the dropdown.
- Select the firmware to install for each device model.
- Click OK to start upgrading the devices.
By default, firmware upgrade is done for all the selected devices at the same time. The upgrade order can be changed in Configuration > Connected services > Firmware upgrade settings. Once a firmware update has been started, the devices will be unavailable until the installation and restart of the devices has completed successfully.
For more information, see the help in AXIS Device Manager/AXIS Camera Station.
Device web interface
The procedure to update firmware differs slightly depending on the version of the installed web interface (before and after 7.10.1). For AXIS Q1659, the new web interface was introduced in firmware version 6.55.1.
Upgrade instructions when using the old web interface
- Download the upgrade file to a directory that is accessible from your local computer.
- Open the product’s start page (e.g.
http://192.168.0.90
) in a web browser. - Click the Setup link and log in as “root” (or any other user with administrator privileges). You must be logged in as an administrator to upgrade the unit.
- Click System Options in the menu to the left.
- Click Maintenance.
- Click the Browse button in the Upgrade Server section.
- Select the upgrade file you downloaded (and maybe decompressed) from our site. This file is typically named after the product and firmware version.
- Click the Open button.
- Click the Upgrade button in the Upgrade Server section.
- Wait for the flash load to complete, which may take 1-10 minutes. The upgrade procedure occurs in four steps:
- Step 1: Shut down. Running applications are shut down and active connections are terminated.
- Step 2: Uploading firmware. The old firmware will be erased and the new firmware will be saved. During this step, the power LED will blink green/amber. After a while the progress of the upgrade will be displayed in the web browser.
- Step 3: Reboot. The system restarts automatically.
- Step 4: Reconfiguration. The new firmware settings are configured to match the previous settings. The color of the status LED will be amber during this step.
- After the upgrade has completed, the unit will automatically initiate the system, during which the status LED blinks amber. When initiation is complete and the system is ready for use, the status LED will be green.
Upgrade instructions when using the new web interface
- Download the upgrade file to a directory that is accessible from your local computer.
- Open the product’s start page (e.g.
http://192.168.0.90
) in a web browser. - Log in as “root” (or any other user with administrator privileges).
- Click Settings to the right.
- Click System-tab.
- Click Maintenance.
- Select the upgrade file you downloaded (and maybe decompressed) from our site. This file is typically named after the product and firmware version.
- Click the Open button.
- Click the Upgrade button in the Upgrade Server section.
- Wait for the flash load to complete, which may take 1-10 minutes. The upgrade procedure occurs in four steps:
- Step 1: Shut down. Running applications are shut down and active connections are terminated.
- Step 2: Uploading firmware. The old firmware will be erased and the new firmware will be saved. During this step, the power LED will blink green/amber. After a while the progress of the upgrade will be displayed in the web browser.
- Step 3: Reboot. The system restarts automatically.
- Step 4: Reconfiguration. The new firmware settings are configured to match the previous settings. The color of the status LED will be amber during this step. 11 . After the upgrade has completed, the unit will automatically initiate the system, during which the status LED blinks amber. When initiation is complete and the system is ready for use, the status LED will be green.
FTP
- Starting with firmware version 7.30.1 and onwards, the FTP server is disabled by default. In order to use the instructions below it first needs to be enabled via the web interface: Settings > System > PlainConfig > Network > NetworkFTP
- This section is not applicable for AXIS Companion Line cameras.
- You must be at the command prompt and in the directory that contains the upgrade file. Example:
C:\Axis\Product\Firmware
- From the command prompt, open an FTP connection to the unit you wish to upgrade. (Do not use a Windows based FTP program to do this, use command-line FTP programs only.)
- Log in as “root”. You must be logged in as the root user to upgrade the unit.
- Change to binary transfer mode by typing “bin” and press enter.
- Type “hash” and press enter. This will allow you to see how the upgrade progresses.
- Type the command “put XXX.bin flash” where XXX.bin is the name of the upgrade file you downloaded (and maybe decompressed) from our site. This file is typically named after the product and firmware version.
- Wait for the flash load to complete, which may take 1-10 minutes. The upgrade procedure occurs in four steps:
- Step 1: Shut down. Running applications are shut down and active connections are terminated.
- Step 2: Uploading firmware. The old firmware will be erased and the new firmware will be saved. During this step, the power LED will blink green/amber. After a while, the progress of the upgrade will be displayed in the command prompt.
- Step 3: Reboot. The FTP session terminates and the system starts automatically.
- Step 4: Reconfiguration. The new firmware settings are configured to match the previous settings. The color of the status LED will be amber during this step.
- After the upgrade has completed, the unit will automatically initiate the system, during which the status LED blinks amber. When initiation is complete and the system is ready for use, the color of the status LED will be green.