B2C WebDAV Skill

Use the

b2c

WebDAV Roots

The

--root

• impex

  (default) - Import/Export directory

• temp

  - Temporary files

• cartridges

  - Code cartridges

• realmdata

  - Realm data

• catalogs

  - Product catalogs

• libraries

  - Content libraries

• static

  - Static resources

• logs

  - Application logs

• securitylogs

  - Security logs

Examples

List Files

# list files in the default IMPEX root
b2c webdav ls

# list files in a specific path
b2c webdav ls src/instance

# list files in the cartridges root
b2c webdav ls --root=cartridges

# list files with JSON output
b2c webdav ls --root=impex --json

Reading Log Files

Use the

logs

# list all log files
b2c webdav ls --root=logs

# list log files with JSON output for parsing
b2c webdav ls --root=logs --json

# download a specific log file (e.g., customerror log)
b2c webdav get customerror-blade0-1-appserver-20240115.log --root=logs

# download a log file to a specific local path
b2c webdav get error-blade0-1-appserver-20240115.log --root=logs -o ./downloads/error.log

# output log file content to stdout (for piping to grep, etc.)
b2c webdav get customerror-blade0-1-appserver-20240115.log --root=logs -o -

# pipe log content to grep to search for errors
b2c webdav get customerror-blade0-1-appserver-20240115.log --root=logs -o - | grep "OrderNo"

# download security logs
b2c webdav ls --root=securitylogs
b2c webdav get security-blade0-1-20240115.log --root=securitylogs

# list archived logs (compressed after 3 days)
b2c webdav ls log_archive --root=logs

Log File Reference

Log File Naming Pattern

Log files follow this naming pattern:

<type>-<hostname>-appserver-<date>.log

Example:

customerror-blade0-1-appserver-20240115.log

Custom Log File Types

Files generated by script logging (

dw.system.Logger

customdebug

Logger.debug()

log.debug()

custominfo

Logger.info()

log.info()

customwarn

Logger.warn()

log.warn()

customerror

Logger.error()

log.error()

customfatal

log.fatal()

Custom Named Log Files

Created with

Logger.getLogger(prefix, category)

custom-<prefix>-<hostname>-appserver-<date>.log

Example:

custom-orderexport-blade0-1-appserver-20240115.log

# list custom named log files
b2c webdav ls --root=logs | grep "custom-orderexport"

# download a custom named log
b2c webdav get custom-orderexport-blade0-1-appserver-20240115.log --root=logs

System Log File Types

error

warn

info

debug

fatal

api

deprecation

jobs

staging

quota

sql

syslog

sysevent

Log Retention and Archives

/Logs/

/Logs/log_archive/

# list current logs
b2c webdav ls --root=logs

# list archived (gzipped) logs
b2c webdav ls log_archive --root=logs

# download archived log
b2c webdav get log_archive/customerror-blade0-1-appserver-20240112.log.gz --root=logs

Security Logs

Security logs track authentication events:

# list security logs
b2c webdav ls --root=securitylogs

# download security log
b2c webdav get security-blade0-1-20240115.log --root=securitylogs -o - | grep "LOGIN"

Import/Export Logs

Located in IMPEX root under

/log/

# list import/export logs
b2c webdav ls log --root=impex

# download catalog import log
b2c webdav get log/Catalog-Import-20240115.log --root=impex

Common Log Queries

# find recent error logs
b2c webdav ls --root=logs | grep customerror

# search for specific order in error log
b2c webdav get customerror-blade0-1-appserver-20240115.log --root=logs -o - | grep "ORD12345"

# search for payment errors
b2c webdav get customerror-blade0-1-appserver-20240115.log --root=logs -o - | grep -i "payment"

# check job failures
b2c webdav get jobs-blade0-1-appserver-20240115.log --root=logs -o - | grep -i "failed"

# check quota warnings
b2c webdav get quota-blade0-1-appserver-20240115.log --root=logs -o - | grep "exceeded"

# check deprecated API usage
b2c webdav get deprecation-blade0-1-appserver-20240115.log --root=logs

Download Files

# download a file from IMPEX (default root)
b2c webdav get src/instance/export.zip

# download to a specific local path
b2c webdav get src/instance/export.zip -o ./downloads/export.zip

# download from a specific root
b2c webdav get customerror.log --root=logs

# output file content to stdout
b2c webdav get src/instance/data.xml -o -

Upload Files

# upload a file to IMPEX
b2c webdav put ./local-file.zip src/instance/

# upload to a specific root
b2c webdav put ./my-cartridge.zip --root=cartridges

Create Directories

# create a directory in IMPEX
b2c webdav mkdir src/instance/my-folder

# create a directory in a specific root
b2c webdav mkdir my-folder --root=temp

Delete Files

# delete a file
b2c webdav rm src/instance/old-export.zip

# delete from a specific root
b2c webdav rm old-file.txt --root=temp

Delete Cartridges

To delete cartridges from a code version, use the

cartridges

{code-version}/{cartridge-name}

# delete a cartridge from a code version
b2c webdav rm v25_1_0/app_mysite --root=cartridges

# delete multiple cartridges
b2c webdav rm v25_1_0/app_mysite --root=cartridges
b2c webdav rm v25_1_0/int_myintegration --root=cartridges

# list cartridges in a code version first
b2c webdav ls v25_1_0 --root=cartridges

Important: The path is

{code-version}/{cartridge-name}

/cartridges/{code-version}/...

--root=cartridges

-r cartridges

Zip/Unzip Remote Files

# create a zip archive of a remote directory
b2c webdav zip src/instance/my-folder

# extract a remote zip archive
b2c webdav unzip src/instance/archive.zip

More Commands

See

b2c webdav --help

webdav

Related Skills

• b2c-cli:b2c-code

  - Higher-level code deployment (preferred for cartridge upload)

• b2c-cli:b2c-job

  - Import/export site archives